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
+61
View File
@@ -0,0 +1,61 @@
// 被测契约:章动、平黄赤交角、岁差与完整旋转矩阵和独立参考实现逐点一致。
package iau2006
import (
"math"
"testing"
)
type referenceCase struct {
jd float64
dpsi, deps float64
obliquity float64
precession Matrix
fullRotation Matrix
}
func maxDiff(a, b Matrix) float64 {
worst := 0.0
for i := range a {
for j := range a[i] {
worst = math.Max(worst, math.Abs(a[i][j]-b[i][j]))
}
}
return worst
}
func TestMatchesReference(t *testing.T) {
if d := maxDiff(FrameBias(), referenceBias); d > 1e-15 {
t.Errorf("frame bias differs by %.3g", d)
}
for _, c := range referenceCases {
dpsi, deps := Nutation(c.jd)
if math.Abs(dpsi-c.dpsi) > 1e-9 || math.Abs(deps-c.deps) > 1e-9 {
t.Errorf("jd %.1f nutation %.12f %.12f want %.12f %.12f", c.jd, dpsi, deps, c.dpsi, c.deps)
}
if d := math.Abs(MeanObliquity(c.jd) - c.obliquity); d > 1e-9 {
t.Errorf("jd %.1f obliquity differs by %.3g arcsec", c.jd, d)
}
if d := maxDiff(Precession(c.jd), c.precession); d > 1e-14 {
t.Errorf("jd %.1f precession differs by %.3g", c.jd, d)
}
// 1e-12 rad ≈ 0.2 µas
if d := maxDiff(BiasPrecessionNutation(c.jd), c.fullRotation); d > 1e-12 {
t.Errorf("jd %.1f full rotation differs by %.3g", c.jd, d)
}
}
}
func TestMatrixIsRotation(t *testing.T) {
m := BiasPrecessionNutation(2460676.5)
v := m.Transpose().Apply(m.Apply([3]float64{0.3, -0.5, 0.8}))
if math.Abs(v[0]-0.3)+math.Abs(v[1]+0.5)+math.Abs(v[2]-0.8) > 1e-14 {
t.Errorf("round trip %v", v)
}
}
func BenchmarkNutation(b *testing.B) {
for i := 0; i < b.N; i++ {
Nutation(2460676.5 + float64(i%100))
}
}