feat: 引入可切换星历模型并扩展天象观测链路
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
This commit is contained in:
+120
-44
@@ -5,6 +5,9 @@ import "math"
|
||||
func GetMoonLoops(year float64, loop int) []float64 {
|
||||
var start float64
|
||||
var newMoon, lastNewMoon float64
|
||||
if loop <= 0 {
|
||||
return nil
|
||||
}
|
||||
moonLoops := make([]float64, loop)
|
||||
if year < 6000 {
|
||||
start = year + 11.00/12.00 + 5.00/30.00/12.00
|
||||
@@ -12,7 +15,10 @@ func GetMoonLoops(year float64, loop int) []float64 {
|
||||
start = year + 9.00/12.00 + 5.00/30.00/12.00
|
||||
}
|
||||
i := 1
|
||||
for j := 0; j < loop; j++ {
|
||||
// 重复朔只跳过、不计入，最多容忍与 loop 同量级的重试。
|
||||
maxAttempts := 2*loop + 4
|
||||
j := 0
|
||||
for ; j < loop && i <= maxAttempts; j++ {
|
||||
if year > 3000 {
|
||||
newMoon = TT2UTC(CalcMoonSH(start+float64(i-1)/12.5, 0) + 8.0/24.0)
|
||||
} else {
|
||||
@@ -29,7 +35,7 @@ func GetMoonLoops(year float64, loop int) []float64 {
|
||||
lastNewMoon = moonLoops[j]
|
||||
i++
|
||||
}
|
||||
return moonLoops
|
||||
return moonLoops[:j]
|
||||
}
|
||||
|
||||
// GetJieqiLoops 返回从该年冬至起连续 loop 个节气时刻（北京时间，按 15° 一步）：
|
||||
@@ -55,55 +61,55 @@ func GetJieqiLoops(year, loop int) []float64 {
|
||||
}
|
||||
|
||||
func GetJQTime(year, angle int) float64 {
|
||||
// Calculate initial day based on angle parity
|
||||
var initialDay float64
|
||||
if angle%2 == 0 {
|
||||
initialDay = 18
|
||||
} else {
|
||||
initialDay = 3
|
||||
}
|
||||
|
||||
// Calculate temporary factor for month offset
|
||||
var tempFactor float64
|
||||
if angle%10 != 0 {
|
||||
tempFactor = float64(angle+15) / 30.0
|
||||
} else {
|
||||
tempFactor = float64(angle) / 30.0
|
||||
}
|
||||
|
||||
// Calculate initial month, adjusting if超过 12
|
||||
initialMonth := 3.0 + tempFactor
|
||||
if initialMonth > 12.0 {
|
||||
initialMonth -= 12.0
|
||||
}
|
||||
|
||||
// Calculate initial Julian date
|
||||
initialJD := JDCalc(year, int(initialMonth), initialDay)
|
||||
|
||||
// Set target angle for iteration; if angle is 0, use 360
|
||||
targetAngle := float64(angle)
|
||||
if angle == 0 {
|
||||
targetAngle = 360.0
|
||||
}
|
||||
|
||||
// Newton-Raphson iteration to find precise Julian date
|
||||
currentJDE := initialJD
|
||||
var ok bool
|
||||
currentJDE, ok = eventNewtonRefine(currentJDE, 0.00001, func(previousJD float64) float64 {
|
||||
errorValue := JQLospec(previousJD, targetAngle) - targetAngle
|
||||
derivative := (JQLospec(previousJD+0.000005, targetAngle) - JQLospec(previousJD-0.000005, targetAngle)) / 0.00001
|
||||
return errorValue / derivative
|
||||
target := solarTermTarget(angle)
|
||||
tt, ok := solveSolarTermTT(solarTermSeed(year, angle), target, func(jde float64) float64 {
|
||||
return JQLospec(jde, target)
|
||||
})
|
||||
if !ok {
|
||||
return math.NaN()
|
||||
}
|
||||
|
||||
// Convert to UT and return
|
||||
return TT2UTC(currentJDE)
|
||||
return TT2UTC(tt)
|
||||
}
|
||||
|
||||
func JQLospec(jde float64, target float64) float64 {
|
||||
sunLo := HSunApparentLo(jde)
|
||||
return wrapSolarLongitude(HSunApparentLo(jde), target)
|
||||
}
|
||||
|
||||
// 太阳视黄经平均日变化（度/天），只用于迭代步长。
|
||||
const solarTermMeanRate = 360 / 365.2422
|
||||
|
||||
const solarTermToleranceDay = 0.00001
|
||||
|
||||
// 粗解收敛到该步长（天）即转精确求解。
|
||||
const solarTermCoarseToleranceDay = 0.001
|
||||
|
||||
// solarTermSeed 按节气角度给出所在月份的迭代初值。
|
||||
func solarTermSeed(year, angle int) float64 {
|
||||
initialDay := 18.0
|
||||
if angle%2 != 0 {
|
||||
initialDay = 3
|
||||
}
|
||||
tempFactor := float64(angle) / 30
|
||||
if angle%10 != 0 {
|
||||
tempFactor = float64(angle+15) / 30
|
||||
}
|
||||
initialMonth := 3 + tempFactor
|
||||
if initialMonth > 12 {
|
||||
initialMonth -= 12
|
||||
}
|
||||
return JDCalc(year, int(initialMonth), initialDay)
|
||||
}
|
||||
|
||||
// solarTermTarget 0° 按 360° 求解，与春分前的视黄经展开方向一致。
|
||||
func solarTermTarget(angle int) float64 {
|
||||
if angle == 0 {
|
||||
return 360
|
||||
}
|
||||
return float64(angle)
|
||||
}
|
||||
|
||||
// wrapSolarLongitude 把视黄经展开到目标附近，避免 0/360° 跳变。
|
||||
func wrapSolarLongitude(sunLo, target float64) float64 {
|
||||
if target >= 345 {
|
||||
if sunLo <= 12 {
|
||||
sunLo += 360
|
||||
@@ -115,3 +121,73 @@ func JQLospec(jde float64, target float64) float64 {
|
||||
}
|
||||
return sunLo
|
||||
}
|
||||
|
||||
// 割线解离初值超过该天数时改走原牛顿迭代，以保持原选根结果。
|
||||
const solarTermSameRootDays = 19
|
||||
|
||||
// solveSolarTermTT 先用低精度视黄经逼近，再以精确视黄经割线法收敛，返回 TT。
|
||||
func solveSolarTermTT(seed, target float64, precise func(float64) float64) (float64, bool) {
|
||||
if !isFiniteFloat(seed) {
|
||||
return math.NaN(), false
|
||||
}
|
||||
if coarse, ok := solarTermCoarse(seed, target); ok {
|
||||
if tt, ok := solarTermSecant(coarse, target, precise); ok && math.Abs(tt-seed) <= solarTermSameRootDays {
|
||||
return tt, true
|
||||
}
|
||||
}
|
||||
// 古代儒略历初值偏离较大时，原牛顿法可能收敛到相邻年份的根，须保持一致。
|
||||
return solarTermNewton(seed, target, precise)
|
||||
}
|
||||
|
||||
func solarTermNewton(seed, target float64, precise func(float64) float64) (float64, bool) {
|
||||
const h = solarTermToleranceDay / 2
|
||||
return eventNewtonRefine(seed, solarTermToleranceDay, func(x float64) float64 {
|
||||
residual := precise(x) - target
|
||||
derivative := (precise(x+h) - precise(x-h)) / solarTermToleranceDay
|
||||
return residual / derivative
|
||||
})
|
||||
}
|
||||
|
||||
func solarTermCoarse(seed, target float64) (float64, bool) {
|
||||
x := seed
|
||||
for i := 0; i < eventNewtonMaxIterations; i++ {
|
||||
step := (wrapSolarLongitude(SunApparentLo(x), target) - target) / solarTermMeanRate
|
||||
if !isFiniteFloat(step) {
|
||||
return math.NaN(), false
|
||||
}
|
||||
x -= step
|
||||
if math.Abs(step) <= solarTermCoarseToleranceDay {
|
||||
return x, true
|
||||
}
|
||||
}
|
||||
return math.NaN(), false
|
||||
}
|
||||
|
||||
// solarTermSecant 导数取相邻两次残差，每步只求一次精确视黄经。
|
||||
func solarTermSecant(seed, target float64, precise func(float64) float64) (float64, bool) {
|
||||
x0 := seed
|
||||
f0 := precise(x0) - target
|
||||
if !isFiniteFloat(f0) {
|
||||
return math.NaN(), false
|
||||
}
|
||||
x1 := x0 - f0/solarTermMeanRate
|
||||
for i := 0; i < eventNewtonMaxIterations; i++ {
|
||||
f1 := precise(x1) - target
|
||||
if !isFiniteFloat(f1) {
|
||||
return math.NaN(), false
|
||||
}
|
||||
if f1 == f0 {
|
||||
// 残差不再变化说明已到浮点分辨率；残差仍大则是落在跳变两侧。
|
||||
return x1, math.Abs(f1) <= solarTermMeanRate*solarTermToleranceDay
|
||||
}
|
||||
x2 := x1 - f1*(x1-x0)/(f1-f0)
|
||||
if !isFiniteFloat(x2) {
|
||||
return math.NaN(), false
|
||||
}
|
||||
if math.Abs(x2-x1) <= solarTermToleranceDay {
|
||||
return x2, true
|
||||
}
|
||||
x0, f0, x1 = x1, f1, x2
|
||||
}
|
||||
return math.NaN(), false
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user