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
+11 -4
View File
@@ -4,6 +4,8 @@ import (
"math"
"testing"
"time"
"b612.me/astro/internal/ephemtest"
)
// 掩带两条横向口径的契约:WidthKM 是中心线采样处的地面横向宽度,南北限是外接触锥的擦边切点轨迹,
@@ -240,6 +242,7 @@ func TestPlanetOccultationWidthKMIsGroundCrossTrackWidth(t *testing.T) {
}
func TestPlanetOccultationLimitSeparationMatchesExportedLimits(t *testing.T) {
values := ephemtest.NewValues(t, "occultation_limit_anchors")
for _, fixture := range occultationLimitFixtures() {
path := occultationLimitPath(t, fixture)
nearestIndex, nearestDelta := 0, math.Inf(1)
@@ -279,15 +282,17 @@ func TestPlanetOccultationLimitSeparationMatchesExportedLimits(t *testing.T) {
{name: "greatest limit separation", got: path.GreatestLimitSeparationKM, want: fixture.limitSeparationKM},
{name: "greatest total width", got: path.GreatestTotalWidthKM, want: fixture.totalWidthKM},
} {
if difference := math.Abs(anchor.got - anchor.want); difference > occultationLimitAnchorToleranceKM {
want := values.Want(fixture.name+"/"+anchor.name, anchor.want, anchor.got)
if difference := math.Abs(anchor.got - want); difference > occultationLimitAnchorToleranceKM {
t.Fatalf("%s: %s=%.6f km, want %.6f km within %.3f km",
fixture.name, anchor.name, anchor.got, anchor.want, occultationLimitAnchorToleranceKM)
fixture.name, anchor.name, anchor.got, want, occultationLimitAnchorToleranceKM)
}
}
ratio := path.GreatestLimitSeparationKM / path.Greatest.WidthKM
if math.Abs(ratio-fixture.limitRatio) > occultationLimitRatioTolerance {
wantRatio := values.Want(fixture.name+"/limit ratio", fixture.limitRatio, ratio)
if math.Abs(ratio-wantRatio) > occultationLimitRatioTolerance {
t.Fatalf("%s: limit separation/width=%.6f, want %.6f within %.4f",
fixture.name, ratio, fixture.limitRatio, occultationLimitRatioTolerance)
fixture.name, ratio, wantRatio, occultationLimitRatioTolerance)
}
if path.GreatestTotalWidthKM >= path.Greatest.WidthKM {
t.Fatalf("%s: total width=%.6f must stay below the outer width=%.6f",
@@ -342,6 +347,8 @@ func TestStarOccultationLimitSeparationMatchesExportedLimits(t *testing.T) {
// 于是 Saturn 2024-08-21 的 CenterLine[160] 少 47.9 km(3810.7491 对 3858.7641)、
// Venus 1227-05-19 的 CenterLine[15] 少 158.6 km(6047.4858 对 6206.0535)。
func TestPlanetOccultationGrazingEndpointWidthAnchors(t *testing.T) {
// 夹具按旧模型几何选取,用来覆盖该边界分支。
ephemtest.PinLegacy(t)
testCases := []struct {
name string
planet OccultationPlanet