b612
16c62a97d5
- 新增时标、ΔT 模型、质心时间与 UT1 支持 - 改进日月食、月掩、行星事件及路径边界计算 - 完善恒星三维自行与动态距离传播 - 扩展 SVG、GeoJSON、KML 输出与底层距离换算工具 - 整理中英文手册、示例资源及回归测试
116 lines
4.4 KiB
Go
116 lines
4.4 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.
|
||
//
|
||
// date 表示查询绝对时刻；satellite 取 `1=Io, 2=Europa, 3=Ganymede, 4=Callisto`；
|
||
// phenomenonType 取 `transit/occultation/eclipse/shadow_transit` 中之一。
|
||
// date is the query instant; satellite is `1=Io, 2=Europa, 3=Ganymede, 4=Callisto`;
|
||
// phenomenonType is one of `transit/occultation/eclipse/shadow_transit`.
|
||
func LastGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return galileanPhenomenonEventFromBasic(
|
||
basic.LastJupiterGalileanPhenomenonEvent(
|
||
basic.Date2JD(date.UTC()),
|
||
satellite,
|
||
basic.JupiterGalileanPhenomenonType(phenomenonType),
|
||
),
|
||
date.Location(),
|
||
)
|
||
}
|
||
|
||
// NextGalileanPhenomenonEvent 下一次伽利略卫星现象 / next Galilean-satellite event.
|
||
func NextGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return galileanPhenomenonEventFromBasic(
|
||
basic.NextJupiterGalileanPhenomenonEvent(
|
||
basic.Date2JD(date.UTC()),
|
||
satellite,
|
||
basic.JupiterGalileanPhenomenonType(phenomenonType),
|
||
),
|
||
date.Location(),
|
||
)
|
||
}
|
||
|
||
// ClosestGalileanPhenomenonEvent 最近一次伽利略卫星现象 / closest Galilean-satellite event.
|
||
func ClosestGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return galileanPhenomenonEventFromBasic(
|
||
basic.ClosestJupiterGalileanPhenomenonEvent(
|
||
basic.Date2JD(date.UTC()),
|
||
satellite,
|
||
basic.JupiterGalileanPhenomenonType(phenomenonType),
|
||
),
|
||
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),
|
||
}
|
||
}
|