b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
264 lines
9.7 KiB
Go
264 lines
9.7 KiB
Go
package astro_test
|
|
|
|
import (
|
|
"math"
|
|
"testing"
|
|
"time"
|
|
|
|
"b612.me/astro/basic"
|
|
"b612.me/astro/calendar"
|
|
"b612.me/astro/jupiter"
|
|
"b612.me/astro/mars"
|
|
"b612.me/astro/mercury"
|
|
"b612.me/astro/moon"
|
|
"b612.me/astro/neptune"
|
|
"b612.me/astro/saturn"
|
|
"b612.me/astro/star"
|
|
"b612.me/astro/sun"
|
|
"b612.me/astro/uranus"
|
|
"b612.me/astro/venus"
|
|
)
|
|
|
|
func nearlyEqual(a, b float64) bool {
|
|
return math.Abs(a-b) <= 1e-12
|
|
}
|
|
|
|
func TestPlanetAbsoluteQuantitiesIgnoreInputTimezone(t *testing.T) {
|
|
utc := time.Date(2026, 1, 2, 3, 4, 5, 123456789, time.UTC)
|
|
cst := time.FixedZone("CST", 8*3600)
|
|
local := utc.In(cst)
|
|
|
|
scalars := []struct {
|
|
name string
|
|
fn func(time.Time) float64
|
|
}{
|
|
{"mercury.ApparentLo", mercury.ApparentLo},
|
|
{"mercury.ApparentBo", mercury.ApparentBo},
|
|
{"mercury.ApparentRa", mercury.ApparentRa},
|
|
{"mercury.ApparentDec", mercury.ApparentDec},
|
|
{"mercury.ApparentMagnitude", mercury.ApparentMagnitude},
|
|
{"mercury.EarthDistance", mercury.EarthDistance},
|
|
{"mercury.SunDistance", mercury.SunDistance},
|
|
{"venus.ApparentLo", venus.ApparentLo},
|
|
{"venus.ApparentBo", venus.ApparentBo},
|
|
{"venus.ApparentRa", venus.ApparentRa},
|
|
{"venus.ApparentDec", venus.ApparentDec},
|
|
{"venus.ApparentMagnitude", venus.ApparentMagnitude},
|
|
{"venus.EarthDistance", venus.EarthDistance},
|
|
{"venus.SunDistance", venus.SunDistance},
|
|
{"mars.ApparentLo", mars.ApparentLo},
|
|
{"mars.ApparentBo", mars.ApparentBo},
|
|
{"mars.ApparentRa", mars.ApparentRa},
|
|
{"mars.ApparentDec", mars.ApparentDec},
|
|
{"mars.ApparentMagnitude", mars.ApparentMagnitude},
|
|
{"mars.EarthDistance", mars.EarthDistance},
|
|
{"mars.SunDistance", mars.SunDistance},
|
|
{"jupiter.ApparentLo", jupiter.ApparentLo},
|
|
{"jupiter.ApparentBo", jupiter.ApparentBo},
|
|
{"jupiter.ApparentRa", jupiter.ApparentRa},
|
|
{"jupiter.ApparentDec", jupiter.ApparentDec},
|
|
{"jupiter.ApparentMagnitude", jupiter.ApparentMagnitude},
|
|
{"jupiter.EarthDistance", jupiter.EarthDistance},
|
|
{"jupiter.SunDistance", jupiter.SunDistance},
|
|
{"saturn.ApparentLo", saturn.ApparentLo},
|
|
{"saturn.ApparentBo", saturn.ApparentBo},
|
|
{"saturn.ApparentRa", saturn.ApparentRa},
|
|
{"saturn.ApparentDec", saturn.ApparentDec},
|
|
{"saturn.ApparentMagnitude", saturn.ApparentMagnitude},
|
|
{"saturn.EarthDistance", saturn.EarthDistance},
|
|
{"saturn.SunDistance", saturn.SunDistance},
|
|
{"uranus.ApparentLo", uranus.ApparentLo},
|
|
{"uranus.ApparentBo", uranus.ApparentBo},
|
|
{"uranus.ApparentRa", uranus.ApparentRa},
|
|
{"uranus.ApparentDec", uranus.ApparentDec},
|
|
{"uranus.ApparentMagnitude", uranus.ApparentMagnitude},
|
|
{"uranus.EarthDistance", uranus.EarthDistance},
|
|
{"uranus.SunDistance", uranus.SunDistance},
|
|
{"neptune.ApparentLo", neptune.ApparentLo},
|
|
{"neptune.ApparentBo", neptune.ApparentBo},
|
|
{"neptune.ApparentRa", neptune.ApparentRa},
|
|
{"neptune.ApparentDec", neptune.ApparentDec},
|
|
{"neptune.ApparentMagnitude", neptune.ApparentMagnitude},
|
|
{"neptune.EarthDistance", neptune.EarthDistance},
|
|
{"neptune.SunDistance", neptune.SunDistance},
|
|
}
|
|
|
|
for _, tc := range scalars {
|
|
if !nearlyEqual(tc.fn(utc), tc.fn(local)) {
|
|
t.Fatalf("%s should depend on absolute time only", tc.name)
|
|
}
|
|
}
|
|
|
|
pairs := []struct {
|
|
name string
|
|
fn func(time.Time) (float64, float64)
|
|
}{
|
|
{"mercury.ApparentRaDec", mercury.ApparentRaDec},
|
|
{"venus.ApparentRaDec", venus.ApparentRaDec},
|
|
{"mars.ApparentRaDec", mars.ApparentRaDec},
|
|
{"jupiter.ApparentRaDec", jupiter.ApparentRaDec},
|
|
{"saturn.ApparentRaDec", saturn.ApparentRaDec},
|
|
{"uranus.ApparentRaDec", uranus.ApparentRaDec},
|
|
{"neptune.ApparentRaDec", neptune.ApparentRaDec},
|
|
}
|
|
|
|
for _, tc := range pairs {
|
|
leftA, leftB := tc.fn(utc)
|
|
rightA, rightB := tc.fn(local)
|
|
if !nearlyEqual(leftA, rightA) || !nearlyEqual(leftB, rightB) {
|
|
t.Fatalf("%s should depend on absolute time only", tc.name)
|
|
}
|
|
}
|
|
}
|
|
|
|
func TestJDCalcRejectsGregorianGap(t *testing.T) {
|
|
cases := []float64{5, 6.5, 10, 14.25}
|
|
for _, day := range cases {
|
|
got := basic.JDCalc(1582, 10, day)
|
|
if !math.IsNaN(got) {
|
|
t.Fatalf("1582-10-%v should be rejected, got %.15f", day, got)
|
|
}
|
|
}
|
|
|
|
before := basic.JDCalc(1582, 10, 4)
|
|
after := basic.JDCalc(1582, 10, 15)
|
|
if math.IsNaN(before) || math.IsNaN(after) {
|
|
t.Fatal("boundary dates around Gregorian reform should remain valid")
|
|
}
|
|
if !nearlyEqual(after-before, 1) {
|
|
t.Fatalf("1582-10-15 should remain the civil day after 1582-10-04")
|
|
}
|
|
}
|
|
|
|
func TestCalendarAddPreservesOriginalTimezone(t *testing.T) {
|
|
oldLocal := time.Local
|
|
time.Local = time.UTC
|
|
defer func() {
|
|
time.Local = oldLocal
|
|
}()
|
|
|
|
tz := time.FixedZone("CST", 8*3600)
|
|
start := time.Date(1985, 1, 21, 9, 30, 0, 0, tz)
|
|
|
|
lunar, err := calendar.SolarToLunar(start)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
expected, err := calendar.SolarToLunar(lunar.Time().Add(36 * time.Hour))
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
|
|
shifted := lunar.Add(36 * time.Hour).Time()
|
|
if delta := shifted.Sub(expected.Time()); delta < -time.Millisecond || delta > time.Millisecond {
|
|
t.Fatalf("calendar.Time.Add should not depend on time.Local: got %v want %v", shifted, expected.Time())
|
|
}
|
|
}
|
|
|
|
func TestObservationZenithMatchesIndependentFormula(t *testing.T) {
|
|
places := []struct {
|
|
name string
|
|
lon, lat float64
|
|
}{
|
|
{"beijing", 116.391, 39.907},
|
|
{"sydney", 151.2093, -33.8688},
|
|
{"tromso", 18.9553, 69.6492},
|
|
}
|
|
dates := []time.Time{
|
|
time.Date(1900, 1, 1, 0, 0, 0, 0, time.UTC),
|
|
time.Date(2000, 1, 1, 12, 0, 0, 0, time.UTC),
|
|
time.Date(2024, 2, 29, 23, 59, 59, 0, time.UTC),
|
|
time.Date(2026, 4, 26, 9, 30, 45, 123456789, time.FixedZone("CST", 8*3600)),
|
|
time.Date(2100, 6, 15, 3, 4, 5, 0, time.UTC),
|
|
}
|
|
starRa := 6.752477
|
|
starDec := -16.716116
|
|
|
|
// 容差取实测最大偏差的 5 倍以上；太阳还含视位置的入口差异，月光低精度级数与高精度级数本身不同源。
|
|
const (
|
|
sunTolerance = 2e-3
|
|
moonTolerance = 5e-8
|
|
moonLowTolerance = 3e-3
|
|
starTolerance = 1e-12
|
|
planetTolerance = 5e-9
|
|
)
|
|
|
|
for _, date := range dates {
|
|
for _, place := range places {
|
|
jde := basic.Date2JD(date)
|
|
_, loc := date.Zone()
|
|
timezone := float64(loc) / 3600.0
|
|
utcJD := jde - timezone/24
|
|
tt := basic.UTC2TT(utcJD)
|
|
|
|
checks := []struct {
|
|
name string
|
|
tol float64
|
|
zenith float64
|
|
witness float64
|
|
}{
|
|
{"sun", sunTolerance,
|
|
sun.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(sun.HourAngle(date, place.lon, place.lat), basic.HSunApparentRa(tt), basic.HSunApparentDec(tt), basic.EarthAway(tt), place.lat, place.lon, utcJD)},
|
|
{"moon", moonTolerance,
|
|
moon.Zenith(date, place.lon, place.lat),
|
|
zenithFromHourAngle(moon.HourAngle(date, place.lon, place.lat), moon.ApparentDec(date, place.lon, place.lat), place.lat)},
|
|
{"moon-low-precision-series", moonLowTolerance,
|
|
moon.Zenith(date, place.lon, place.lat),
|
|
90 - basic.MoonHeight(jde, place.lon, place.lat, timezone)},
|
|
{"star", starTolerance,
|
|
star.Zenith(date, starRa, starDec, place.lon, place.lat),
|
|
zenithFromHourAngle(star.HourAngle(date, starRa, place.lon), starDec, place.lat)},
|
|
{"mercury", planetTolerance,
|
|
mercury.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(mercury.HourAngle(date, place.lon), mercury.ApparentRa(date), mercury.ApparentDec(date), basic.EarthMercuryAway(tt), place.lat, place.lon, utcJD)},
|
|
{"venus", planetTolerance,
|
|
venus.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(venus.HourAngle(date, place.lon), venus.ApparentRa(date), venus.ApparentDec(date), basic.EarthVenusAway(tt), place.lat, place.lon, utcJD)},
|
|
{"mars", planetTolerance,
|
|
mars.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(mars.HourAngle(date, place.lon), mars.ApparentRa(date), mars.ApparentDec(date), basic.EarthMarsAway(tt), place.lat, place.lon, utcJD)},
|
|
{"jupiter", planetTolerance,
|
|
jupiter.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(jupiter.HourAngle(date, place.lon), jupiter.ApparentRa(date), jupiter.ApparentDec(date), basic.EarthJupiterAway(tt), place.lat, place.lon, utcJD)},
|
|
{"saturn", planetTolerance,
|
|
saturn.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(saturn.HourAngle(date, place.lon), saturn.ApparentRa(date), saturn.ApparentDec(date), basic.EarthSaturnAway(tt), place.lat, place.lon, utcJD)},
|
|
{"uranus", planetTolerance,
|
|
uranus.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(uranus.HourAngle(date, place.lon), uranus.ApparentRa(date), uranus.ApparentDec(date), basic.EarthUranusAway(tt), place.lat, place.lon, utcJD)},
|
|
{"neptune", planetTolerance,
|
|
neptune.Zenith(date, place.lon, place.lat),
|
|
topocentricZenith(neptune.HourAngle(date, place.lon), neptune.ApparentRa(date), neptune.ApparentDec(date), basic.EarthNeptuneAway(tt), place.lat, place.lon, utcJD)},
|
|
}
|
|
|
|
for _, tc := range checks {
|
|
if delta := math.Abs(tc.zenith - tc.witness); delta > tc.tol {
|
|
t.Fatalf("%s %s at %s: zenith %.9f, independent formula %.9f, delta %.3g > %.3g",
|
|
place.name, tc.name, date.Format(time.RFC3339), tc.zenith, tc.witness, delta, tc.tol)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// topocentricZenith 由地心时角、地心视赤经赤纬与地心距（AU）先做站心视差修正，再独立求天顶距，单位度。
|
|
func topocentricZenith(hourAngle, ra, dec, distanceAU, lat, lon, utcJD float64) float64 {
|
|
topocentricRA, topocentricDec := basic.TopocentricRaDec(ra, dec, lat, lon, utcJD, distanceAU, 0)
|
|
return zenithFromHourAngle(hourAngle+ra-topocentricRA, topocentricDec, lat)
|
|
}
|
|
|
|
// zenithFromHourAngle 由时角与赤纬按 cos z = sinφ·sinδ + cosφ·cosδ·cos H 独立求天顶距，单位度。
|
|
func zenithFromHourAngle(hourAngle, dec, lat float64) float64 {
|
|
rad := math.Pi / 180
|
|
sinZenith := math.Sin(lat*rad)*math.Sin(dec*rad) + math.Cos(dec*rad)*math.Cos(lat*rad)*math.Cos(hourAngle*rad)
|
|
if sinZenith > 1 {
|
|
sinZenith = 1
|
|
}
|
|
if sinZenith < -1 {
|
|
sinZenith = -1
|
|
}
|
|
return math.Acos(sinZenith) / rad
|
|
}
|