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
+12 -6
View File
@@ -3,6 +3,8 @@ package eclipse
import (
"testing"
"time"
"b612.me/astro/internal/ephemtest"
)
func TestLunarEclipseLocalDayBoundsRespectDST(t *testing.T) {
@@ -179,6 +181,7 @@ func TestLunarEclipseInfoKeepsLocation(t *testing.T) {
}
func TestLunarEclipseContactPoints(t *testing.T) {
values := ephemtest.NewValues(t, "lunar_contact_points")
loc := time.FixedZone("UTC+08", 8*3600)
info := ClosestLunarEclipse(time.Date(2026, 3, 3, 12, 0, 0, 0, loc))
if info.Type != LunarEclipseTotal {
@@ -193,20 +196,21 @@ func TestLunarEclipseContactPoints(t *testing.T) {
points[point.Label] = point
}
u1 := points["U1"]
assertFloatClose(t, "U1.ContactPositionAngle", u1.ContactPositionAngle, 96.181711, 1e-3)
assertFloatClose(t, "U1.ContactClockwiseAngle", u1.ContactClockwiseAngle, 263.818289, 1e-3)
assertFloatClose(t, "U1.ContactPositionAngle", u1.ContactPositionAngle, values.Want("U1.ContactPositionAngle", 96.181711, u1.ContactPositionAngle), 1e-3)
assertFloatClose(t, "U1.ContactClockwiseAngle", u1.ContactClockwiseAngle, values.Want("U1.ContactClockwiseAngle", 263.818289, u1.ContactClockwiseAngle), 1e-3)
u2 := points["U2"]
assertFloatClose(t, "U2.ContactPositionAngle", u2.ContactPositionAngle, 243.025171, 1e-3)
assertFloatClose(t, "U2.MoonCenterPositionAngle", u2.MoonCenterPositionAngle, 243.025171, 1e-3)
assertFloatClose(t, "U2.ContactPositionAngle", u2.ContactPositionAngle, values.Want("U2.ContactPositionAngle", 243.025171, u2.ContactPositionAngle), 1e-3)
assertFloatClose(t, "U2.MoonCenterPositionAngle", u2.MoonCenterPositionAngle, values.Want("U2.MoonCenterPositionAngle", 243.025171, u2.MoonCenterPositionAngle), 1e-3)
}
func TestLunarEclipseChauvenetRemainsAvailable(t *testing.T) {
values := ephemtest.NewValues(t, "lunar_chauvenet_available")
date := time.Date(2025, 3, 14, 12, 0, 0, 0, time.UTC)
defaultInfo := ClosestLunarEclipse(date)
chauvenetInfo := ClosestLunarEclipseChauvenet(date)
assertFloatClose(t, "Chauvenet.PenumbralMagnitude", chauvenetInfo.PenumbralMagnitude, 2.285436461, 1e-6)
assertFloatClose(t, "Chauvenet.UmbralMagnitude", chauvenetInfo.UmbralMagnitude, 1.182806541, 1e-6)
assertFloatClose(t, "Chauvenet.PenumbralMagnitude", chauvenetInfo.PenumbralMagnitude, values.Want("Chauvenet.PenumbralMagnitude", 2.285436461, chauvenetInfo.PenumbralMagnitude), 1e-6)
assertFloatClose(t, "Chauvenet.UmbralMagnitude", chauvenetInfo.UmbralMagnitude, values.Want("Chauvenet.UmbralMagnitude", 1.182806541, chauvenetInfo.UmbralMagnitude), 1e-6)
if !(chauvenetInfo.PenumbralMagnitude > defaultInfo.PenumbralMagnitude) {
t.Fatalf("expected Chauvenet penumbral magnitude > Danjon: chauvenet=%.6f danjon=%.6f", chauvenetInfo.PenumbralMagnitude, defaultInfo.PenumbralMagnitude)
@@ -217,6 +221,8 @@ func TestLunarEclipseChauvenetRemainsAvailable(t *testing.T) {
}
func TestLunarEclipseDefaultFallsBackForUltraShallowPenumbralEdge(t *testing.T) {
// 夹具按旧模型几何选取,用来覆盖该边界分支。
ephemtest.PinLegacy(t)
date := time.Date(-780, 12, 13, 12, 0, 0, 0, time.UTC)
defaultInfo := ClosestLunarEclipse(date)