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

- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算，支持极区与混合食拓扑 - 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口 - 重构恒星与行星月掩路径，补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界 - 扩展 SVG 与 GeoJSON 输出，支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名 - 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推，补充系列锚点和成员一致性校验 - 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口 - 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存，降低重复计算开销并提升边界稳定
2026-09-17 12:27:40 +08:00
parent 9ee2163cc7
commit 2bf8478639
428 changed files with 85981 additions and 7998 deletions
@@ -0,0 +1,79 @@
+package geojson_test
+
+import (
+	"testing"
+	"time"
+
+	"b612.me/astro/basic"
+	"b612.me/astro/geojson"
+	"b612.me/astro/internal/geodata"
+	"b612.me/astro/moon"
+)
+
+func TestOccultationDistantEnvelopesRemainComplete(t *testing.T) {
+	if err := basic.LoadStarData(); err != nil {
+		t.Fatal(err)
+	}
+	for _, test := range []struct {
+		name             string
+		year, month, day int
+		planet           moon.OccultationPlanet
+		hr               int
+	}{
+		{"mercury", 26, 4, 4, moon.OccultationMercury, 0},
+		{"aldebaran", 26, 7, 26, "", 1457},
+		{"regulus", 4026, 12, 14, "", 3982},
+		{"saturn", 4026, 12, 29, moon.OccultationSaturn, 0},
+		{"mars-fold", 1426, 7, 1, moon.OccultationMars, 0},
+		{"venus-tangent", 1227, 5, 19, moon.OccultationVenus, 0},
+		{"jupiter-horizon", 1226, 12, 23, moon.OccultationJupiter, 0},
+		{"jupiter-time", 3627, 9, 20, moon.OccultationJupiter, 0},
+	} {
+		for _, algorithm := range []moon.OccultationPathAlgorithm{moon.OccultationPathAlgorithmExact, moon.OccultationPathAlgorithmOptimized} {
+			t.Run(test.name+"/"+string(algorithm), func(t *testing.T) {
+				day := time.Date(test.year, time.Month(test.month), test.day, 0, 0, 0, 0, time.UTC)
+				options := moon.OccultationPathOptions{Algorithm: algorithm, Step: 20 * time.Minute, TargetSpacingKM: 900, DisableFootprints: true, RiseSetStep: time.Minute}
+				var data []byte
+				var err error
+				role := "partial-band"
+				if test.hr == 0 {
+					paths, findErr := moon.FindPlanetOccultationPaths(day.Add(-12*time.Hour), day.Add(36*time.Hour), test.planet, options)
+					if findErr != nil || len(paths) != 1 {
+						t.Fatalf("paths=%d err=%v", len(paths), findErr)
+					}
+					data, err = geojson.MarshalPlanetOccultation(paths[0])
+				} else {
+					catalog, catalogErr := basic.StarDataByHR(test.hr)
+					if catalogErr != nil {
+						t.Fatal(catalogErr)
+					}
+					star, starErr := moon.StarCoordinateFromStarData(catalog)
+					if starErr != nil {
+						t.Fatal(starErr)
+					}
+					paths, findErr := moon.FindStarOccultationPaths(day.Add(-12*time.Hour), day.Add(36*time.Hour), star, options)
+					if findErr != nil || len(paths) != 1 {
+						t.Fatalf("paths=%d err=%v", len(paths), findErr)
+					}
+					data, err = geojson.MarshalStarOccultation(paths[0])
+					role = "occultation-band"
+				}
+				if err != nil {
+					t.Fatal(err)
+				}
+				collection := decodeCollection(t, data)
+				assertCollectionCoordinates(t, collection)
+				band := featureWithRole(t, collection, role)
+				assertClosedMultiPolygon(t, band)
+				if test.hr == 0 {
+					assertOccultationP2PhaseCurvesInsidePartialBand(t, collection, 2)
+					partial := geoJSONMultiPolygonOuterRings(t, band)
+					total := geoJSONMultiPolygonOuterRings(t, featureWithRole(t, collection, "total-band"))
+					if miss := geodata.SphericalPolygonsPathMissDistanceKM(partial, total, true); miss > 2 {
+						t.Fatalf("total extends %.3f km beyond partial", miss)
+					}
+				}
+			})
+		}
+	}
+}