feat: 完善日月食与月掩几何链路并扩展历法接口

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算,支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径,补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出,支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推,补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存,降低重复计算开销并提升边界稳定
This commit is contained in:
2026-09-17 12:27:40 +08:00
parent 9ee2163cc7
commit 2bf8478639
428 changed files with 85981 additions and 7998 deletions
+43
View File
@@ -196,3 +196,46 @@ func TestFindStarOccultationsValidatesInputs(t *testing.T) {
t.Fatalf("FindStarOccultations() observer error = %v, want ErrInvalidOccultationInput", err)
}
}
func TestFindBestStarOccultationsKeepsNonCentralEvents(t *testing.T) {
// HR 1118 的黄纬为 +5.58°,接近月掩纬度极限,因此 2025-02-06 与 2025-05-26 的月掩
// 都是月影轴不与地球椭球相交的非中心事件;最佳站心曾取外接触切点而整场丢失。
// HR 1118 sits at ecliptic latitude +5.58°, close to the occultation latitude limit,
// so its 2025-02-06 and 2025-05-26 events are non-central: the shadow axis misses the
// ellipsoid and the best station used to be taken at the outer contact tangent, which
// dropped the whole event from the search.
star := StarCoordinate{
ID: "HR 1118",
RA: 55.19291667,
Dec: 25.32944444,
Epoch: time.Date(2000, time.January, 1, 12, 0, 0, 0, time.UTC),
Frame: CoordinateFrameJ2000,
ProperMotionRACosDecMasPerYear: 8,
ProperMotionDecMasPerYear: -15,
}
for _, day := range []time.Time{
time.Date(2025, time.February, 6, 0, 0, 0, 0, time.UTC),
time.Date(2025, time.May, 26, 0, 0, 0, 0, time.UTC),
} {
t.Run(day.Format("2006-01-02"), func(t *testing.T) {
start := day.Add(-24 * time.Hour)
end := day.Add(24 * time.Hour)
events, err := FindBestStarOccultations(start, end, star, OccultationSearchOptions{})
if err != nil {
t.Fatalf("FindBestStarOccultations() error = %v", err)
}
paths, err := FindStarOccultationPaths(start, end, star, OccultationPathOptions{})
if err != nil {
t.Fatalf("FindStarOccultationPaths() error = %v", err)
}
if len(events) != 1 || len(paths) != 1 {
t.Fatalf("event search returned %d events, path search %d, want one each", len(events), len(paths))
}
event := events[0]
if event.MinimumSeparationArcsec > event.MoonSemidiameterArcsec {
t.Fatalf("greatest station lies outside the occultation: separation=%.3f moon=%.3f",
event.MinimumSeparationArcsec, event.MoonSemidiameterArcsec)
}
})
}
}