b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
111 lines
4.2 KiB
Go
111 lines
4.2 KiB
Go
package jupiter
|
|
|
|
import (
|
|
"time"
|
|
|
|
"b612.me/astro/basic"
|
|
)
|
|
|
|
// GalileanPhenomenonType 伽利略卫星现象类型 / Galilean-satellite phenomenon type.
|
|
type GalileanPhenomenonType string
|
|
|
|
const (
|
|
// GalileanPhenomenonTransit 凌日 / satellite transit across Jupiter.
|
|
GalileanPhenomenonTransit GalileanPhenomenonType = "transit"
|
|
// GalileanPhenomenonOccultation 掩蔽 / occultation behind Jupiter.
|
|
GalileanPhenomenonOccultation GalileanPhenomenonType = "occultation"
|
|
// GalileanPhenomenonEclipse 食 / eclipse in Jupiter's shadow.
|
|
GalileanPhenomenonEclipse GalileanPhenomenonType = "eclipse"
|
|
// GalileanPhenomenonShadowTransit 影凌 / shadow transit across Jupiter.
|
|
GalileanPhenomenonShadowTransit GalileanPhenomenonType = "shadow_transit"
|
|
)
|
|
|
|
const (
|
|
// GalileanSatelliteIo 木卫一 / Io.
|
|
GalileanSatelliteIo = 1
|
|
// GalileanSatelliteEuropa 木卫二 / Europa.
|
|
GalileanSatelliteEuropa = 2
|
|
// GalileanSatelliteGanymede 木卫三 / Ganymede.
|
|
GalileanSatelliteGanymede = 3
|
|
// GalileanSatelliteCallisto 木卫四 / Callisto.
|
|
GalileanSatelliteCallisto = 4
|
|
)
|
|
|
|
// GalileanPhenomenonEvent 伽利略卫星整场现象 / full Galilean-satellite event.
|
|
//
|
|
// Start、Greatest、End 都保持调用者输入的时区。
|
|
// GreatestState 是食甚/现象最深时刻对应的瞬时现象标志与影心偏移。
|
|
// 这里的 Start/End 基于零半径几何模型是否 active，不是 IMCCE 年表中的 D/F 接触时刻；
|
|
// 如果需要有限圆盘/有限影斑的接触窗口，请改用 `GalileanPhenomenonContactEvent`。
|
|
// Start, Greatest, and End preserve the caller's timezone.
|
|
// GreatestState contains the instantaneous phenomenon flags and shadow offsets at greatest event depth.
|
|
// Start/End here are based on whether the zero-radius geometric model is active, not the IMCCE D/F contact times.
|
|
// Use `GalileanPhenomenonContactEvent` when you need finite-disk or finite-shadow contact windows.
|
|
type GalileanPhenomenonEvent struct {
|
|
Valid bool
|
|
Satellite int
|
|
Type GalileanPhenomenonType
|
|
|
|
Start time.Time
|
|
Greatest time.Time
|
|
End time.Time
|
|
|
|
Duration time.Duration
|
|
GreatestState GalileanSatellitePhenomenon
|
|
}
|
|
|
|
// LastGalileanPhenomenonEvent 上一次伽利略卫星现象 / previous Galilean-satellite event.
|
|
func (module *Jupiter) LastGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
|
return galileanPhenomenonEventFromBasic(
|
|
basic.LastJupiterGalileanPhenomenonEventWithInstance(
|
|
basic.Date2JD(date.UTC()),
|
|
satellite,
|
|
basic.JupiterGalileanPhenomenonType(phenomenonType), module.inst,
|
|
),
|
|
date.Location(),
|
|
)
|
|
}
|
|
|
|
// NextGalileanPhenomenonEvent 下一次伽利略卫星现象 / next Galilean-satellite event.
|
|
func (module *Jupiter) NextGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
|
return galileanPhenomenonEventFromBasic(
|
|
basic.NextJupiterGalileanPhenomenonEventWithInstance(
|
|
basic.Date2JD(date.UTC()),
|
|
satellite,
|
|
basic.JupiterGalileanPhenomenonType(phenomenonType), module.inst,
|
|
),
|
|
date.Location(),
|
|
)
|
|
}
|
|
|
|
// ClosestGalileanPhenomenonEvent 最近一次伽利略卫星现象 / closest Galilean-satellite event.
|
|
func (module *Jupiter) ClosestGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
|
return galileanPhenomenonEventFromBasic(
|
|
basic.ClosestJupiterGalileanPhenomenonEventWithInstance(
|
|
basic.Date2JD(date.UTC()),
|
|
satellite,
|
|
basic.JupiterGalileanPhenomenonType(phenomenonType), module.inst,
|
|
),
|
|
date.Location(),
|
|
)
|
|
}
|
|
|
|
func galileanPhenomenonEventFromBasic(event basic.JupiterGalileanPhenomenonEvent, loc *time.Location) GalileanPhenomenonEvent {
|
|
if !event.Valid {
|
|
return GalileanPhenomenonEvent{}
|
|
}
|
|
start := basic.JD2DateByZone(event.Start, loc, false)
|
|
greatest := basic.JD2DateByZone(event.Greatest, loc, false)
|
|
end := basic.JD2DateByZone(event.End, loc, false)
|
|
return GalileanPhenomenonEvent{
|
|
Valid: true,
|
|
Satellite: event.Satellite,
|
|
Type: GalileanPhenomenonType(event.Type),
|
|
Start: start,
|
|
Greatest: greatest,
|
|
End: end,
|
|
Duration: end.Sub(start),
|
|
GreatestState: galileanPhenomenonFromBasic(event.GreatestPhenomenon),
|
|
}
|
|
}
|