Files
astro/basic/apparent_vector.go
T
b612 044f2f4381 feat: 引入可切换星历模型并扩展天象观测链路
- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算
- 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询
- 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出
- 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解
- 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤
- 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持
- 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理
- 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
2026-10-15 23:54:15 +08:00

78 lines
3.0 KiB
Go

package basic
import (
"math"
"b612.me/astro/internal/ephem"
)
// planetBody 旧模型行星序号 1..7(水星..海王星,不含地球)对应的 NAIF 编号。
var planetBody = [8]ephem.Body{0, ephem.Mercury, ephem.Venus, ephem.Mars, ephem.Jupiter, ephem.Saturn, ephem.Uranus, ephem.Neptune}
// vectorApparent 新模型全精度时的矢量视位置:真黄道经纬(度)、光行时(日)、几何地心距(AU);不适用时 ok=false。
// 状态非法时与显式实例路径一致:ok=true 且各值为 NaN,不得退回低精度公式掩盖错误。
func vectorApparent(target ephem.Body, jde float64, n int) (lo, bo, tau, distAU float64, ok bool) {
if n >= 0 || ephem.Active() != ephem.Semianalytic {
return 0, 0, 0, 0, false
}
lo, bo, tau, distAU, ok, err := apparentState(target, jde, ephem.Global())
if err != nil {
return math.NaN(), math.NaN(), math.NaN(), math.NaN(), true
}
return lo, bo, tau, distAU, ok
}
// icrfToTrueEcliptic ICRF 单位矢量 → 真黄道经纬(度);黄赤交角与下游 LoBoToRaDec 同口径,往返得到真赤道。
func icrfToTrueEcliptic(d [3]float64, jde float64) (lo, bo float64) {
m := ltpPBMAT(2000 + (jde-2451545)/365.25)
var q [3]float64
for i := range q {
q[i] = m[i][0]*d[0] + m[i][1]*d[1] + m[i][2]*d[2]
}
s, c := math.Sincos(Obliquity1980(jde) * math.Pi / 180)
x, y, z := q[0], q[1]*c+q[2]*s, -q[1]*s+q[2]*c
lo = math.Atan2(y, x)*180/math.Pi + Nutation2000Bi(jde)
bo = math.Atan2(z, math.Hypot(x, y)) * 180 / math.Pi
return math.Mod(lo+720, 360), bo
}
// sunApparentLoBoN 太阳视黄经与黄纬;有矢量视位置时两者取自同一方向,否则退回视黄经配几何黄纬。
func sunApparentLoBoN(jde float64, n int, inst *Instance) (float64, float64) {
if lo, bo, _, _, ok, err := vectorApparentWithInstance(ephem.Sun, jde, n, inst); err != nil {
return math.NaN(), math.NaN()
} else if ok {
return lo, bo
}
return HSunApparentLoNWithInstance(jde, n, inst), HSunTrueBoNWithInstance(jde, n, inst)
}
// moonApparentLoBoN 月球视黄经与黄纬;有矢量视位置时两者取自同一方向,否则退回视黄经配几何黄纬。
func moonApparentLoBoN(jde float64, n int, inst *Instance) (float64, float64) {
if lo, bo, _, _, ok, err := vectorApparentWithInstance(ephem.Moon, jde, n, inst); err != nil {
return math.NaN(), math.NaN()
} else if ok {
return lo, bo
}
return HMoonApparentLoNWithInstance(jde, n, inst), HMoonTrueBoNWithInstance(jde, n, inst)
}
func sunApparentRaDecN(jde float64, n int, inst *Instance) (float64, float64) {
lo, bo := sunApparentLoBoN(jde, n, inst)
return LoBoToRaDec(jde, lo, bo)
}
func sunApparentRaN(jde float64, n int, inst *Instance) float64 {
ra, _ := sunApparentRaDecN(jde, n, inst)
return ra
}
func moonApparentRaDecN(jde float64, n int, inst *Instance) (float64, float64) {
lo, bo := moonApparentLoBoN(jde, n, inst)
return LoBoToRaDec(jde, lo, bo)
}
func moonApparentRaN(jde float64, n int, inst *Instance) float64 {
ra, _ := moonApparentRaDecN(jde, n, inst)
return ra
}