feat: 引入可切换星历模型并扩展天象观测链路

- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算
- 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询
- 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出
- 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解
- 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤
- 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持
- 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理
- 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
This commit is contained in:
2026-10-15 23:54:15 +08:00
parent 16c62a97d5
commit 044f2f4381
674 changed files with 62983 additions and 8396 deletions
+33
View File
@@ -0,0 +1,33 @@
package basic
import (
"time"
)
// TimeScale 导出时间标签的时标,零值为民用 UTC / output-label time scale, defaulting to civil UTC.
type TimeScale int
const (
// TimeScaleUTC 默认民用时标 / default civil time scale.
TimeScaleUTC TimeScale = iota
// TimeScaleUT1 UT1 读数,输出 Location 须为 nil 或 UTC / UT1 reading; output Location must be nil or UTC.
TimeScaleUT1
)
// LabelIn 把民用时刻换成该时标下的时刻值 / converts a civil instant to a value in one scale.
func LabelIn(scale TimeScale, date time.Time) time.Time {
if scale == TimeScaleUT1 {
return UT1FromUTC(date)
}
return date
}
// UT1FromUTC 民用时刻转 UT1 读数,以 UTC Location 承载 / converts a civil instant to a UT1 reading in a UTC Location.
func UT1FromUTC(date time.Time) time.Time {
return JD2DateByZone(UTC2UT1(Date2JD(date.UTC())), time.UTC, false)
}
// DUT1 返回民用时刻的 UT1−UTC,单位秒 / UT1−UTC in seconds.
func DUT1(date time.Time) float64 {
return DUT1Seconds(Date2JD(date.UTC()))
}