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
+61 -61
View File
@@ -7,79 +7,79 @@ import (
. "b612.me/astro/tools"
)
func SaturnL(jd float64) float64 {
return planet.WherePlanet(5, 0, jd)
func SaturnL(jde float64) float64 {
return planet.WherePlanet(5, 0, jde)
}
func SaturnB(jd float64) float64 {
return planet.WherePlanet(5, 1, jd)
func SaturnB(jde float64) float64 {
return planet.WherePlanet(5, 1, jde)
}
func SaturnR(jd float64) float64 {
return planet.WherePlanet(5, 2, jd)
func SaturnR(jde float64) float64 {
return planet.WherePlanet(5, 2, jde)
}
func ASaturnX(jd float64) float64 {
l := SaturnL(jd)
b := SaturnB(jd)
r := SaturnR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func ASaturnX(jde float64) float64 {
l := SaturnL(jde)
b := SaturnB(jde)
r := SaturnR(jde)
el := planet.WherePlanet(-1, 0, jde)
eb := planet.WherePlanet(-1, 1, jde)
er := planet.WherePlanet(-1, 2, jde)
x := r*Cos(b)*Cos(l) - er*Cos(eb)*Cos(el)
return x
}
func ASaturnY(jd float64) float64 {
func ASaturnY(jde float64) float64 {
l := SaturnL(jd)
b := SaturnB(jd)
r := SaturnR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
l := SaturnL(jde)
b := SaturnB(jde)
r := SaturnR(jde)
el := planet.WherePlanet(-1, 0, jde)
eb := planet.WherePlanet(-1, 1, jde)
er := planet.WherePlanet(-1, 2, jde)
y := r*Cos(b)*Sin(l) - er*Cos(eb)*Sin(el)
return y
}
func ASaturnZ(jd float64) float64 {
//l := SaturnL(jd)
b := SaturnB(jd)
r := SaturnR(jd)
// el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func ASaturnZ(jde float64) float64 {
//l := SaturnL(jde)
b := SaturnB(jde)
r := SaturnR(jde)
// el := planet.WherePlanet(-1, 0, jde)
eb := planet.WherePlanet(-1, 1, jde)
er := planet.WherePlanet(-1, 2, jde)
z := r*Sin(b) - er*Sin(eb)
return z
}
func ASaturnXYZ(jd float64) (float64, float64, float64) {
l := SaturnL(jd)
b := SaturnB(jd)
r := SaturnR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func ASaturnXYZ(jde float64) (float64, float64, float64) {
l := SaturnL(jde)
b := SaturnB(jde)
r := SaturnR(jde)
el := planet.WherePlanet(-1, 0, jde)
eb := planet.WherePlanet(-1, 1, jde)
er := planet.WherePlanet(-1, 2, jde)
x := r*Cos(b)*Cos(l) - er*Cos(eb)*Cos(el)
y := r*Cos(b)*Sin(l) - er*Cos(eb)*Sin(el)
z := r*Sin(b) - er*Sin(eb)
return x, y, z
}
func SaturnApparentRa(jd float64) float64 {
lo, bo := SaturnApparentLoBo(jd)
eps := TrueObliquity(jd)
func SaturnApparentRa(jde float64) float64 {
lo, bo := SaturnApparentLoBo(jde)
eps := TrueObliquity(jde)
ra := math.Atan2((Sin(lo)*Cos(eps) - Tan(bo)*Sin(eps)), Cos(lo))
ra = ra * 180 / math.Pi
return Limit360(ra)
}
func SaturnApparentDec(jd float64) float64 {
lo, bo := SaturnApparentLoBo(jd)
eps := TrueObliquity(jd)
func SaturnApparentDec(jde float64) float64 {
lo, bo := SaturnApparentLoBo(jde)
eps := TrueObliquity(jde)
dec := ArcSin(Sin(bo)*Cos(eps) + Cos(bo)*Sin(eps)*Sin(lo))
return dec
}
func SaturnApparentRaDec(jd float64) (float64, float64) {
lo, bo := SaturnApparentLoBo(jd)
eps := TrueObliquity(jd)
func SaturnApparentRaDec(jde float64) (float64, float64) {
lo, bo := SaturnApparentLoBo(jde)
eps := TrueObliquity(jde)
ra := math.Atan2((Sin(lo)*Cos(eps) - Tan(bo)*Sin(eps)), Cos(lo))
ra = ra * 180 / math.Pi
dec := ArcSin(Sin(bo)*Cos(eps) + Cos(bo)*Sin(eps)*Sin(lo))
@@ -105,16 +105,16 @@ func SaturnApparentLoBo(jd float64) (float64, float64) {
return geo.lo, geo.bo
}
func SaturnMag(jd float64) float64 {
return SaturnMagN(jd, -1)
func SaturnMag(jde float64) float64 {
return SaturnMagN(jde, -1)
}
func SaturnHeight(jde, lon, lat, timezone float64) float64 {
func SaturnHeight(localJD, lon, lat, timezone float64) float64 {
// 转换为世界时
utcJde := jde - timezone/24.0
utcJD := localJD - timezone/24.0
// 计算视恒星时
ra, dec := SaturnApparentRaDec(TD2UT(utcJde, true))
st := Limit360(ApparentSiderealTime(utcJde)*15 + lon)
ra, dec := SaturnApparentRaDec(UTC2TT(utcJD))
st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
// 计算时角
hourAngle := Limit360(st - ra)
// 高度角、时角与天球座标三角转换公式
@@ -123,12 +123,12 @@ func SaturnHeight(jde, lon, lat, timezone float64) float64 {
return ArcSin(sinHeight)
}
func SaturnAzimuth(jde, lon, lat, timezone float64) float64 {
func SaturnAzimuth(localJD, lon, lat, timezone float64) float64 {
// 转换为世界时
utcJde := jde - timezone/24.0
utcJD := localJD - timezone/24.0
// 计算视恒星时
ra, dec := SaturnApparentRaDec(TD2UT(utcJde, true))
st := Limit360(ApparentSiderealTime(utcJde)*15 + lon)
ra, dec := SaturnApparentRaDec(UTC2TT(utcJD))
st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
// 计算时角
hourAngle := Limit360(st - ra)
// 三角转换公式
@@ -147,21 +147,21 @@ func SaturnAzimuth(jde, lon, lat, timezone float64) float64 {
}
func SaturnHourAngle(jd, lon, timezone float64) float64 {
siderealLongitude := Limit360(ApparentSiderealTime(jd-timezone/24)*15 + lon)
hourAngle := siderealLongitude - SaturnApparentRa(TD2UT(jd-timezone/24.0, true))
siderealLongitude := Limit360(ApparentSiderealTime(UTC2UT1(jd-timezone/24))*15 + lon)
hourAngle := siderealLongitude - SaturnApparentRa(UTC2TT(jd-timezone/24.0))
if hourAngle < 0 {
hourAngle += 360
}
return hourAngle
}
func SaturnCulminationTime(jde, lon, timezone float64) float64 {
//jde 世界时,非力学时,当地时区 0时,无需转换力学时
func SaturnCulminationTime(localJD, lon, timezone float64) float64 {
// localJD 是本地民用日锚点(当地 0 时),不是力学时。
//ra,dec 瞬时天球座标,非J2000等时间天球坐标
jde = math.Floor(jde) + 0.5
estimateJD := jde + Limit360(360-SaturnHourAngle(jde, lon, timezone))/15.0/24.0*0.99726851851851851851
normalizedHourAngle := func(jde, lon, timezone float64) float64 {
currentHourAngle := SaturnHourAngle(jde, lon, timezone)
localJD = math.Floor(localJD) + 0.5
estimateJD := localJD + Limit360(360-SaturnHourAngle(localJD, lon, timezone))/15.0/24.0*0.99726851851851851851
normalizedHourAngle := func(localJD, lon, timezone float64) float64 {
currentHourAngle := SaturnHourAngle(localJD, lon, timezone)
if currentHourAngle < 180 {
currentHourAngle += 360
}