Files
astro/lite/internal/common.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

148 lines
3.9 KiB
Go

package internal
import (
"errors"
"math"
. "b612.me/astro/tools"
)
const (
SynodicMonthDays = 29.530588853
)
var (
ErrNeverRise = errors.New("rise event does not occur on this date")
ErrNeverSet = errors.New("set event does not occur on this date")
ErrNotOnThisDate = errors.New("rise/set event occurs on adjacent date")
)
func MeanObliquity(jde float64) float64 {
t := (jde - 2451545.0) / 36525.0
return 23.4392911111 - (46.8150*t+0.00059*t*t-0.001813*t*t*t)/3600.0
}
func MeanSiderealTime(jd float64) float64 {
t := (jd - 2451545.0) / 36525.0
return Limit360(280.46061837 + 360.98564736629*(jd-2451545.0) + 0.000387933*t*t - t*t*t/38710000.0)
}
func EclipticToEquatorial(jde, lo, bo float64) (float64, float64) {
eps := MeanObliquity(jde)
ra := math.Atan2(Sin(lo)*Cos(eps)-Tan(bo)*Sin(eps), Cos(lo)) * 180.0 / math.Pi
if ra < 0 {
ra += 360
}
dec := ArcSin(Sin(bo)*Cos(eps) + Cos(bo)*Sin(eps)*Sin(lo))
return ra, dec
}
func HorizontalCoordinates(ra, dec, jd, lon, lat float64) (float64, float64, float64) {
lst := Limit360(MeanSiderealTime(UTC2UT1(jd)) + lon)
hourAngle := Limit360(lst - ra)
altitude := ArcSin(clampUnit(Sin(lat)*Sin(dec) + Cos(lat)*Cos(dec)*Cos(hourAngle)))
y := Sin(hourAngle)
x := Cos(hourAngle)*Sin(lat) - Tan(dec)*Cos(lat)
azimuth := math.Atan2(y, x) * 180.0 / math.Pi
if azimuth < 0 {
if hourAngle < 180 {
azimuth += 360
} else {
azimuth += 180
}
} else if hourAngle < 180 {
azimuth += 180
}
return altitude, Limit360(azimuth), hourAngle
}
func TopocentricRaDec(ra, dec, observerLat, observerLon, jd, distanceEarthRadii, heightMeters float64) (float64, float64) {
u := math.Atan(0.99664719 * Tan(observerLat))
rhoSin := 0.99664719*math.Sin(u) + heightMeters/6378140.0*Sin(observerLat)
rhoCos := math.Cos(u) + heightMeters/6378140.0*Cos(observerLat)
parallax := math.Asin(1.0 / distanceEarthRadii)
hourAngle := (Limit360(MeanSiderealTime(UTC2UT1(jd)) + observerLon - ra)) * math.Pi / 180.0
decRad := dec * math.Pi / 180.0
numerator := -rhoCos * math.Sin(parallax) * math.Sin(hourAngle)
denominator := math.Cos(decRad) - rhoCos*math.Sin(parallax)*math.Cos(hourAngle)
deltaRA := math.Atan2(numerator, denominator)
topRA := Limit360(ra + deltaRA*180.0/math.Pi)
topDec := math.Atan2((math.Sin(decRad)-rhoSin*math.Sin(parallax))*math.Cos(deltaRA), denominator) * 180.0 / math.Pi
return topRA, topDec
}
func SearchRiseSet(startJD, targetAltitude, stepMinutes float64, isRise bool, altitudeFn func(float64) float64) (float64, error) {
step := stepMinutes / 1440.0
prevJD := startJD
prevAlt := altitudeFn(prevJD) - targetAltitude
minAlt := prevAlt
maxAlt := prevAlt
for i := 1; i <= int(math.Round(1440.0/stepMinutes)); i++ {
currentJD := startJD + float64(i)*step
currentAlt := altitudeFn(currentJD) - targetAltitude
if currentAlt < minAlt {
minAlt = currentAlt
}
if currentAlt > maxAlt {
maxAlt = currentAlt
}
if crosses(prevAlt, currentAlt, isRise) {
return bisectEvent(prevJD, currentJD, targetAltitude, altitudeFn), nil
}
prevJD = currentJD
prevAlt = currentAlt
}
if maxAlt < 0 {
return 0, ErrNeverRise
}
if minAlt > 0 {
return 0, ErrNeverSet
}
return 0, ErrNotOnThisDate
}
func crosses(prevAlt, currentAlt float64, isRise bool) bool {
if isRise {
return prevAlt < 0 && currentAlt >= 0
}
return prevAlt > 0 && currentAlt <= 0
}
func bisectEvent(lo, hi, targetAltitude float64, altitudeFn func(float64) float64) float64 {
loAlt := altitudeFn(lo) - targetAltitude
for i := 0; i < 40; i++ {
mid := (lo + hi) / 2.0
midAlt := altitudeFn(mid) - targetAltitude
if midAlt == 0 {
return mid
}
if sameSign(loAlt, midAlt) {
lo = mid
loAlt = midAlt
} else {
hi = mid
}
}
return (lo + hi) / 2.0
}
func sameSign(a, b float64) bool {
return (a >= 0 && b >= 0) || (a <= 0 && b <= 0)
}
func clampUnit(v float64) float64 {
if v > 1 {
return 1
}
if v < -1 {
return -1
}
return v
}