feat: 扩展天文计算能力

- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息 - 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算 - 新增木星伽利略卫星位置、现象与接触事件计算 - 新增恒星星表、星座判定、自行修正与观测辅助能力 - 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包 - 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算 - 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试 - 重构基础算法文件组织，补充大量公开 API 注释和语义回归测试 - 更新中文和英文 README，补充示例、精度说明、SVG 配图
2026-05-01 22:38:44 +08:00
parent 98ff574495
commit 3ffdbe0034
365 changed files with 63589 additions and 17508 deletions
@@ -0,0 +1,105 @@
+package jupiter
+
+import (
+	"encoding/json"
+	"math"
+	"os"
+	"testing"
+	"time"
+)
+
+const galileanShadowToleranceArcsec = 0.2
+
+type galileanPhenomenaSample struct {
+	UTC       string                                   `json:"utc"`
+	Phenomena map[string]galileanPhenomenonExpectation `json:"phenomena"`
+}
+
+type galileanPhenomenonExpectation struct {
+	Transit       bool     `json:"transit"`
+	Occultation   bool     `json:"occultation"`
+	Eclipse       bool     `json:"eclipse"`
+	ShadowTransit bool     `json:"shadow_transit"`
+	ShadowXArcsec *float64 `json:"shadow_x_arcsec,omitempty"`
+	ShadowYArcsec *float64 `json:"shadow_y_arcsec,omitempty"`
+}
+
+func TestGalileanPhenomenaAgainstHorizonsBaseline(t *testing.T) {
+	samples := loadGalileanPhenomenaBaseline(t)
+	maxShadowX := 0.0
+	maxShadowY := 0.0
+	for _, sample := range samples {
+		date, err := time.Parse(time.RFC3339, sample.UTC)
+		if err != nil {
+			t.Fatalf("parse %s: %v", sample.UTC, err)
+		}
+		got := SatellitePhenomena(date)
+		for name, want := range sample.Phenomena {
+			phenomenon := selectGalileanPhenomenon(got, name)
+			if phenomenon.Transit != want.Transit {
+				t.Fatalf("%s transit mismatch at %s: got %v want %v", name, sample.UTC, phenomenon.Transit, want.Transit)
+			}
+			if phenomenon.Occultation != want.Occultation {
+				t.Fatalf("%s occultation mismatch at %s: got %v want %v", name, sample.UTC, phenomenon.Occultation, want.Occultation)
+			}
+			if phenomenon.Eclipse != want.Eclipse {
+				t.Fatalf("%s eclipse mismatch at %s: got %v want %v", name, sample.UTC, phenomenon.Eclipse, want.Eclipse)
+			}
+			if phenomenon.ShadowTransit != want.ShadowTransit {
+				t.Fatalf("%s shadow-transit mismatch at %s: got %v want %v", name, sample.UTC, phenomenon.ShadowTransit, want.ShadowTransit)
+			}
+			if !want.ShadowTransit {
+				continue
+			}
+			if want.ShadowXArcsec == nil || want.ShadowYArcsec == nil {
+				t.Fatalf("%s shadow baseline incomplete at %s", name, sample.UTC)
+			}
+			xDiff := math.Abs(phenomenon.ShadowOffsetXArcsec - *want.ShadowXArcsec)
+			yDiff := math.Abs(phenomenon.ShadowOffsetYArcsec - *want.ShadowYArcsec)
+			if xDiff > maxShadowX {
+				maxShadowX = xDiff
+			}
+			if yDiff > maxShadowY {
+				maxShadowY = yDiff
+			}
+			if xDiff > galileanShadowToleranceArcsec {
+				t.Fatalf("%s shadow X mismatch at %s: got %.6f want %.6f", name, sample.UTC, phenomenon.ShadowOffsetXArcsec, *want.ShadowXArcsec)
+			}
+			if yDiff > galileanShadowToleranceArcsec {
+				t.Fatalf("%s shadow Y mismatch at %s: got %.6f want %.6f", name, sample.UTC, phenomenon.ShadowOffsetYArcsec, *want.ShadowYArcsec)
+			}
+		}
+	}
+	t.Logf("galilean phenomena shadow max diff: X=%.3f arcsec Y=%.3f arcsec", maxShadowX, maxShadowY)
+}
+
+func loadGalileanPhenomenaBaseline(t *testing.T) []galileanPhenomenaSample {
+	t.Helper()
+	data, err := os.ReadFile("testdata/galilean_phenomena_horizons.json")
+	if err != nil {
+		t.Fatal(err)
+	}
+	var samples []galileanPhenomenaSample
+	if err := json.Unmarshal(data, &samples); err != nil {
+		t.Fatal(err)
+	}
+	if len(samples) == 0 {
+		t.Fatal("empty phenomena baseline")
+	}
+	return samples
+}
+
+func selectGalileanPhenomenon(info GalileanPhenomenaInfo, name string) GalileanSatellitePhenomenon {
+	switch name {
+	case "io":
+		return info.Io
+	case "europa":
+		return info.Europa
+	case "ganymede":
+		return info.Ganymede
+	case "callisto":
+		return info.Callisto
+	default:
+		panic("unknown satellite: " + name)
+	}
+}