b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
95 lines
5.1 KiB
Go
95 lines
5.1 KiB
Go
// Package astro 提供高层星历上下文、模型切换与进程级时标配置 / high-level ephemeris contexts, model switching and process-wide time-scale configuration.
|
||
package astro
|
||
|
||
import "b612.me/astro/basic"
|
||
|
||
// DeltaT 返回当前的 TT−UT1（ΔT）模型 / the active TT−UT1 (DeltaT) model.
|
||
func DeltaT() func(float64, bool) float64 {
|
||
return basic.GetDeltaTFn()
|
||
}
|
||
|
||
// SetDeltaT 替换 ΔT 模型（入参为数值与“该数值是否为儒略日”，为假时是十进制年），传 nil 恢复默认 / replaces the DeltaT model; nil restores the default.
|
||
func SetDeltaT(deltaT func(float64, bool) float64) {
|
||
basic.SetDeltaTFn(deltaT)
|
||
}
|
||
|
||
// DefaultDeltaT 返回内置默认 ΔT 模型 / the built-in default DeltaT model.
|
||
func DefaultDeltaT() func(float64, bool) float64 {
|
||
return basic.DefaultDeltaTv2
|
||
}
|
||
|
||
// TTMinusUTC 返回当前 TT−UTC 覆盖函数，未设置时为 nil / current TT−UTC override, or nil.
|
||
func TTMinusUTC() func(float64) float64 {
|
||
return basic.GetTTMinusUTCFn()
|
||
}
|
||
|
||
// SetTTMinusUTC 替换 TT−UTC 模型，nil 恢复内置表与政策 / overrides TT−UTC; nil restores the built-in table and policy.
|
||
func SetTTMinusUTC(ttMinusUTC func(float64) float64) {
|
||
basic.SetTTMinusUTCFn(ttMinusUTC)
|
||
}
|
||
|
||
// DefaultTTMinusUTC 返回内置闰秒表模型，忽略覆盖与未来政策 / built-in leap-table model, ignoring overrides and future policy.
|
||
func DefaultTTMinusUTC() func(float64) float64 {
|
||
return basic.TTMinusUTCSecondsDefault
|
||
}
|
||
|
||
// TimeScaleFuturePolicy 民用时标换算政策，零值为闰时，与输出用的 TimeScale 无关 / civil-time conversion policy, leap hour as the zero value; separate from output TimeScale.
|
||
type TimeScaleFuturePolicy = basic.TimeScaleFuturePolicy
|
||
|
||
const (
|
||
// TimeScaleLeapHour 按 ΔT 越限施加整小时校正（2027 起 CGPM 决议） / applies hour-sized corrections as adopted by CGPM from 2027.
|
||
TimeScaleLeapHour = basic.TimeScaleLeapHour
|
||
// TimeScaleLeapSecond 按 ΔT 越限施加整数秒校正（1972–2026 确定值） / integer-second corrections (definitive 1972–2026).
|
||
TimeScaleLeapSecond = basic.TimeScaleLeapSecond
|
||
// TimeScaleAssumeUT1Tracking 窗口外固定末端 DUT1，平滑跟随 UT1 / holds the last observed DUT1 beyond the window.
|
||
TimeScaleAssumeUT1Tracking = basic.TimeScaleAssumeUT1Tracking
|
||
// TimeScaleFreezeUTCOffset 窗口外固定末端 TT−UTC / holds the last TT−UTC offset beyond the window.
|
||
TimeScaleFreezeUTCOffset = basic.TimeScaleFreezeUTCOffset
|
||
// TimeScaleUT1Civil 全时轴民用时标等同 UT1，TT−UTC 覆盖仍优先 / uses UT1 as civil time everywhere unless TT−UTC is overridden.
|
||
TimeScaleUT1Civil = basic.TimeScaleUT1Civil
|
||
)
|
||
|
||
// SetTimeScaleFuturePolicy 设置与 basic 共享的民用时标换算政策 / sets the civil-time conversion policy shared with basic.
|
||
func SetTimeScaleFuturePolicy(policy TimeScaleFuturePolicy) {
|
||
basic.SetTimeScaleFuturePolicy(policy)
|
||
}
|
||
|
||
// GetTimeScaleFuturePolicy 返回当前民用时标换算政策 / current civil-time conversion policy.
|
||
func GetTimeScaleFuturePolicy() TimeScaleFuturePolicy {
|
||
return basic.GetTimeScaleFuturePolicy()
|
||
}
|
||
|
||
// DeltaTModel 标识可选的已发布 ΔT 模型 / a selectable published ΔT model.
|
||
type DeltaTModel = basic.DeltaTModel
|
||
|
||
const (
|
||
// DeltaTModelDefault 内置默认：SMH2016 + Morrison 2021 / the built-in SMH2016 + Morrison 2021 model.
|
||
DeltaTModelDefault = basic.DeltaTModelDefault
|
||
// DeltaTModelSMH2016 显式选择内置模型 / selects the built-in model explicitly.
|
||
DeltaTModelSMH2016 = basic.DeltaTModelSMH2016
|
||
// DeltaTModelMS2004 Morrison & Stephenson 2004 长期抛物线 / the M&S2004 long-term parabola.
|
||
DeltaTModelMS2004 = basic.DeltaTModelMS2004
|
||
// DeltaTModelEspenakMeeus2006 Espenak & Meeus 2006 分段多项式 / the Espenak & Meeus 2006 piecewise polynomial.
|
||
DeltaTModelEspenakMeeus2006 = basic.DeltaTModelEspenakMeeus2006
|
||
// DeltaTModelNASACanon2006 上式再加配对修正 c，即 NASA 五千年目录的印刷口径 / plus the pairing term c, the NASA canon convention.
|
||
DeltaTModelNASACanon2006 = basic.DeltaTModelNASACanon2006
|
||
// DeltaTModelManual 表示当前生效的是 SetDeltaT 注入的任意函数 / an arbitrary function injected with SetDeltaT.
|
||
DeltaTModelManual = basic.DeltaTModelManual
|
||
)
|
||
|
||
// SetDeltaTModel 安装命名 ΔT 模型；keepObserved 为真时逐月实测段优先（推荐），未知模型返回 false 且不改动现状。
|
||
// SetDeltaTModel installs a named ΔT model; with keepObserved the monthly observed span wins wherever it covers the instant.
|
||
func SetDeltaTModel(model DeltaTModel, keepObserved bool) bool {
|
||
return basic.SetDeltaTModel(model, keepObserved)
|
||
}
|
||
|
||
// GetDeltaTModel 返回当前生效的模型与是否保留实测段 / the active model and whether the observed span is kept.
|
||
func GetDeltaTModel() (DeltaTModel, bool) {
|
||
return basic.GetDeltaTModel()
|
||
}
|
||
|
||
// DeltaTModelSeconds 按命名模型求 ΔT（秒，入参为 UT 儒略日），不改变进程状态，便于对照 / evaluates a named model without touching process state.
|
||
func DeltaTModelSeconds(model DeltaTModel, jd float64, keepObserved bool) float64 {
|
||
return basic.DeltaTModelSeconds(model, jd, keepObserved)
|
||
}
|