Files
astro/jupiter/phenomena.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

60 lines
2.3 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.
func (module *Jupiter) SatellitePhenomena(date time.Time) GalileanPhenomenaInfo {
jde := basic.UTC2TT(basic.Date2JD(date.UTC()))
phenomena := basic.JupiterGalileanSatellitePhenomenaWithInstance(jde, module.inst)
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,
}
}