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
+11 -5
View File
@@ -1,11 +1,12 @@
package planet
import (
"b612.me/astro/internal/ephem"
. "b612.me/astro/tools"
"math"
)
// WherePlanet 天体 xt 在儒略日 jde 的 VSOP 结果 / VSOP result for body xt at Julian day jde.
// WherePlanet 天体 xt 在儒略日 jde 的历元平黄道几何量,按当前星历模型求值 / geometric position of body xt of date under the active ephemeris model.
//
// xt 取 -1 或 0..7:0 为地球,1..7 依次为水星、金星、火星、木星、土星、天王星、海王星;-1 表示地球,zn 取 0 时给日心黄经。
// zn 取 0 黄经、1 黄纬、2 日心距(AU);xt 或 zn 越界返回 NaN 而不 panic。
@@ -15,14 +16,19 @@ func WherePlanet(xt, zn int, jde float64) float64 {
return WherePlanetN(xt, zn, jde, -1)
}
// WherePlanetN 同 WherePlanet 的截断版 / truncated form of WherePlanet.
//
// n < 0 时使用全部项;否则保留约 n 个主项并按比例缩短高阶项。取值域与越界行为同 WherePlanet。
// When n < 0 all terms are used; otherwise roughly n principal terms are kept and higher orders scaled proportionally. Domain and out-of-range behavior match WherePlanet.
// WherePlanetN WherePlanet 的 n 变体;n < 0 取完整级数,半解析模型下 n >= 0 用快速表,Legacy 按 n 截断 / n-parameterised WherePlanet.
func WherePlanetN(xt, zn int, jde float64, n int) float64 {
return WherePlanetModelN(ephem.Active(), xt, zn, jde, n)
}
// WherePlanetModelN 按指定模型计算行星几何量 / evaluate planetary geometry with an explicit model.
func WherePlanetModelN(model ephem.Model, xt, zn int, jde float64, n int) float64 {
if xt < -1 || xt > 7 || zn < 0 || zn > 2 {
return math.NaN()
}
if model == ephem.Semianalytic {
return semiPlanet(xt, zn, jde, n)
}
sata := 0
if xt == -1 {