Files
astro/basic/jupiter_physical.go
T
b612 044f2f4381 feat: 引入可切换星历模型并扩展天象观测链路
- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算
- 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询
- 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出
- 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解
- 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤
- 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持
- 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理
- 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
2026-10-15 23:54:15 +08:00

122 lines
4.8 KiB
Go

package basic
import (
"math"
. "b612.me/astro/tools"
)
type jupiterPhysicalObservationInfo struct {
DS float64
DE float64
SystemI float64
SystemII float64
}
// JupiterCentralMeridianInfo 木星中央经线 / Jupiter central meridians.
type JupiterCentralMeridianInfo struct {
// SystemI 木星 System I 照亮盘中央经线,单位度,西经为正。
SystemI float64
// SystemII 木星 System II 照亮盘中央经线,单位度,西经为正。
SystemII float64
// SystemIII 木星 System III 盘面中央经线,单位度,西经为正。
SystemIII float64
}
// JupiterCentralMeridians 木星 System I/II/III 中央经线 / Jupiter System I/II/III central meridians.
func JupiterCentralMeridians(jde float64) JupiterCentralMeridianInfo {
return JupiterCentralMeridiansN(jde, -1)
}
// JupiterCentralMeridiansNWithInstance 用指定星历实例求值;inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func JupiterCentralMeridiansNWithInstance(jde float64, n int, inst *Instance) JupiterCentralMeridianInfo {
observations := jupiterPhysicalObservationsN(jde, n, inst)
physical := JupiterPhysicalNWithInstance(jde, n, inst)
return JupiterCentralMeridianInfo{
SystemI: observations.SystemI,
SystemII: observations.SystemII,
SystemIII: physical.SubEarthLongitude,
}
}
// JupiterDSDE 木星 DS/DE 行星中心赤纬 / Jupiter planetocentric declinations of Sun and Earth.
func JupiterDSDE(jde float64) (ds, de float64) {
return JupiterDSDEN(jde, -1)
}
// JupiterDSDENWithInstance 用指定星历实例求值;inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func JupiterDSDENWithInstance(jde float64, n int, inst *Instance) (ds, de float64) {
observations := jupiterPhysicalObservationsN(jde, n, inst)
return observations.DS, observations.DE
}
func jupiterPhysicalObservationsN(jde float64, n int, instances ...*Instance) jupiterPhysicalObservationInfo {
inst := instanceValue(instances)
days := jde - 2433282.5
julianCentury := days / 36525.0
poleRA := (268.0 + 0.1061*julianCentury) * rad
poleDec := (64.5 - 0.0164*julianCentury) * rad
w1 := (17.71 + 877.90003539*days) * rad
w2 := (16.838 + 870.27003539*days) * rad
earthLon := PlanetCoordinateNWithInstance(-1, 0, jde, n, inst)
earthLat := PlanetCoordinateNWithInstance(-1, 1, jde, n, inst)
earthRadius := PlanetCoordinateNWithInstance(-1, 2, jde, n, inst)
delta := 4.0
var jupiterLon float64
var jupiterLat float64
var jupiterRadius float64
var x float64
var y float64
var z float64
for i := 0; i < 2; i++ {
lightTimeDays := astronomicalUnitLightTimeDays * delta
jupiterLon = PlanetCoordinateNWithInstance(4, 0, jde-lightTimeDays, n, inst)
jupiterLat = PlanetCoordinateNWithInstance(4, 1, jde-lightTimeDays, n, inst)
jupiterRadius = PlanetCoordinateNWithInstance(4, 2, jde-lightTimeDays, n, inst)
x = jupiterRadius*Cos(jupiterLat)*Cos(jupiterLon) - earthRadius*Cos(earthLat)*Cos(earthLon)
y = jupiterRadius*Cos(jupiterLat)*Sin(jupiterLon) - earthRadius*Cos(earthLat)*Sin(earthLon)
z = jupiterRadius*Sin(jupiterLat) - earthRadius*Sin(earthLat)
delta = math.Sqrt(x*x + y*y + z*z)
}
meanObliquity := EclipticObliquity(jde, false)
sinMeanObliquity, cosMeanObliquity := math.Sincos(meanObliquity)
sinJupiterLat, cosJupiterLat := math.Sincos(jupiterLat * rad)
sinJupiterLon, cosJupiterLon := math.Sincos(jupiterLon * rad)
alphaSun := math.Atan2(cosMeanObliquity*sinJupiterLon-sinMeanObliquity*sinJupiterLat/cosJupiterLat, cosJupiterLon)
deltaSun := math.Asin(cosMeanObliquity*sinJupiterLat + sinMeanObliquity*cosJupiterLat*sinJupiterLon)
u := y*Cos(meanObliquity) - z*Sin(meanObliquity)
v := y*Sin(meanObliquity) + z*Cos(meanObliquity)
alpha := math.Atan2(u, x)
deltaEarth := math.Atan2(v, math.Hypot(x, u))
sinPoleDec, cosPoleDec := math.Sincos(poleDec)
sinDeltaSun, cosDeltaSun := math.Sincos(deltaSun)
ds := math.Asin(-sinPoleDec*sinDeltaSun-cosPoleDec*cosDeltaSun*math.Cos(poleRA-alphaSun)) * deg
sinDeltaEarth, cosDeltaEarth := math.Sincos(deltaEarth)
sinPoleDeltaRA, cosPoleDeltaRA := math.Sincos(poleRA - alpha)
zeta := math.Atan2(
sinPoleDec*cosDeltaEarth*cosPoleDeltaRA-sinDeltaEarth*cosPoleDec,
cosDeltaEarth*sinPoleDeltaRA,
)
de := math.Asin(-sinPoleDec*sinDeltaEarth-cosPoleDec*cosDeltaEarth*math.Cos(poleRA-alpha)) * deg
systemI := w1 - zeta - 5.07033*rad*delta
systemII := w2 - zeta - 5.02626*rad*delta
phaseCorrection := (2*jupiterRadius*delta + earthRadius*earthRadius - jupiterRadius*jupiterRadius - delta*delta) / (4 * jupiterRadius * delta)
if Sin(jupiterLon-earthLon) < 0 {
phaseCorrection = -phaseCorrection
}
return jupiterPhysicalObservationInfo{
DS: ds,
DE: de,
SystemI: Limit360((systemI + phaseCorrection) * deg),
SystemII: Limit360((systemII + phaseCorrection) * deg),
}
}