Files
astro/jupiter/phenomena.go
T
b612 2bf8478639 feat: 完善日月食与月掩几何链路并扩展历法接口
- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算,支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径,补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出,支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推,补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存,降低重复计算开销并提升边界稳定
2026-09-17 12:27:40 +08:00

63 lines
2.5 KiB
Go

package jupiter
import (
"time"
"b612.me/astro/basic"
)
// GalileanSatellitePhenomenon 木星伽利略卫星瞬时现象 / instantaneous Galilean-satellite phenomena.
//
// Transit 为凌日,Occultation 为掩蔽,Eclipse 为进入木星本影,ShadowTransit 为卫星影子落在可见木星盘面上。
// ShadowOffset* 仅在 ShadowTransit 为 true 时有意义。
// Transit means a transit across Jupiter's disk, Occultation means hidden behind Jupiter, Eclipse means inside Jupiter's umbra, and ShadowTransit means the shadow falls on the visible Jovian disk.
// ShadowOffset* are meaningful only when ShadowTransit is true.
type GalileanSatellitePhenomenon struct {
Transit bool
Occultation bool
Eclipse bool
ShadowTransit bool
ShadowOffsetXArcsec float64
ShadowOffsetYArcsec float64
ShadowOffsetXJupiterR float64
ShadowOffsetYJupiterR float64
}
// GalileanPhenomenaInfo 四颗伽利略卫星瞬时现象 / instantaneous phenomena of the four Galilean satellites.
type GalileanPhenomenaInfo struct {
Io GalileanSatellitePhenomenon
Europa GalileanSatellitePhenomenon
Ganymede GalileanSatellitePhenomenon
Callisto GalileanSatellitePhenomenon
}
// SatellitePhenomena 木星四颗伽利略卫星瞬时现象 / instantaneous phenomena of Jupiter's four Galilean satellites.
//
// date 表示观测绝对时刻(UTC),内部换算为该时刻对应的 TT/TDB 历元求值。
// date is the observing instant in UTC; it is converted to the corresponding TT/TDB epoch for evaluation.
func SatellitePhenomena(date time.Time) GalileanPhenomenaInfo {
jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
phenomena := basic.JupiterGalileanSatellitePhenomena(jde)
return GalileanPhenomenaInfo{
Io: galileanPhenomenonFromBasic(phenomena[0]),
Europa: galileanPhenomenonFromBasic(phenomena[1]),
Ganymede: galileanPhenomenonFromBasic(phenomena[2]),
Callisto: galileanPhenomenonFromBasic(phenomena[3]),
}
}
func galileanPhenomenonFromBasic(phenomenon basic.JupiterGalileanPhenomenon) GalileanSatellitePhenomenon {
return GalileanSatellitePhenomenon{
Transit: phenomenon.Transit,
Occultation: phenomenon.Occultation,
Eclipse: phenomenon.Eclipse,
ShadowTransit: phenomenon.ShadowTransit,
ShadowOffsetXArcsec: phenomenon.ShadowOffsetXArcsec,
ShadowOffsetYArcsec: phenomenon.ShadowOffsetYArcsec,
ShadowOffsetXJupiterR: phenomenon.ShadowOffsetXJupiterRadii,
ShadowOffsetYJupiterR: phenomenon.ShadowOffsetYJupiterRadii,
}
}