astro/jupiter/phenomena.go
starainrt 3ffdbe0034
feat: 扩展天文计算能力
- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息
- 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算
- 新增木星伽利略卫星位置、现象与接触事件计算
- 新增恒星星表、星座判定、自行修正与观测辅助能力
- 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包
- 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算
- 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试
- 重构基础算法文件组织,补充大量公开 API 注释和语义回归测试
- 更新中文和英文 README,补充示例、精度说明、SVG 配图
2026-05-01 22:38:44 +08:00

63 lines
2.4 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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 表示观测绝对时刻;内部使用该时刻对应的 TT/TDB 历元求值。
// date is the observing instant; internally the corresponding TT/TDB epoch is used.
func SatellitePhenomena(date time.Time) GalileanPhenomenaInfo {
jde := basic.Date2JDE(date.UTC())
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,
}
}