044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
55 lines
1.5 KiB
Go
55 lines
1.5 KiB
Go
package ephem
|
|
|
|
import (
|
|
"errors"
|
|
"reflect"
|
|
)
|
|
|
|
// Body NAIF 天体编号 / NAIF body code.
|
|
type Body int
|
|
|
|
const (
|
|
SSB Body = 0
|
|
Mercury Body = 1
|
|
Venus Body = 2
|
|
EMB Body = 3
|
|
Mars Body = 4
|
|
Jupiter Body = 5
|
|
Saturn Body = 6
|
|
Uranus Body = 7
|
|
Neptune Body = 8
|
|
Sun Body = 10
|
|
Moon Body = 301
|
|
Earth Body = 399
|
|
)
|
|
|
|
var (
|
|
// ErrOutOfRange 时刻超出星历覆盖 / epoch outside the ephemeris coverage.
|
|
ErrOutOfRange = errors.New("ephem: epoch outside coverage")
|
|
// ErrUnsupportedBody 星历不含该天体 / body not provided by the ephemeris.
|
|
ErrUnsupportedBody = errors.New("ephem: unsupported body")
|
|
// ErrNoEngine 实例未配置引擎 / instance has no engine.
|
|
ErrNoEngine = errors.New("ephem: instance has no engine")
|
|
// ErrUnsupportedApparent 引擎不支持视位置 / engine does not support apparent positions.
|
|
ErrUnsupportedApparent = errors.New("ephem: apparent positions are unsupported")
|
|
)
|
|
|
|
// Engine 几何星历:ICRF 赤道,km 与 km/日,时间 TDB;只读、可并发 / geometric ephemeris in ICRF, km and km/day, TDB.
|
|
type Engine interface {
|
|
State(target, center Body, jdTDB float64) (pos, vel [3]float64, err error)
|
|
Coverage(target Body) (start, end float64, ok bool)
|
|
}
|
|
|
|
// IsNilEngine 引擎为 nil 或持有 nil 指针等空值 / engine is nil or wraps a nil value.
|
|
func IsNilEngine(engine Engine) bool {
|
|
if engine == nil {
|
|
return true
|
|
}
|
|
value := reflect.ValueOf(engine)
|
|
switch value.Kind() {
|
|
case reflect.Ptr, reflect.Map, reflect.Slice, reflect.Func, reflect.Interface:
|
|
return value.IsNil()
|
|
}
|
|
return false
|
|
}
|