Skip to content

About

GSTAR 时间尺度实验与分析工具:配置驱动运行、标准数据输入、合成案例与 ADEV 分析。核心运行包通过授权渠道单独提供。

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

GstarTimescale Lab · 时间尺度实验与分析

编辑配置 → 运行 GstarTimescale.exe → 查看结果文件 → 单独运行绘图脚本。

本仓库公开实验配置、输入准备和绘图代码。核心求解器以独立 Windows 程序提供;使用者可以直接修改配置、调用程序和分析输出,无需阅读或编译核心 C++ 源码。

建议从 4 只已有仿真 CSAC、10 天、10 秒采样 的 PFD 案例开始。它只使用时钟比对数据,不需要轨道或 STK。

论文实验入口:第 4.3 节:秩亏补偿 · 第 4.4 节:贝叶斯优化 · 第 5.2 节:成员钟退出与加入。均提供公开数据、可编辑配置、绘图脚本和结果预览;第 4.4 节实际搜索噪声参数,第 5.2 节修改成员日程、比较固定协方差与短窗初始化。

真实数据入口:31 颗 GPS、22 天:正确初始化后的秩亏补偿对照。提供原始钟差、四组原生结果及 ADEV/HDEV/OHDEV;不使用贝叶斯优化。查看和核对结果无需求解器,重新运行需支持相对钟差初始化的新授权程序。

先看看运行后能得到什么

下面是两个 10 天、10 秒采样 样例的实际 ADEV。每张图都包含四只原始钟和蓝色的组合时间尺度,纵轴越低通常表示相应平均时间上的稳定度越好。

4 CSAC 同构样例 2 CSAC + 2 mRO 异构样例
4 CSAC 样例五条 ADEV 曲线 异构样例五条 ADEV 曲线
观察组合:已有 CSAC 仿真钟的稳定度改善 观察互补:不同类型钟在短期与较长期各有所长

查看两个样例的相位图、ADEV 图、数值对照和运行命令。可以先看结果,再按下面步骤自己运行并绘图。

真实 GPS 卫星钟融合实验:31 颗星、22 天

使用提供的 BHU GPS 钟差产品,2026-06-02 至 06-23,30 秒采样;G13 缺失,其余 31 颗 GPS 参与融合。采用三状态钟模型,逐星用全部可用数据的哈达玛方差拟合扩散系数,开启正确的相对钟差初始化,不使用贝叶斯优化。BROWN 对漂移状态的特殊处理见案例说明。

比较对象包括 31 个原始卫星钟、原始钟差的等权平均,以及 GREENHALL、KPW、SUMZERO、BROWN 四组原生 C++ 结果;只展示正确初始化后的结果。指标包括 ADEV、普通 HDEV 和重叠 HDEV(OHDEV)。

31 颗 GPS 原始钟、等权平均与四种组合方法的重叠 HDEV

主要结果: GREENHALL 与 KPW 在 6 小时 OHDEV 上比等权平均低约 24.5%;12 小时时等权平均更低。结论随指标和平均时间变化,完整数值表、ADEV/HDEV 图及统计边界见GPS 实验教程。本实验评价使用共同有效历元、按连续段计算,差分不跨数据缺口;拟合与评价同源。

先认识这几个文件

文件 你用它做什么
config/file_table 告诉程序去哪里读取运行配置、对象配置和基础表
config/Timescale.cfg 设置算法模式、开始时间、运行时长、采样间隔、输入与输出路径
config/session.obj 设置参与的钟、观测类型、初始不确定度及噪声参数
engine/GstarTimescale.exe 读取上述配置并解算,需单独获取授权运行包
tools/plot_results.py 读取解算结果,绘制相位和 ADEV 图;脚本顶部可直接修改路径和参数

仓库实际使用小写文件名 session.obj。名字由 file_table 中的 object 一行指定;如果改名为 Session.obj,也要同步这一行。

1. 准备环境和程序,只需做一次

下载仓库并解压,在包含 lab.py 的文件夹中打开 PowerShell。使用 Windows x64、Python 3.11 或 3.12:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-demo.txt

从维护者提供的渠道取得运行包,使用下面的安装命令解压并校验到 engine/:

.\.venv\Scripts\python.exe lab.py install-engine "GstarTimescale-engine-0.1.0-windows-x64.zip"

之后求解时直接调用 engine/GstarTimescale.exe。安装步骤不会运行实验。

上面的 0.1.0 命令用于基础仿真案例;GPS 初始化实验请按 0.2.0 安装步骤操作,需要同时替换随包提供的 engine-release.json。

2. 准备一个有数据的实验目录

没有自己的 CLK/PFD 数据时,先下载约 14 MB 的四只 CSAC 仿真输入和配置:

.\.venv\Scripts\python.exe tools/prepare_csac.py --output Runs/manual_case

这条命令只准备数据和初始配置。执行完成后停下来,打开配置文件看一看,再运行程序。 后面每次改算法参数时,可以复用这份输入,不必重新生成。

Runs/manual_case/
  config/
    file_table       配置与基础表索引
    Timescale.cfg    时间、模式、输入输出路径
    session.obj      四只钟及其噪声假设
    svinf.dat        对象编号与输出名称映射
    leap.sec         闰秒表
    pan_info         本 PFD 案例的辅助表占位
  clk/               标准钟差输入
  pfd/               两两时钟比对输入
  results/           程序将在这里写结果

已有标准数据时,也可以自己创建实验目录,把本仓库 config/ 整个复制进去,放好 CLK/PFD,再编辑其中的路径。具体方法见配置目录说明。

3. 直接编辑三个配置文件

本次要编辑的是 Runs/manual_case/config/ 中的文件。

file_table 中最主要的两行是:

 TimescaleCfg config/Timescale.cfg
 object config/session.obj

Timescale.cfg 中先认识这些设置:

 Start time&session length   = 2026 01 01 00 00 00 864000 [GPST]
 Processing interval         = 10
 Project directory           = results
 LEO Clk full name           = clk/SIM0MGNFIN_-YEARDOY-0000_01D_10S_CLK.CLK
 PFD data directory          = pfd
 Timescale scope             = satellite
* 可选 NONE / SUMZERO / BROWN / GREENHALL / KPW,只改下一行的值
 Rank deficiency remedy      = GREENHALL
 Estimation architecture     = centralized

上面是从完整文件中摘出的关键字段;在原位置修改,保留原有段落标记。864000 秒等于 10 天,结束时刻是开始时刻加运行时长。-YEARDOY- 会替换为年份和年积日,例如 2026001。

秩亏补偿方法可以直接切换。 在当前实验的 Timescale.cfg 中修改 Rank deficiency remedy:

配置值 含义
NONE 不做补偿,用作对照
SUMZERO 显式约束,论文中的 Centroid
BROWN Brown 方法
GREENHALL Greenhall 方法,样例默认值
KPW KPW 方法

例如改为 BROWN,同时将 Project directory 改为 results/brown,再运行同一个 exe。新结果绘图时用 --results Runs/manual_case/results/brown --output Runs/manual_case/brown。切换方法不需要重新生成钟数据,也不需要重新编译程序。完整步骤见方法切换与结果目录。

准备新 CSAC 实验时,也可直接指定方法:python tools/prepare_csac.py --method BROWN --output Runs/csac_brown。

session.obj 每个对象行最后的参数可以调整,例如:

Phase:[初始相位标准差,相位扩散系数]
Frequency:[初始频率标准差,频率扩散系数]
Link_Noise:{Default:观测噪声标准差}

这些参数是求解器对钟和观测的假设,修改它们不会改写已有输入数据。完整说明见配置指南。

相对路径以程序启动时所在的实验目录为基准。 因此,下面先进入 Runs/manual_case 再运行。修改时间时要保证输入覆盖该时段;初次使用保留示例的 10 天、10 秒设置。

4. 直接运行程序

在仓库根目录执行:

Push-Location Runs/manual_case
& ..\..\engine\GstarTimescale.exe config/file_table
Pop-Location

这就是实际的求解命令:程序路径 + file_table 路径。程序按你刚刚编辑的文件运行。

运行结束后,打开 Runs/manual_case/results/:

结果文件 含义
IEM.txt 组合时间尺度;每行 IEM 标记后面的数字是相位,单位秒
SIM1.txt~SIM4.txt 四只钟的原始值和估计值;第 5 列为原始钟相位,单位秒
gstar.log 程序运行日志;出现错误或结果不完整时从这里查起

结果目录由 Project directory 决定。例如改为 results/greenhall_test,结果就在这个新目录。直接运行 exe 可能覆盖同名输出;比较不同设置时使用新的结果目录,保留之前的配置副本。

文件逐列说明和小例子见结果文件与图片。

5. 单独运行绘图脚本

回到仓库根目录:

.\.venv\Scripts\python.exe tools/plot_results.py

它默认读取 Runs/manual_case/results/。也可以直接编辑脚本顶部的 RESULTS_DIR、CLOCK_IDS、SAMPLE_INTERVAL_S,然后再运行。或者在命令中指定:

.\.venv\Scripts\python.exe tools/plot_results.py --results Runs/manual_case/results --output Runs/manual_case --interval 10

这一步只读结果、计算 ADEV 和画图。可以反复修改标题、图例、坐标范围或颜色再重画,无需重新解算。

绘图输出 用途
figures/phase.png 四只原始钟与组合时间尺度的相位变化图
figures/adev.png 四只原始钟 + Ensemble,共五条 ADEV 曲线
同名 .pdf、.svg 用于报告、打印或进一步排版的矢量图
analysis/phase.csv 实际日期、公共时间轴和五路相位原值
analysis/adev.tsv ADEV 曲线的数值
analysis/stability_summary.tsv 指定平均时间 τ 上直接计算的 ADEV、误差估计与有效项数
Start-Process .\Runs\manual_case\figures\phase.png
Start-Process .\Runs\manual_case\figures\adev.png

ADEV 横轴是平均时间 τ,纵轴越低通常表示该 τ 上的稳定度越好。先比较彩色组合曲线与四只原始钟,再观察短期和较长期表现,详见读图说明。

第一个修改练习

先按默认参数完成上述流程。在实验的 config/ 目录中,将 Timescale.cfg 复制为 Timescale_noise.cfg,将 session.obj 复制为 session_noise.obj。然后编辑三个文件:

  1. 在 file_table 中,把 TimescaleCfg 改为 config/Timescale_noise.cfg,把 object 改为 config/session_noise.obj。
  2. 在 Timescale_noise.cfg 中,把 Project directory 改为 results/noise_test。
  3. 在 session_noise.obj 中,将第一只钟的 Link_Noise.Default 从约 1e-12 改为 2e-12。

再次执行第 4 步的同一个 exe 命令,再画新结果:

.\.venv\Scripts\python.exe tools/plot_results.py --results Runs/manual_case/results/noise_test --output Runs/manual_case/noise_test

观察相位和 ADEV 有无变化。变化可能很小,这也是实验结果。旧配置和旧结果仍保留;把 file_table 两行改回即可切回原来的设置。这个练习让三个配置文件都参与实际操作。

继续使用

需要什么 入口
先看初始两个样例的完整结果 样例结果与读图练习
配置字段、起止时间、模式和路径 配置指南
结果逐列解释、相位与 ADEV 结果文件与图片
概念与实验目录说明 用户指南
第 4.3 节论文数据与实验 论文实验教程
第 4.4 节扩散系数实验 默认运行、贝叶斯优化与结果比较
第 5.2 节动态成员实验 成员钟退出、新钟加入与初始化对比
真实 GPS 卫星钟融合实验 31 星、22 天:初始化、四种补偿方法及 ADEV/HDEV/OHDEV
4 CSAC 的数据来源和完整命令 CSAC 基础案例
2 CSAC + 2 mRO 的输入参数 异构案例
一键演示、自动检查和 HTML 报告 可选便利命令
常见错误 故障排查

核心程序单独分发;公开仓库和 Releases 提供教程、配置、绘图脚本及经整理的实验数据。engine/ 和 Runs/ 默认不进入 Git。使用范围见 LICENSE.md,维护方式见维护者指南。

About

GSTAR 时间尺度实验与分析工具:配置驱动运行、标准数据输入、合成案例与 ADEV 分析。核心运行包通过授权渠道单独提供。

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages