feat: 引入可切换星历模型并扩展天象观测链路

- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算
- 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询
- 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出
- 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解
- 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤
- 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持
- 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理
- 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
This commit is contained in:
2026-10-15 23:54:15 +08:00
parent 16c62a97d5
commit 044f2f4381
674 changed files with 62983 additions and 8396 deletions
+16 -2
View File
@@ -5,6 +5,7 @@ import (
"sync"
"b612.me/astro/basic"
"b612.me/astro/internal/ephem"
)
const (
@@ -29,6 +30,11 @@ const (
)
// SarosInfo 沙罗序列信息, Saros series metadata.
//
// Series 与星历模型无关;Member 与 Count 在序列首尾可能随模型变化:食分接近 0 的
// 擦边食是否成立取决于模型,差异量级小于模型自身误差,不同模型因而可能多算或少算
// 一个首尾成员。Series is model-independent; Member and Count can differ by one at
// a series head or tail, where a grazing eclipse falls within model error.
type SarosInfo struct {
// Series 是权威目录系列编号;Verified=false 时为根据周期外推得到的暂定编号。
// Series is the authoritative catalog series number, or a provisional number when Verified is false.
@@ -154,11 +160,19 @@ var lunarSarosHeadOverrides = [...]sarosHeadOverride{
{Series: 61, Count: 78, HeadYear: -762, HeadMonth: 12, HeadDay: 24, MemberOffset: 1},
}
func solarSarosInfo(ttJDE float64) (SarosInfo, bool) {
func solarSarosInfo(ttJDE float64, modules ...*Eclipse) (SarosInfo, bool) {
module := &defaultModule
if len(modules) > 0 {
module = modules[0]
}
if module.model() == ephem.Custom {
return SarosInfo{}, false
}
if info, ok := matchSarosMagic(solarSarosAnchors[:], 0, solarSarosHeadOverrides[:], ttJDE); ok {
return info, true
}
return reconciledSarosInfo(extendedSarosInfo, ttJDE, 0)
return reconciledSarosInfo(module.extendedSarosInfo, ttJDE, 0)
}
func lunarSarosInfo(ttJDE float64) (SarosInfo, bool) {