编辑配置 → 运行 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 异构样例 |
|---|---|
| 观察组合:已有 CSAC 仿真钟的稳定度改善 | 观察互补:不同类型钟在短期与较长期各有所长 |
查看两个样例的相位图、ADEV 图、数值对照和运行命令。可以先看结果,再按下面步骤自己运行并绘图。
使用提供的 BHU GPS 钟差产品,2026-06-02 至 06-23,30 秒采样;G13 缺失,其余 31 颗 GPS 参与融合。采用三状态钟模型,逐星用全部可用数据的哈达玛方差拟合扩散系数,开启正确的相对钟差初始化,不使用贝叶斯优化。BROWN 对漂移状态的特殊处理见案例说明。
比较对象包括 31 个原始卫星钟、原始钟差的等权平均,以及 GREENHALL、KPW、SUMZERO、BROWN 四组原生 C++ 结果;只展示正确初始化后的结果。指标包括 ADEV、普通 HDEV 和重叠 HDEV(OHDEV)。
主要结果: GREENHALL 与 KPW 在 6 小时 OHDEV 上比等权平均低约 24.5%;12 小时时等权平均更低。结论随指标和平均时间变化,完整数值表、ADEV/HDEV 图及统计边界见GPS 实验教程。本实验评价使用共同有效历元、按连续段计算,差分不跨数据缺口;拟合与评价同源。
- 查看和核对结果: 公开数据包约 14.3 MB,无需求解器即可重算 1,008 个目标统计值。
- 重新运行实验: 使用支持相对钟差初始化的 0.2.0 授权运行包及配套清单;旧 0.1.0 不支持此功能。安装、配置和运行步骤。
- 检查验证范围: 完整 GPS 实验与 0.2.0 运行包验证记录。22 天归档结果与打包后的 1 小时 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,也要同步这一行。
下载仓库并解压,在包含 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。
没有自己的 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,再编辑其中的路径。具体方法见配置目录说明。
本次要编辑的是 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 秒设置。
在仓库根目录执行:
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 可能覆盖同名输出;比较不同设置时使用新的结果目录,保留之前的配置副本。
文件逐列说明和小例子见结果文件与图片。
回到仓库根目录:
.\.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.pngADEV 横轴是平均时间 τ,纵轴越低通常表示该 τ 上的稳定度越好。先比较彩色组合曲线与四只原始钟,再观察短期和较长期表现,详见读图说明。
先按默认参数完成上述流程。在实验的 config/ 目录中,将 Timescale.cfg 复制为 Timescale_noise.cfg,将 session.obj 复制为 session_noise.obj。然后编辑三个文件:
- 在
file_table中,把TimescaleCfg改为config/Timescale_noise.cfg,把object改为config/session_noise.obj。 - 在
Timescale_noise.cfg中,把Project directory改为results/noise_test。 - 在
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,维护方式见维护者指南。