feat: 扩展天文计算能力
- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息 - 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算 - 新增木星伽利略卫星位置、现象与接触事件计算 - 新增恒星星表、星座判定、自行修正与观测辅助能力 - 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包 - 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算 - 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试 - 重构基础算法文件组织，补充大量公开 API 注释和语义回归测试 - 更新中文和英文 README，补充示例、精度说明、SVG 配图
This commit is contained in:
@@ -0,0 +1,143 @@
|
||||
package moon
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"time"
|
||||
|
||||
"b612.me/astro/basic"
|
||||
lite "b612.me/astro/lite/internal"
|
||||
. "b612.me/astro/tools"
|
||||
)
|
||||
|
||||
var (
|
||||
ERR_MOON_NEVER_RISE = errors.New("ERROR:极夜，月亮在今日永远在地平线下！")
|
||||
ERR_MOON_NEVER_SET = errors.New("ERROR:极昼，月亮在今日永远在地平线上！")
|
||||
ERR_NOT_TODAY = errors.New("ERROR:月亮已在（昨日/明日）（升起/降下）")
|
||||
)
|
||||
|
||||
// TrueLo 轻量真黄经 / lightweight true ecliptic longitude.
|
||||
func TrueLo(date time.Time) float64 {
|
||||
return lite.MoonGeocentric(basic.Date2JDE(date.UTC())).Longitude
|
||||
}
|
||||
|
||||
// TrueBo 轻量真黄纬 / lightweight true ecliptic latitude.
|
||||
func TrueBo(date time.Time) float64 {
|
||||
return lite.MoonGeocentric(basic.Date2JDE(date.UTC())).Latitude
|
||||
}
|
||||
|
||||
// TrueRa 轻量真赤经 / lightweight true right ascension.
|
||||
func TrueRa(date time.Time) float64 {
|
||||
return lite.MoonGeocentric(basic.Date2JDE(date.UTC())).RightAscension
|
||||
}
|
||||
|
||||
// TrueDec 轻量真赤纬 / lightweight true declination.
|
||||
func TrueDec(date time.Time) float64 {
|
||||
return lite.MoonGeocentric(basic.Date2JDE(date.UTC())).Declination
|
||||
}
|
||||
|
||||
// TrueRaDec 轻量真赤经、真赤纬 / lightweight true right ascension and declination.
|
||||
func TrueRaDec(date time.Time) (float64, float64) {
|
||||
state := lite.MoonGeocentric(basic.Date2JDE(date.UTC()))
|
||||
return state.RightAscension, state.Declination
|
||||
}
|
||||
|
||||
// ApparentRa 轻量站心视赤经 / lightweight topocentric apparent right ascension.
|
||||
func ApparentRa(date time.Time, lon, lat float64) float64 {
|
||||
state := lite.MoonTopocentric(basic.Date2JDE(date.UTC()), lon, lat, 0)
|
||||
return state.RightAscension
|
||||
}
|
||||
|
||||
// ApparentDec 轻量站心视赤纬 / lightweight topocentric apparent declination.
|
||||
func ApparentDec(date time.Time, lon, lat float64) float64 {
|
||||
state := lite.MoonTopocentric(basic.Date2JDE(date.UTC()), lon, lat, 0)
|
||||
return state.Declination
|
||||
}
|
||||
|
||||
// ApparentRaDec 轻量站心视赤经、视赤纬 / lightweight topocentric apparent right ascension and declination.
|
||||
func ApparentRaDec(date time.Time, lon, lat float64) (float64, float64) {
|
||||
state := lite.MoonTopocentric(basic.Date2JDE(date.UTC()), lon, lat, 0)
|
||||
return state.RightAscension, state.Declination
|
||||
}
|
||||
|
||||
// HourAngle 轻量时角 / lightweight hour angle.
|
||||
func HourAngle(date time.Time, lon, lat float64) float64 {
|
||||
_, _, hourAngle := lite.HorizontalCoordinates(ApparentRa(date, lon, lat), ApparentDec(date, lon, lat), basic.Date2JDE(date.UTC()), lon, lat)
|
||||
return hourAngle
|
||||
}
|
||||
|
||||
// Azimuth 轻量方位角 / lightweight azimuth.
|
||||
func Azimuth(date time.Time, lon, lat float64) float64 {
|
||||
_, azimuth, _ := lite.HorizontalCoordinates(ApparentRa(date, lon, lat), ApparentDec(date, lon, lat), basic.Date2JDE(date.UTC()), lon, lat)
|
||||
return azimuth
|
||||
}
|
||||
|
||||
// Altitude 轻量高度角 / lightweight altitude.
|
||||
func Altitude(date time.Time, lon, lat float64) float64 {
|
||||
altitude, _, _ := lite.HorizontalCoordinates(ApparentRa(date, lon, lat), ApparentDec(date, lon, lat), basic.Date2JDE(date.UTC()), lon, lat)
|
||||
return altitude
|
||||
}
|
||||
|
||||
// Zenith 轻量天顶距 / lightweight zenith distance.
|
||||
func Zenith(date time.Time, lon, lat float64) float64 {
|
||||
return 90 - Altitude(date, lon, lat)
|
||||
}
|
||||
|
||||
// SunMoonLoDiff 轻量日月黄经差 / lightweight Moon-Sun ecliptic-longitude difference.
|
||||
func SunMoonLoDiff(date time.Time) float64 {
|
||||
jd := basic.Date2JDE(date.UTC())
|
||||
return Limit360(lite.MoonGeocentric(jd).Longitude - lite.SunApparentLo(jd))
|
||||
}
|
||||
|
||||
// PhaseAge 轻量月龄 / lightweight lunar age in days.
|
||||
func PhaseAge(date time.Time) float64 {
|
||||
return lite.SynodicMonthDays * SunMoonLoDiff(date) / 360.0
|
||||
}
|
||||
|
||||
// Phase 轻量受照比例 / lightweight illuminated fraction.
|
||||
func Phase(date time.Time) float64 {
|
||||
return 0.5 * (1 - Cos(SunMoonLoDiff(date)))
|
||||
}
|
||||
|
||||
// RiseTime 轻量月出时刻 / lightweight moonrise time.
|
||||
func RiseTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
|
||||
return riseSetTime(date, lon, lat, height, aero, true)
|
||||
}
|
||||
|
||||
// SetTime 轻量月落时刻 / lightweight moonset time.
|
||||
func SetTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
|
||||
return riseSetTime(date, lon, lat, height, aero, false)
|
||||
}
|
||||
|
||||
func riseSetTime(date time.Time, lon, lat, height float64, aero, isRise bool) (time.Time, error) {
|
||||
localMidnight := time.Date(date.Year(), date.Month(), date.Day(), 0, 0, 0, 0, date.Location())
|
||||
localJD := basic.Date2JDE(localMidnight)
|
||||
_, offset := localMidnight.Zone()
|
||||
timezone := float64(offset) / 3600.0
|
||||
|
||||
targetAltitude := -basic.HeightDegreeByLat(height, lat)
|
||||
if aero {
|
||||
targetAltitude -= 0.83333
|
||||
}
|
||||
|
||||
altitudeFn := func(localJD float64) float64 {
|
||||
utJD := localJD - timezone/24.0
|
||||
state := lite.MoonTopocentric(utJD, lon, lat, height)
|
||||
altitude, _, _ := lite.HorizontalCoordinates(state.RightAscension, state.Declination, utJD, lon, lat)
|
||||
return altitude
|
||||
}
|
||||
|
||||
eventJD, err := lite.SearchRiseSet(localJD, targetAltitude, 15, isRise, altitudeFn)
|
||||
if err != nil {
|
||||
switch {
|
||||
case errors.Is(err, lite.ErrNeverRise):
|
||||
return time.Time{}, ERR_MOON_NEVER_RISE
|
||||
case errors.Is(err, lite.ErrNeverSet):
|
||||
return time.Time{}, ERR_MOON_NEVER_SET
|
||||
case errors.Is(err, lite.ErrNotOnThisDate):
|
||||
return time.Time{}, ERR_NOT_TODAY
|
||||
default:
|
||||
return time.Time{}, err
|
||||
}
|
||||
}
|
||||
return basic.JDE2DateByZone(eventJD, date.Location(), true), nil
|
||||
}
|
||||
@@ -0,0 +1,94 @@
|
||||
package moon
|
||||
|
||||
import (
|
||||
"math"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
fullmoon "b612.me/astro/moon"
|
||||
)
|
||||
|
||||
func TestLiteMoonGeocentricAgainstFullPrecision(t *testing.T) {
|
||||
samples := []time.Time{
|
||||
time.Date(2026, 1, 1, 0, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 2, 14, 12, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 4, 1, 6, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 6, 21, 18, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 8, 9, 0, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 10, 5, 6, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 11, 27, 0, 0, 0, 0, time.UTC),
|
||||
}
|
||||
|
||||
for _, sample := range samples {
|
||||
if got, want := TrueLo(sample), fullmoon.TrueLo(sample); math.Abs(angleDiff(got, want)) > 0.20 {
|
||||
t.Fatalf("TrueLo(%s) = %.6f, want %.6f", sample.Format(time.RFC3339), got, want)
|
||||
}
|
||||
if got, want := TrueBo(sample), fullmoon.TrueBo(sample); math.Abs(got-want) > 0.06 {
|
||||
t.Fatalf("TrueBo(%s) = %.6f, want %.6f", sample.Format(time.RFC3339), got, want)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestLiteMoonPhaseAgainstFullPrecision(t *testing.T) {
|
||||
samples := []time.Time{
|
||||
time.Date(2026, 1, 10, 0, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 1, 18, 0, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 1, 25, 0, 0, 0, 0, time.UTC),
|
||||
time.Date(2026, 2, 2, 0, 0, 0, 0, time.UTC),
|
||||
}
|
||||
|
||||
for _, sample := range samples {
|
||||
if got, want := Phase(sample), fullmoon.Phase(sample); math.Abs(got-want) > 0.03 {
|
||||
t.Fatalf("Phase(%s) = %.6f, want %.6f", sample.Format(time.RFC3339), got, want)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestLiteMoonRiseSetAgainstFullPrecision(t *testing.T) {
|
||||
cases := []struct {
|
||||
name string
|
||||
date time.Time
|
||||
lon float64
|
||||
lat float64
|
||||
}{
|
||||
{"Shanghai", time.Date(2026, 1, 1, 0, 0, 0, 0, time.FixedZone("CST", 8*3600)), 121.4737, 31.2304},
|
||||
{"London", time.Date(2026, 3, 17, 0, 0, 0, 0, time.UTC), -0.1278, 51.5074},
|
||||
{"NewYork", time.Date(2026, 4, 16, 0, 0, 0, 0, time.FixedZone("EST", -5*3600)), -74.0060, 40.7128},
|
||||
{"Sydney", time.Date(2026, 8, 14, 0, 0, 0, 0, time.FixedZone("AEST", 10*3600)), 151.2093, -33.8688},
|
||||
{"Reykjavik", time.Date(2026, 11, 27, 0, 0, 0, 0, time.UTC), -21.8174, 64.1265},
|
||||
}
|
||||
|
||||
for _, tc := range cases {
|
||||
gotRise, gotErr := RiseTime(tc.date, tc.lon, tc.lat, 0, true)
|
||||
wantRise, wantErr := fullmoon.RiseTime(tc.date, tc.lon, tc.lat, 0, true)
|
||||
if gotErr != nil || wantErr != nil {
|
||||
t.Fatalf("%s rise unexpected error: got=%v want=%v", tc.name, gotErr, wantErr)
|
||||
}
|
||||
assertTimeWithinMinutes(t, tc.name+" rise", gotRise, wantRise, 3.0)
|
||||
|
||||
gotSet, gotSetErr := SetTime(tc.date, tc.lon, tc.lat, 0, true)
|
||||
wantSet, wantSetErr := fullmoon.SetTime(tc.date, tc.lon, tc.lat, 0, true)
|
||||
if gotSetErr != nil || wantSetErr != nil {
|
||||
t.Fatalf("%s set unexpected error: got=%v want=%v", tc.name, gotSetErr, wantSetErr)
|
||||
}
|
||||
assertTimeWithinMinutes(t, tc.name+" set", gotSet, wantSet, 3.0)
|
||||
}
|
||||
}
|
||||
|
||||
func angleDiff(a, b float64) float64 {
|
||||
diff := math.Mod(a-b, 360)
|
||||
if diff > 180 {
|
||||
diff -= 360
|
||||
}
|
||||
if diff < -180 {
|
||||
diff += 360
|
||||
}
|
||||
return diff
|
||||
}
|
||||
|
||||
func assertTimeWithinMinutes(t *testing.T, name string, got, want time.Time, limitMinutes float64) {
|
||||
t.Helper()
|
||||
if math.Abs(got.Sub(want).Minutes()) > limitMinutes {
|
||||
t.Fatalf("%s = %s, want %s", name, got, want)
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user