b612/astro
1
1
Fork 0
Code Issues Pull Requests Projects Releases 22 Wiki Activity

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

Browse Source 
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 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
Download Patch File Download Diff File Expand all files Collapse all files
basic/planet_physical.go
+28 -27
View File
@@ -3,7 +3,6 @@ package basic
import (
"math"
"b612.me/astro/planet"
. "b612.me/astro/tools"
)
@@ -94,9 +93,9 @@ func MercuryPhysical(jd float64) PlanetPhysicalInfo {
return MercuryPhysicalN(jd, -1)
}
// MercuryPhysicalN 水星物理观测参数（截断版） / truncated physical observing parameters of Mercury.
func MercuryPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, mercuryPhysicalModel)
// MercuryPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func MercuryPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, mercuryPhysicalModel, inst)
}
// VenusPhysical 金星物理观测参数 / physical observing parameters of Venus.
@@ -104,9 +103,9 @@ func VenusPhysical(jd float64) PlanetPhysicalInfo {
return VenusPhysicalN(jd, -1)
}
// VenusPhysicalN 金星物理观测参数（截断版） / truncated physical observing parameters of Venus.
func VenusPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, venusPhysicalModel)
// VenusPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func VenusPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, venusPhysicalModel, inst)
}
// MarsPhysical 火星物理观测参数 / physical observing parameters of Mars.
@@ -114,9 +113,9 @@ func MarsPhysical(jd float64) PlanetPhysicalInfo {
return MarsPhysicalN(jd, -1)
}
// MarsPhysicalN 火星物理观测参数（截断版） / truncated physical observing parameters of Mars.
func MarsPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, marsPhysicalModel)
// MarsPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func MarsPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, marsPhysicalModel, inst)
}
// JupiterPhysical 木星物理观测参数 / physical observing parameters of Jupiter.
@@ -124,9 +123,9 @@ func JupiterPhysical(jd float64) PlanetPhysicalInfo {
return JupiterPhysicalN(jd, -1)
}
// JupiterPhysicalN 木星物理观测参数（截断版） / truncated physical observing parameters of Jupiter.
func JupiterPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, jupiterPhysicalModel)
// JupiterPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func JupiterPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, jupiterPhysicalModel, inst)
}
// SaturnPhysical 土星物理观测参数 / physical observing parameters of Saturn.
@@ -134,9 +133,9 @@ func SaturnPhysical(jd float64) PlanetPhysicalInfo {
return SaturnPhysicalN(jd, -1)
}
// SaturnPhysicalN 土星物理观测参数（截断版） / truncated physical observing parameters of Saturn.
func SaturnPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, saturnPhysicalModel)
// SaturnPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func SaturnPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, saturnPhysicalModel, inst)
}
// UranusPhysical 天王星物理观测参数 / physical observing parameters of Uranus.
@@ -144,9 +143,9 @@ func UranusPhysical(jd float64) PlanetPhysicalInfo {
return UranusPhysicalN(jd, -1)
}
// UranusPhysicalN 天王星物理观测参数（截断版） / truncated physical observing parameters of Uranus.
func UranusPhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, uranusPhysicalModel)
// UranusPhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func UranusPhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, uranusPhysicalModel, inst)
}
// NeptunePhysical 海王星物理观测参数 / physical observing parameters of Neptune.
@@ -154,23 +153,25 @@ func NeptunePhysical(jd float64) PlanetPhysicalInfo {
return NeptunePhysicalN(jd, -1)
}
// NeptunePhysicalN 海王星物理观测参数（截断版） / truncated physical observing parameters of Neptune.
func NeptunePhysicalN(jd float64, n int) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, neptunePhysicalModel)
// NeptunePhysicalNWithInstance 用指定星历实例求值；inst 为 nil 时用进程当前模型 / evaluation with an explicit instance; nil uses the process model.
func NeptunePhysicalNWithInstance(jd float64, n int, inst *Instance) PlanetPhysicalInfo {
return planetPhysicalN(jd, n, neptunePhysicalModel, inst)
}
func planetPhysicalN(jd float64, n int, model planetPhysicalModel) PlanetPhysicalInfo {
initialX, initialY, initialZ := planetXYZN(model.planetIndex, jd, n)
func planetPhysicalN(jd float64, n int, model planetPhysicalModel, instances ...*Instance) PlanetPhysicalInfo {
inst := instanceValue(instances)
initialX, initialY, initialZ := planetXYZN(model.planetIndex, jd, n, inst)
targetVector := Vector3{initialX, initialY, initialZ}
lightTimeDays := astronomicalUnitLightTimeDays * vectorMagnitude(targetVector)
targetJDE := jd - lightTimeDays
geoX, geoY, geoZ := planetXYZN(model.planetIndex, targetJDE, n)
geoX, geoY, geoZ := planetXYZN(model.planetIndex, targetJDE, n, inst)
geocentricVector := Vector3{geoX, geoY, geoZ}
observerDirection := normalizeVector(Vector3{-geocentricVector[0], -geocentricVector[1], -geocentricVector[2]})
heliocentricLongitude := planet.WherePlanetN(model.planetIndex, 0, targetJDE, n)
heliocentricLatitude := planet.WherePlanetN(model.planetIndex, 1, targetJDE, n)
heliocentricLongitude := PlanetCoordinateNWithInstance(model.planetIndex, 0, targetJDE, n, inst)
heliocentricLatitude := PlanetCoordinateNWithInstance(model.planetIndex, 1, targetJDE, n, inst)
solarDirection := normalizeVector(eclipticCartesian(heliocentricLongitude+180, -heliocentricLatitude, 1))
obliquity := EclipticObliquity(targetJDE, false)