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
+63 -63
View File
@@ -7,79 +7,79 @@ import (
. "b612.me/astro/tools"
)
func VenusL(jd float64) float64 {
return planet.WherePlanet(2, 0, jd)
func VenusL(jde float64) float64 {
return planet.WherePlanet(2, 0, jde)
}
func VenusB(jd float64) float64 {
return planet.WherePlanet(2, 1, jd)
func VenusB(jde float64) float64 {
return planet.WherePlanet(2, 1, jde)
}
func VenusR(jd float64) float64 {
return planet.WherePlanet(2, 2, jd)
func VenusR(jde float64) float64 {
return planet.WherePlanet(2, 2, jde)
}
func AVenusX(jd float64) float64 {
l := VenusL(jd)
b := VenusB(jd)
r := VenusR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func AVenusX(jde float64) float64 {
l := VenusL(jde)
b := VenusB(jde)
r := VenusR(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 AVenusY(jd float64) float64 {
func AVenusY(jde float64) float64 {
l := VenusL(jd)
b := VenusB(jd)
r := VenusR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
l := VenusL(jde)
b := VenusB(jde)
r := VenusR(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 AVenusZ(jd float64) float64 {
//l := VenusL(jd)
b := VenusB(jd)
r := VenusR(jd)
// el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func AVenusZ(jde float64) float64 {
//l := VenusL(jde)
b := VenusB(jde)
r := VenusR(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 AVenusXYZ(jd float64) (float64, float64, float64) {
l := VenusL(jd)
b := VenusB(jd)
r := VenusR(jd)
el := planet.WherePlanet(-1, 0, jd)
eb := planet.WherePlanet(-1, 1, jd)
er := planet.WherePlanet(-1, 2, jd)
func AVenusXYZ(jde float64) (float64, float64, float64) {
l := VenusL(jde)
b := VenusB(jde)
r := VenusR(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 VenusApparentRa(jd float64) float64 {
lo, bo := VenusApparentLoBo(jd)
eps := TrueObliquity(jd)
func VenusApparentRa(jde float64) float64 {
lo, bo := VenusApparentLoBo(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 VenusApparentDec(jd float64) float64 {
lo, bo := VenusApparentLoBo(jd)
eps := TrueObliquity(jd)
func VenusApparentDec(jde float64) float64 {
lo, bo := VenusApparentLoBo(jde)
eps := TrueObliquity(jde)
dec := ArcSin(Sin(bo)*Cos(eps) + Cos(bo)*Sin(eps)*Sin(lo))
return dec
}
func VenusApparentRaDec(jd float64) (float64, float64) {
lo, bo := VenusApparentLoBo(jd)
eps := TrueObliquity(jd)
func VenusApparentRaDec(jde float64) (float64, float64) {
lo, bo := VenusApparentLoBo(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,22 +105,22 @@ func VenusApparentLoBo(jd float64) (float64, float64) {
return geo.lo, geo.bo
}
func VenusMag(jd float64) float64 {
sunDistance := VenusR(jd)
earthDistance := EarthVenusAway(jd)
earthSunDistance := planet.WherePlanet(-1, 2, jd)
func VenusMag(jde float64) float64 {
sunDistance := VenusR(jde)
earthDistance := EarthVenusAway(jde)
earthSunDistance := planet.WherePlanet(-1, 2, jde)
i := (sunDistance*sunDistance + earthDistance*earthDistance - earthSunDistance*earthSunDistance) / (2 * sunDistance * earthDistance)
i = ArcCos(i)
mag := -4.40 + 5*math.Log10(sunDistance*earthDistance) + 0.0009*i + 0.000239*i*i - 0.00000065*i*i*i
return FloatRound(mag, 2)
}
func VenusHeight(jde, lon, lat, timezone float64) float64 {
func VenusHeight(localJD, lon, lat, timezone float64) float64 {
// 转换为世界时
utcJde := jde - timezone/24.0
utcJD := localJD - timezone/24.0
// 计算视恒星时
ra, dec := VenusApparentRaDec(TD2UT(utcJde, true))
st := Limit360(ApparentSiderealTime(utcJde)*15 + lon)
ra, dec := VenusApparentRaDec(UTC2TT(utcJD))
st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
// 计算时角
hourAngle := Limit360(st - ra)
// 高度角、时角与天球座标三角转换公式
@@ -129,12 +129,12 @@ func VenusHeight(jde, lon, lat, timezone float64) float64 {
return ArcSin(sinHeight)
}
func VenusAzimuth(jde, lon, lat, timezone float64) float64 {
func VenusAzimuth(localJD, lon, lat, timezone float64) float64 {
// 转换为世界时
utcJde := jde - timezone/24.0
utcJD := localJD - timezone/24.0
// 计算视恒星时
ra, dec := VenusApparentRaDec(TD2UT(utcJde, true))
st := Limit360(ApparentSiderealTime(utcJde)*15 + lon)
ra, dec := VenusApparentRaDec(UTC2TT(utcJD))
st := Limit360(ApparentSiderealTime(UTC2UT1(utcJD))*15 + lon)
// 计算时角
hourAngle := Limit360(st - ra)
// 三角转换公式
@@ -153,21 +153,21 @@ func VenusAzimuth(jde, lon, lat, timezone float64) float64 {
}
func VenusHourAngle(jd, lon, tz float64) float64 {
startime := Limit360(ApparentSiderealTime(jd-tz/24)*15 + lon)
timeangle := startime - VenusApparentRa(TD2UT(jd-tz/24.0, true))
startime := Limit360(ApparentSiderealTime(UTC2UT1(jd-tz/24))*15 + lon)
timeangle := startime - VenusApparentRa(UTC2TT(jd-tz/24.0))
if timeangle < 0 {
timeangle += 360
}
return timeangle
}
func VenusCulminationTime(jde, lon, timezone float64) float64 {
//jde 世界时,非力学时,当地时区 0时,无需转换力学时
func VenusCulminationTime(localJD, lon, timezone float64) float64 {
// localJD 是本地民用日锚点(当地 0 时),不是力学时。
//ra,dec 瞬时天球座标,非J2000等时间天球坐标
jde = math.Floor(jde) + 0.5
estimateJD := jde + Limit360(360-VenusHourAngle(jde, lon, timezone))/15.0/24.0*0.99726851851851851851
limitHA := func(jde, lon, timezone float64) float64 {
ha := VenusHourAngle(jde, lon, timezone)
localJD = math.Floor(localJD) + 0.5
estimateJD := localJD + Limit360(360-VenusHourAngle(localJD, lon, timezone))/15.0/24.0*0.99726851851851851851
limitHA := func(localJD, lon, timezone float64) float64 {
ha := VenusHourAngle(localJD, lon, timezone)
if ha < 180 {
ha += 360
}