feat: 完善时标与天象几何计算并扩展输出接口

- 新增时标、ΔT 模型、质心时间与 UT1 支持
- 改进日月食、月掩、行星事件及路径边界计算
- 完善恒星三维自行与动态距离传播
- 扩展 SVG、GeoJSON、KML 输出与底层距离换算工具
- 整理中英文手册、示例资源及回归测试
This commit is contained in:
2026-09-23 18:55:12 +08:00
parent 1f31a9b5b5
commit 16c62a97d5
503 changed files with 33290 additions and 9471 deletions
+44 -44
View File
@@ -10,8 +10,8 @@ import (
var orbitJ2000Obliquity = EclipticObliquity(orbitReferenceJD, false)
// OrbitHeliocentricXYZJ2000 返回日心 J2000 平黄道直角坐标,单位 AU。
func OrbitHeliocentricXYZJ2000(jd float64, elements OrbitElements) Vector3 {
trueAnomaly, radius, resolved, ok := orbitTrueAnomalyAndRadius(jd, elements)
func OrbitHeliocentricXYZJ2000(jde float64, elements OrbitElements) Vector3 {
trueAnomaly, radius, resolved, ok := orbitTrueAnomalyAndRadius(jde, elements)
if !ok {
nan := math.NaN()
return Vector3{nan, nan, nan}
@@ -33,24 +33,24 @@ func OrbitHeliocentricXYZJ2000(jd float64, elements OrbitElements) Vector3 {
}
// OrbitHeliocentricEclipticJ2000 返回日心 J2000 平黄道球坐标,单位度/AU。
func OrbitHeliocentricEclipticJ2000(jd float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitHeliocentricXYZJ2000(jd, elements))
func OrbitHeliocentricEclipticJ2000(jde float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitHeliocentricXYZJ2000(jde, elements))
}
// OrbitHeliocentricXYZ 返回日心历元黄道直角坐标,单位 AU。
func OrbitHeliocentricXYZ(jd float64, elements OrbitElements) Vector3 {
return eclipticVectorAtReferenceEpoch(OrbitHeliocentricXYZJ2000(jd, elements), orbitReferenceJD, jd)
func OrbitHeliocentricXYZ(jde float64, elements OrbitElements) Vector3 {
return eclipticVectorAtReferenceEpoch(OrbitHeliocentricXYZJ2000(jde, elements), orbitReferenceJD, jde)
}
// OrbitHeliocentricEcliptic 返回日心历元黄道球坐标,单位度/AU。
func OrbitHeliocentricEcliptic(jd float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitHeliocentricXYZ(jd, elements))
func OrbitHeliocentricEcliptic(jde float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitHeliocentricXYZ(jde, elements))
}
// OrbitGeocentricXYZJ2000 返回地心 J2000 平黄道直角坐标,单位 AU。
func OrbitGeocentricXYZJ2000(jd float64, elements OrbitElements) Vector3 {
objectVector := OrbitHeliocentricXYZJ2000(jd, elements)
earthVector := earthHeliocentricVectorJ2000(jd)
func OrbitGeocentricXYZJ2000(jde float64, elements OrbitElements) Vector3 {
objectVector := OrbitHeliocentricXYZJ2000(jde, elements)
earthVector := earthHeliocentricVectorJ2000(jde)
return Vector3{
objectVector[0] - earthVector[0],
objectVector[1] - earthVector[1],
@@ -59,14 +59,14 @@ func OrbitGeocentricXYZJ2000(jd float64, elements OrbitElements) Vector3 {
}
// OrbitGeocentricEclipticJ2000 返回地心 J2000 平黄道球坐标,单位度/AU。
func OrbitGeocentricEclipticJ2000(jd float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitGeocentricXYZJ2000(jd, elements))
func OrbitGeocentricEclipticJ2000(jde float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitGeocentricXYZJ2000(jde, elements))
}
// OrbitGeocentricXYZ 返回地心历元黄道直角坐标,单位 AU。
func OrbitGeocentricXYZ(jd float64, elements OrbitElements) Vector3 {
objectVector := OrbitHeliocentricXYZ(jd, elements)
earthVector := earthHeliocentricVectorOfDate(jd)
func OrbitGeocentricXYZ(jde float64, elements OrbitElements) Vector3 {
objectVector := OrbitHeliocentricXYZ(jde, elements)
earthVector := earthHeliocentricVectorOfDate(jde)
return Vector3{
objectVector[0] - earthVector[0],
objectVector[1] - earthVector[1],
@@ -75,33 +75,33 @@ func OrbitGeocentricXYZ(jd float64, elements OrbitElements) Vector3 {
}
// OrbitGeocentricEcliptic 返回地心历元黄道球坐标,单位度/AU。
func OrbitGeocentricEcliptic(jd float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitGeocentricXYZ(jd, elements))
func OrbitGeocentricEcliptic(jde float64, elements OrbitElements) (lon, lat, distance float64) {
return orbitVectorToEcliptic(OrbitGeocentricXYZ(jde, elements))
}
// OrbitGeocentricEquatorialJ2000 返回地心 J2000 平赤道球坐标,单位度/AU。
func OrbitGeocentricEquatorialJ2000(jd float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitGeocentricXYZJ2000(jd, elements), orbitJ2000Obliquity)
func OrbitGeocentricEquatorialJ2000(jde float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitGeocentricXYZJ2000(jde, elements), orbitJ2000Obliquity)
return orbitVectorToEquatorial(vector)
}
// OrbitGeocentricEquatorial 返回地心历元平赤道球坐标,单位度/AU。
func OrbitGeocentricEquatorial(jd float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitGeocentricXYZ(jd, elements), EclipticObliquity(jd, false))
func OrbitGeocentricEquatorial(jde float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitGeocentricXYZ(jde, elements), EclipticObliquity(jde, false))
return orbitVectorToEquatorial(vector)
}
// OrbitAstrometricGeocentricXYZJ2000 返回光行时修正后的地心 J2000 平黄道直角坐标,单位 AU。
func OrbitAstrometricGeocentricXYZJ2000(jd float64, elements OrbitElements) Vector3 {
if !isFinite(jd) {
func OrbitAstrometricGeocentricXYZJ2000(jde float64, elements OrbitElements) Vector3 {
if !isFinite(jde) {
nan := math.NaN()
return Vector3{nan, nan, nan}
}
earthVector := earthHeliocentricVectorJ2000(jd)
earthVector := earthHeliocentricVectorJ2000(jde)
lightTime := 0.0
result := Vector3{}
for i := 0; i < 8; i++ {
objectVector := OrbitHeliocentricXYZJ2000(jd-lightTime, elements)
objectVector := OrbitHeliocentricXYZJ2000(jde-lightTime, elements)
result = Vector3{
objectVector[0] - earthVector[0],
objectVector[1] - earthVector[1],
@@ -117,40 +117,40 @@ func OrbitAstrometricGeocentricXYZJ2000(jd float64, elements OrbitElements) Vect
}
// OrbitAstrometricGeocentricEquatorialJ2000 返回光行时修正后的地心 J2000 赤道坐标,单位度/AU。
func OrbitAstrometricGeocentricEquatorialJ2000(jd float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitAstrometricGeocentricXYZJ2000(jd, elements), orbitJ2000Obliquity)
func OrbitAstrometricGeocentricEquatorialJ2000(jde float64, elements OrbitElements) (ra, dec, distance float64) {
vector := rotateEclipticToEquatorial(OrbitAstrometricGeocentricXYZJ2000(jde, elements), orbitJ2000Obliquity)
return orbitVectorToEquatorial(vector)
}
// OrbitApparentGeocentricEcliptic 返回光行时与章动修正后的地心视黄道坐标,单位度/AU。
func OrbitApparentGeocentricEcliptic(jd float64, elements OrbitElements) (lon, lat, distance float64) {
vectorDate := eclipticVectorAtReferenceEpoch(OrbitAstrometricGeocentricXYZJ2000(jd, elements), orbitReferenceJD, jd)
func OrbitApparentGeocentricEcliptic(jde float64, elements OrbitElements) (lon, lat, distance float64) {
vectorDate := eclipticVectorAtReferenceEpoch(OrbitAstrometricGeocentricXYZJ2000(jde, elements), orbitReferenceJD, jde)
lon, lat, distance = orbitVectorToEcliptic(vectorDate)
if math.IsNaN(lon) {
return math.NaN(), math.NaN(), math.NaN()
}
lon = Limit360(lon + Nutation2000Bi(jd))
lon = Limit360(lon + Nutation2000Bi(jde))
return lon, lat, distance
}
// OrbitApparentGeocentricEquatorial 返回光行时与章动修正后的地心视赤道坐标,单位度/AU。
func OrbitApparentGeocentricEquatorial(jd float64, elements OrbitElements) (ra, dec, distance float64) {
lon, lat, distance := OrbitApparentGeocentricEcliptic(jd, elements)
func OrbitApparentGeocentricEquatorial(jde float64, elements OrbitElements) (ra, dec, distance float64) {
lon, lat, distance := OrbitApparentGeocentricEcliptic(jde, elements)
if math.IsNaN(lon) {
return math.NaN(), math.NaN(), math.NaN()
}
ra, dec = LoBoToRaDec(jd, lon, lat)
ra, dec = LoBoToRaDec(jde, lon, lat)
return ra, dec, distance
}
// OrbitApparentTopocentricEquatorial 返回光行时、章动与站心修正后的视赤道坐标,单位度/AU。
func OrbitApparentTopocentricEquatorial(jd, observerLon, observerLat, observerHeight float64, elements OrbitElements) (ra, dec, distance float64) {
geocentricRA, geocentricDec, geocentricDistance := OrbitApparentGeocentricEquatorial(jd, elements)
func OrbitApparentTopocentricEquatorial(jde, observerLon, observerLat, observerHeight float64, elements OrbitElements) (ra, dec, distance float64) {
geocentricRA, geocentricDec, geocentricDistance := OrbitApparentGeocentricEquatorial(jde, elements)
if math.IsNaN(geocentricRA) {
return math.NaN(), math.NaN(), math.NaN()
}
geocentricVector := orbitEquatorialVector(geocentricRA, geocentricDec, geocentricDistance)
observerVector := orbitObserverEquatorialVectorOfDate(TD2UT(jd, false), observerLon, observerLat, observerHeight)
observerVector := orbitObserverEquatorialVectorOfDate(TT2UTC(jde), observerLon, observerLat, observerHeight)
topocentricVector := Vector3{
geocentricVector[0] - observerVector[0],
geocentricVector[1] - observerVector[1],
@@ -159,16 +159,16 @@ func OrbitApparentTopocentricEquatorial(jd, observerLon, observerLat, observerHe
return orbitVectorToEquatorial(topocentricVector)
}
func earthHeliocentricVectorOfDate(jd float64) Vector3 {
func earthHeliocentricVectorOfDate(jde float64) Vector3 {
return eclipticCartesian(
planet.WherePlanet(-1, 0, jd),
planet.WherePlanet(-1, 1, jd),
planet.WherePlanet(-1, 2, jd),
planet.WherePlanet(-1, 0, jde),
planet.WherePlanet(-1, 1, jde),
planet.WherePlanet(-1, 2, jde),
)
}
func earthHeliocentricVectorJ2000(jd float64) Vector3 {
return eclipticVectorAtReferenceEpoch(earthHeliocentricVectorOfDate(jd), jd, orbitReferenceJD)
func earthHeliocentricVectorJ2000(jde float64) Vector3 {
return eclipticVectorAtReferenceEpoch(earthHeliocentricVectorOfDate(jde), jde, orbitReferenceJD)
}
func orbitVectorToEcliptic(vector Vector3) (lon, lat, distance float64) {
@@ -207,7 +207,7 @@ func orbitEquatorialVector(ra, dec, distance float64) Vector3 {
}
func orbitObserverEquatorialVectorOfDate(jdUT, observerLon, observerLat, observerHeight float64) Vector3 {
localApparentSiderealLongitude := Limit360(ApparentSiderealTime(jdUT)*15 + observerLon)
localApparentSiderealLongitude := Limit360(ApparentSiderealTime(UTC2UT1(jdUT))*15 + observerLon)
observerScaleAU := Sin(0.0024427777777)
rhoCosPhiPrime := pcosi(observerLat, observerHeight)
rhoSinPhiPrime := psini(observerLat, observerHeight)