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
+6 -6
View File
@@ -3,6 +3,8 @@ package basic
import (
"math"
"time"
"b612.me/astro/internal/geodata"
)
const (
@@ -26,8 +28,6 @@ const (
occultationRiseSetEvaluationCacheMaximumEntries = 16384
occultationRiseSetTimeEpsilonDays = 1e-8
occultationRiseSetTargetSpacingKM = 100.0
occultationTopocentricEarthRadiusKM = 6378.14
occultationTopocentricEarthPolarRadiusKM = 6356.755
)
// 站心赤经赤纬的历史公式使用固定地平视差常数;保留该尺度可使向量算法与既有结果数值等价。
@@ -372,7 +372,7 @@ func (context occultationRiseSetContext) moonHorizonResidual(longitude, latitude
sinTheta, cosTheta := math.Sincos(theta)
moonDotZenith := cosLatitude*(context.moon.positionKM.x*cosTheta+context.moon.positionKM.y*sinTheta) +
context.moon.positionKM.z*sinLatitude
polarRatio := occultationTopocentricEarthPolarRadiusKM / occultationTopocentricEarthRadiusKM
polarRatio := topocentricEarthPolarRadiusKM / topocentricEarthRadiusKM
shapeDotZenith := math.Sqrt(cosLatitude*cosLatitude + polarRatio*polarRatio*sinLatitude*sinLatitude)
residual := moonDotZenith - occultationLegacyParallaxRadiusKM*shapeDotZenith
return residual, finite(residual)
@@ -385,7 +385,7 @@ func occultationRiseSetObserverVectors(
theta := (siderealDegrees + longitude) * rad
sinLatitude, cosLatitude := math.Sincos(latitudeRad)
sinTheta, cosTheta := math.Sincos(theta)
polarRatio := occultationTopocentricEarthPolarRadiusKM / occultationTopocentricEarthRadiusKM
polarRatio := topocentricEarthPolarRadiusKM / topocentricEarthRadiusKM
u := math.Atan(polarRatio * math.Tan(latitudeRad))
sinU, cosU := math.Sincos(u)
shape := occultationPathVector{
@@ -395,7 +395,7 @@ func occultationRiseSetObserverVectors(
}
zenith := occultationPathVector{x: cosLatitude * cosTheta, y: cosLatitude * sinTheta, z: sinLatitude}
return occultationPathScale(shape, occultationLegacyParallaxRadiusKM),
occultationPathScale(shape, occultationTopocentricEarthRadiusKM), zenith
occultationPathScale(shape, topocentricEarthRadiusKM), zenith
}
func occultationRiseSetTopocentricDirection(
@@ -636,7 +636,7 @@ func (evaluation occultationRiseSetEvaluation) pointsAt(
return result
}
gst := ApparentSiderealTime(TT2UT1(evaluation.tt)) * 15
centerLongitude := normalizeLongitude(evaluation.center.moonRA - gst)
centerLongitude := geodata.NormalizeLongitude(evaluation.center.moonRA - gst)
centerLatitude := evaluation.center.moonDec
appendRoots := func(greatest bool) {
// Keep the historical geographic refinement for ordinary latitudes; it