smt_asteroid

本仓库现在只保留一套代码，目标是直接镜像服务器上的实际运行版本，不再维护本地可运行分支。

当前约定

• 仓库内目录默认对应服务器路径：
  • survey/ 对应 /pipeline/xiaoyunao/survey
  • known_asteroid/ 对应 /pipeline/xiaoyunao/known_asteroid
  • heliolincrr/ 对应 /pipeline/xiaoyunao/heliolincrr
• 后续修改以服务器行为为准，不再为了本地便捷运行改写路径假设。
• Python 环境：
  • survey 和 known_asteroid 使用服务器默认 Python
    • 当前为 /home/smtpipeline/Softwares/miniconda3/bin/python
  • heliolincrr 使用 heliolinc 环境
    • 当前为 /home/smtpipeline/Softwares/miniconda3/envs/heliolinc/bin/python

目录结构

• survey/
• known_asteroid/
• heliolincrr/
• resources/known_asteroid/
  • 放补充参考文件，例如 submit.xsd

运行产物路径汇总见 OUTPUTS.md。

服务器运行

survey

cd /pipeline/xiaoyunao/survey
/home/smtpipeline/Softwares/miniconda3/bin/python -m survey.run_daily --date 2026-04-07

或者：

cd /pipeline/xiaoyunao/survey
bash run_daily.sh 2026-04-07

known_asteroid

cd /pipeline/xiaoyunao/known_asteroid
./submit_pipeline_slurm.sh --batch false --submit-mpc false 20260406

heliolincrr

cd /pipeline/xiaoyunao/heliolincrr
PYTHON_BIN=/home/smtpipeline/Softwares/miniconda3/envs/heliolinc/bin/python bash run_single_night.sh 20260406

当前单夜流程已改为：

• mask_gaia -> make_tracklet -> merge_tracklets_night
• run_linear_links_from_tracklets.py 生成 /pipeline/xiaoyunao/data/heliolincrr/<night>/rr_links
• orbit_confirm_links.py 对 rr_links 做后验轨道确认并写入 rr_links/orbit_confirm/
• summarize_single_night.py 统一写出 /pipeline/xiaoyunao/data/heliolincrr/<night>/analysis/*single_night_summary*
• summarize_single_night.py 同时写出 /processed1/<night>/L4/<night>_unknown_links.{fits,json}
• summarize_single_night.py 可通过 --trk-sub-map 给 unknown link 写入 MPC trkSub
• assign_unknown_trksub.py 默认用 /pipeline/xiaoyunao/data/heliolincrr/trksub_history.jsonl 分配全局唯一 7 位 62 进制 trkSub
• export_unknown_ades.py 可将带 trkSub 的 unknown catalog 导出为 ADES PSV，并可用人工复核 CSV 过滤假源
• run_single_night.sh 末尾直接调用 plot_unknown_links.py，基于该 unknown catalog 输出 heliolincrr/plots/<night>/
• run_single_night.sh 可通过 EXPORT_UNKNOWN_ADES=1 打开 unknown ADES 导出；真实提交需额外显式设置 SUBMIT_UNKNOWN_MPC=1
• 默认单夜参数固定为 speed=5 arcsec/h、direction=10 deg、require_shared_endpoint=True
• 当前单夜 orbit_confirm_links.py 默认 max_v_kms=35

当前 15 夜流程入口为 run_pipeline_15.sh，内部依次调用：

• merge_tracklets_15.py
• run_rr_from_tracklets_15.py
• orbit_confirm_links_15.py

依赖与路径

• 代码中的服务器绝对路径保持不变，例如 /processed1、/pipeline/xiaoyunao/...
• known_asteroid 的大依赖文件按服务器布局放在 known_asteroid/ 下：
  • astorb.dat
  • de432s.bsp
• 这两个大文件默认不提交到 git

当前状态

• survey 的关键脚本已与服务器哈希核对一致
• heliolincrr 的关键脚本已与服务器哈希核对一致
• known_asteroid 已按 2026-04-07 服务器现版重建关键入口脚本
• 2026-04-08 起，仓库已移除全部 *_local 目录
• 20260220 单夜正式目录已清理为只保留 rr_links 与正式分析文件
• 20260220 当前单夜正式结果为：582 条 links，1590/2304 个已知检测进入 link，orbit_confirm 得到 569/582 fit_ok 且 569/582 is_good
• 20260220 当前 remask 后 unknown fit_ok catalog 为 29 条、ADES obsData 为 87 行；早期已正式 submit 的版本为 34 条 unknown、102 行 obsData，submission ID 2026-05-14T03:00:19.564_0000Bx4c

版本记录

• 仓库级更新说明见 CHANGELOG.md