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,77 @@
+package geojson_test
+
+import (
+	"testing"
+	"time"
+
+	"b612.me/astro/basic"
+	"b612.me/astro/eclipse"
+	"b612.me/astro/geojson"
+	"b612.me/astro/moon"
+)
+
+func BenchmarkStaticMap(b *testing.B) {
+	if err := basic.LoadStarData(); err != nil {
+		b.Fatal(err)
+	}
+	for _, test := range []struct {
+		name             string
+		year, month, day int
+		planet           moon.OccultationPlanet
+		hr               int
+	}{
+		{"saturn", 2025, 1, 5, moon.OccultationSaturn, 0},
+		{"mars", 2025, 1, 14, moon.OccultationMars, 0},
+		{"venus", 2025, 9, 19, moon.OccultationVenus, 0},
+		{"star", 2025, 6, 5, "", 4799},
+		{"partial", 2025, 3, 29, "", 0},
+		{"hybrid", 2023, 4, 20, "", 0},
+		{"annular2012", 2012, 5, 21, "", 0},
+		{"annular2056", 2056, 7, 13, "", 0},
+	} {
+		b.Run(test.name, func(b *testing.B) {
+			zone := time.FixedZone("UTC+8", 8*3600)
+			day := time.Date(test.year, time.Month(test.month), test.day, 0, 0, 0, 0, zone)
+			var star moon.StarCoordinate
+			if test.hr > 0 {
+				data, err := basic.StarDataByHR(test.hr)
+				if err != nil {
+					b.Fatal(err)
+				}
+				star, err = moon.StarCoordinateFromStarData(data)
+				if err != nil {
+					b.Fatal(err)
+				}
+			}
+			options := moon.OccultationPathOptions{Step: 20 * time.Minute, TargetSpacingKM: 900, DisableFootprints: true, RiseSetStep: time.Minute}
+			b.ReportAllocs()
+			b.ResetTimer()
+			for i := 0; i < b.N; i++ {
+				var data []byte
+				var err error
+				if test.planet != "" {
+					paths, findErr := moon.FindPlanetOccultationPaths(day, day.Add(24*time.Hour), test.planet, options)
+					if findErr != nil || len(paths) != 1 {
+						b.Fatalf("paths=%d err=%v", len(paths), findErr)
+					}
+					data, err = geojson.MarshalPlanetOccultation(paths[0])
+				} else if test.hr > 0 {
+					paths, findErr := moon.FindStarOccultationPaths(day, day.Add(24*time.Hour), star, options)
+					if findErr != nil || len(paths) != 1 {
+						b.Fatalf("paths=%d err=%v", len(paths), findErr)
+					}
+					data, err = geojson.MarshalStarOccultation(paths[0])
+				} else {
+					path, ok := eclipse.SolarEclipsePartialFootprints(day, eclipse.SolarEclipsePartialFootprintOptions{Step: 5 * time.Minute, BoundaryPoints: 96, CentralShadowStep: 5 * time.Minute, RiseSetStep: 2 * time.Minute})
+					if !ok {
+						b.Fatal("missing eclipse")
+					}
+					data, err = geojson.MarshalSolarEclipse(path, nil)
+				}
+				if err != nil || len(data) == 0 {
+					b.Fatalf("bytes=%d err=%v", len(data), err)
+				}
+			}
+		})
+	}
+}