Files
astro/basic/uranus_events.go
T
b612 2bf8478639 feat: 完善日月食与月掩几何链路并扩展历法接口
- 新增日月食中心带、偏食带、阴影足迹、等时线、食分线及升落边界计算,支持极区与混合食拓扑
- 新增日食单时刻阴影求解器、站心状态查询、批量采样和 ΔT 覆盖接口
- 重构恒星与行星月掩路径,补充有限盘面接触、站心修正、掩带宽度、极区投影及升落边界
- 扩展 SVG 与 GeoJSON 输出,支持详细面板、全球/极区/地球投影、边界闭合、时间标记和拓扑签名
- 扩展日月食候选搜索、局地搜索、沙罗序列预计算与范围外推,补充系列锚点和成员一致性校验
- 补齐古历纪年、儒略历独有闰日、多公历候选、历法改革跨日及精确日期运算接口
- 优化 ΔT、章动、恒星时、月球地平线、事件根搜索和本地星历缓存,降低重复计算开销并提升边界稳定
2026-09-17 12:27:40 +08:00

284 lines
7.9 KiB
Go

package basic
import (
"math"
. "b612.me/astro/tools"
)
// Pos
const (
URANUS_S_PERIOD = 1 / ((1 / 365.256363004) - (1 / 30799.095))
uranusEventSearchN = 16
uranusPhaseCoarseTolerance = 30.0 / 86400.0
)
func uranusSunLongitudeDelta(jde, degree float64, filter bool) float64 {
sub := Limit360(Limit360(UranusApparentLo(jde)-HSunApparentLo(jde)) - degree)
if filter {
if sub > 180 {
sub -= 360
}
if sub < -180 {
sub += 360
}
}
return sub
}
func uranusSunLongitudeDeltaN(jde, degree float64, filter bool, n int) float64 {
sub := Limit360(Limit360(UranusApparentLoN(jde, n)-HSunApparentLoN(jde, n)) - degree)
if filter {
if sub > 180 {
sub -= 360
}
if sub < -180 {
sub += 360
}
}
return sub
}
func uranusRADerivative(jde, delta float64) float64 {
sub := UranusApparentRa(jde+delta) - UranusApparentRa(jde-delta)
if sub > 180 {
sub -= 360
}
if sub < -180 {
sub += 360
}
return sub / (2 * delta)
}
func uranusRADerivativeN(jde, delta float64, n int) float64 {
sub := UranusApparentRaN(jde+delta, n) - UranusApparentRaN(jde-delta, n)
if sub > 180 {
sub -= 360
}
if sub < -180 {
sub += 360
}
return sub / (2 * delta)
}
func uranusConjunctionFull(jde, degree float64, next uint8) float64 {
//0=last 1=next
if !isFiniteFloat(jde) || !isFiniteFloat(degree) {
return math.NaN()
}
daysPerDegree := URANUS_S_PERIOD / 360
currentDelta := uranusSunLongitudeDelta(jde, degree, false)
if next == 0 {
jde -= (360 - currentDelta) * daysPerDegree
} else {
jde += daysPerDegree * currentDelta
}
estimateJD := jde
converged := false
for i := 0; i < eventNewtonMaxIterations; i++ {
prevJD := estimateJD
longitudeDelta := uranusSunLongitudeDelta(prevJD, degree, true)
longitudeSlope := (uranusSunLongitudeDelta(prevJD+0.000005, degree, true) - uranusSunLongitudeDelta(prevJD-0.000005, degree, true)) / 0.00001
nextJD := prevJD - longitudeDelta/longitudeSlope
estimateJD = nextJD
if math.Abs(nextJD-prevJD) <= 0.00001 {
converged = true
break
}
}
if !converged {
return math.NaN()
}
return TD2UT(estimateJD, false)
}
func uranusConjunction(jde, degree float64, next uint8) float64 {
//0=last 1=next
if !isFiniteFloat(jde) || !isFiniteFloat(degree) {
return math.NaN()
}
daysPerDegree := URANUS_S_PERIOD / 360
currentDelta := uranusSunLongitudeDelta(jde, degree, false)
if next == 0 {
jde -= (360 - currentDelta) * daysPerDegree
} else {
jde += daysPerDegree * currentDelta
}
estimateJD := jde
converged := false
for i := 0; i < eventNewtonMaxIterations; i++ {
prevJD := estimateJD
longitudeDelta := uranusSunLongitudeDeltaN(prevJD, degree, true, uranusEventSearchN)
longitudeSlope := (uranusSunLongitudeDeltaN(prevJD+0.000005, degree, true, uranusEventSearchN) - uranusSunLongitudeDeltaN(prevJD-0.000005, degree, true, uranusEventSearchN)) / 0.00001
nextJD := prevJD - longitudeDelta/longitudeSlope
estimateJD = nextJD
if math.Abs(nextJD-prevJD) <= uranusPhaseCoarseTolerance {
converged = true
break
}
}
if !converged {
return math.NaN()
}
converged = false
for i := 0; i < eventNewtonMaxIterations; i++ {
prevJD := estimateJD
longitudeDelta := uranusSunLongitudeDelta(prevJD, degree, true)
longitudeSlope := (uranusSunLongitudeDelta(prevJD+0.000005, degree, true) - uranusSunLongitudeDelta(prevJD-0.000005, degree, true)) / 0.00001
nextJD := prevJD - longitudeDelta/longitudeSlope
estimateJD = nextJD
if math.Abs(nextJD-prevJD) <= 0.00001 {
converged = true
break
}
}
if !converged {
return math.NaN()
}
return TD2UT(estimateJD, false)
}
func LastUranusConjunction(jde float64) float64 {
return inclusiveLastPhaseEvent(jde, 0, uranusConjunction)
}
func NextUranusConjunction(jde float64) float64 {
return inclusiveNextPhaseEvent(jde, 0, uranusConjunction)
}
func LastUranusOpposition(jde float64) float64 {
return inclusiveLastPhaseEvent(jde, 180, uranusConjunction)
}
func NextUranusOpposition(jde float64) float64 {
return inclusiveNextPhaseEvent(jde, 180, uranusConjunction)
}
func NextUranusEasternQuadrature(jde float64) float64 {
return inclusiveNextPhaseEvent(jde, 90, uranusConjunction)
}
func LastUranusEasternQuadrature(jde float64) float64 {
return inclusiveLastPhaseEvent(jde, 90, uranusConjunction)
}
func NextUranusWesternQuadrature(jde float64) float64 {
return inclusiveNextPhaseEvent(jde, 270, uranusConjunction)
}
func LastUranusWesternQuadrature(jde float64) float64 {
return inclusiveLastPhaseEvent(jde, 270, uranusConjunction)
}
func uranusRetrogradeAroundOpposition(oppositionJD float64, searchBeforeOpposition bool) float64 {
if !isFiniteFloat(oppositionJD) {
return math.NaN()
}
oppositionTT := TD2UT(oppositionJD, true)
startTT := oppositionTT
endTT := oppositionTT
if searchBeforeOpposition {
easternQuadratureUT := uranusConjunction(oppositionTT, 90, 0)
startTT = TD2UT(easternQuadratureUT, true)
} else {
westernQuadratureUT := uranusConjunction(oppositionTT, 270, 1)
endTT = TD2UT(westernQuadratureUT, true)
}
bestJD := zeroEventInWindow(startTT, endTT, 2.0, 2.0, 30.0/86400.0, func(jd float64) float64 {
return uranusRADerivativeN(jd, stationDerivativeStepDay, uranusEventSearchN)
}, func(jd float64) float64 {
return uranusRADerivative(jd, stationDerivativeStepDay)
})
return TD2UT(bestJD, false)
}
func NextUranusRetrogradeToPrograde(jde float64) float64 {
if !isFiniteFloat(jde) {
return math.NaN()
}
lastOppositionJD := uranusConjunctionFull(jde, 180, 0)
date := uranusRetrogradeAroundOpposition(lastOppositionJD, false)
if isFiniteFloat(date) && stationUTQueryAfterOrEqual(date, jde) {
return date
}
nextOppositionJD := uranusConjunctionFull(jde, 180, 1)
if !isFiniteFloat(nextOppositionJD) {
return math.NaN()
}
date = uranusRetrogradeAroundOpposition(nextOppositionJD, false)
if !isFiniteFloat(date) || !stationUTQueryAfterOrEqual(date, jde) {
return math.NaN()
}
return date
}
func LastUranusRetrogradeToPrograde(jde float64) float64 {
if !isFiniteFloat(jde) {
return math.NaN()
}
lastOppositionJD := uranusConjunctionFull(jde, 180, 0)
date := uranusRetrogradeAroundOpposition(lastOppositionJD, false)
if isFiniteFloat(date) && stationUTQueryBeforeOrEqual(date, jde) {
return date
}
if !isFiniteFloat(lastOppositionJD) {
return math.NaN()
}
previousOppositionJD := uranusConjunctionFull(eventUTLastQueryTT(lastOppositionJD), 180, 0)
if !isFiniteFloat(previousOppositionJD) {
return math.NaN()
}
date = uranusRetrogradeAroundOpposition(previousOppositionJD, false)
if !isFiniteFloat(date) || !stationUTQueryBeforeOrEqual(date, jde) {
return math.NaN()
}
return date
}
func NextUranusProgradeToRetrograde(jde float64) float64 {
if !isFiniteFloat(jde) {
return math.NaN()
}
nextOppositionJD := uranusConjunctionFull(jde, 180, 1)
date := uranusRetrogradeAroundOpposition(nextOppositionJD, true)
if isFiniteFloat(date) && stationUTQueryAfterOrEqual(date, jde) {
return date
}
if !isFiniteFloat(nextOppositionJD) {
return math.NaN()
}
followingOppositionJD := uranusConjunctionFull(eventUTNextQueryTT(nextOppositionJD), 180, 1)
if !isFiniteFloat(followingOppositionJD) {
return math.NaN()
}
date = uranusRetrogradeAroundOpposition(followingOppositionJD, true)
if !isFiniteFloat(date) || !stationUTQueryAfterOrEqual(date, jde) {
return math.NaN()
}
return date
}
func LastUranusProgradeToRetrograde(jde float64) float64 {
if !isFiniteFloat(jde) {
return math.NaN()
}
nextOppositionJD := uranusConjunctionFull(jde, 180, 1)
date := uranusRetrogradeAroundOpposition(nextOppositionJD, true)
if isFiniteFloat(date) && stationUTQueryBeforeOrEqual(date, jde) {
return date
}
if !isFiniteFloat(nextOppositionJD) {
return math.NaN()
}
lastOppositionJD := uranusConjunctionFull(jde, 180, 0)
if !isFiniteFloat(lastOppositionJD) {
return math.NaN()
}
date = uranusRetrogradeAroundOpposition(lastOppositionJD, true)
if !isFiniteFloat(date) || !stationUTQueryBeforeOrEqual(date, jde) {
return math.NaN()
}
return date
}