b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
299 lines
10 KiB
Go
299 lines
10 KiB
Go
package basic
|
||
|
||
import (
|
||
"math"
|
||
)
|
||
|
||
// localEphemerisVectorNode is a pair of Cartesian ephemeris samples at one
|
||
// TT. Cartesian interpolation avoids right-ascension wraparound at 0/360.
|
||
type localEphemerisVectorNode struct {
|
||
tt float64
|
||
first, next [3]float64
|
||
}
|
||
|
||
const (
|
||
solarLocalEphemerisNodeCount = 13
|
||
solarLocalEphemerisStepDays = 1.0 / 24.0
|
||
occultationLocalEphemerisNodeCount = 49
|
||
occultationLocalEphemerisStepDays = 2.0 / 24.0
|
||
)
|
||
|
||
func interpolateLocalEphemerisVectors(
|
||
nodes []localEphemerisVectorNode,
|
||
tt float64,
|
||
) ([3]float64, [3]float64, bool) {
|
||
const interpolationPoints = 6
|
||
if len(nodes) < interpolationPoints || !finite(tt) {
|
||
return [3]float64{}, [3]float64{}, false
|
||
}
|
||
step := nodes[1].tt - nodes[0].tt
|
||
if !finite(step) || step <= 0 {
|
||
return [3]float64{}, [3]float64{}, false
|
||
}
|
||
u := (tt - nodes[0].tt) / step
|
||
if u < 0 || u > float64(len(nodes)-1) {
|
||
return [3]float64{}, [3]float64{}, false
|
||
}
|
||
start := int(math.Floor(u)) - 2
|
||
if start < 0 {
|
||
start = 0
|
||
}
|
||
if start > len(nodes)-interpolationPoints {
|
||
start = len(nodes) - interpolationPoints
|
||
}
|
||
var weights [interpolationPoints]float64
|
||
for point := 0; point < interpolationPoints; point++ {
|
||
x := float64(start + point)
|
||
weight := 1.0
|
||
for other := 0; other < interpolationPoints; other++ {
|
||
if other == point {
|
||
continue
|
||
}
|
||
xOther := float64(start + other)
|
||
weight *= (u - xOther) / (x - xOther)
|
||
}
|
||
weights[point] = weight
|
||
}
|
||
var first, next [3]float64
|
||
for coordinate := 0; coordinate < 3; coordinate++ {
|
||
for point := 0; point < interpolationPoints; point++ {
|
||
first[coordinate] += weights[point] * nodes[start+point].first[coordinate]
|
||
next[coordinate] += weights[point] * nodes[start+point].next[coordinate]
|
||
}
|
||
}
|
||
return first, next, finiteVector3(first) && finiteVector3(next)
|
||
}
|
||
|
||
func finiteVector3(value [3]float64) bool {
|
||
return finite(value[0]) && finite(value[1]) && finite(value[2])
|
||
}
|
||
|
||
func occultationPathVectorRaDec(vector occultationPathVector) (float64, float64, float64, bool) {
|
||
distance := occultationPathNorm(vector)
|
||
if !finite(distance) || distance <= 0 {
|
||
return 0, 0, 0, false
|
||
}
|
||
// atan2 给 (−180,180]，统一到 [0,360)：与精确分支（LoBoToRaDec、starMeanToApparentRaDec）
|
||
// 和 occultationRiseSetBodyFromVector 的 normalizeRA 一致；下游只按周期量使用，数值不变。
|
||
ra := normalizeRA(math.Atan2(vector.y, vector.x) / rad)
|
||
dec := math.Asin(math.Max(-1, math.Min(1, vector.z/distance))) / rad
|
||
return ra, dec, distance, finite(ra) && finite(dec)
|
||
}
|
||
|
||
type solarEclipseLocalEphemeris struct {
|
||
nodes []localEphemerisVectorNode
|
||
}
|
||
|
||
func newSolarEclipseLocalEphemeris(center float64, instances ...*Instance) *solarEclipseLocalEphemeris {
|
||
inst := instanceValue(instances)
|
||
|
||
half := solarLocalEphemerisNodeCount / 2
|
||
nodes := make([]localEphemerisVectorNode, solarLocalEphemerisNodeCount)
|
||
for index := range nodes {
|
||
tt := center + float64(index-half)*solarLocalEphemerisStepDays
|
||
sun, moon := solarEclipseSunMoonEquatorial(tt, inst)
|
||
nodes[index] = localEphemerisVectorNode{
|
||
tt: tt,
|
||
first: solarEclipseLLRToXYZ(sun[0], sun[1], sun[2]),
|
||
next: solarEclipseLLRToXYZ(moon[0], moon[1], moon[2]),
|
||
}
|
||
}
|
||
return &solarEclipseLocalEphemeris{nodes: nodes}
|
||
}
|
||
|
||
// solarEclipseLimbAxes 与日月局部星历同一时间网格的月球本体坐标架插值节点。
|
||
type solarEclipseLimbAxes struct {
|
||
base lunarLimbFrame
|
||
nodes []localEphemerisVectorNode
|
||
}
|
||
|
||
func newSolarEclipseLimbAxes(ephemeris *solarEclipseLocalEphemeris, limb LunarLimb, inst *Instance) *solarEclipseLimbAxes {
|
||
if ephemeris == nil || limb == nil {
|
||
return nil
|
||
}
|
||
axes := &solarEclipseLimbAxes{nodes: make([]localEphemerisVectorNode, len(ephemeris.nodes))}
|
||
for index, node := range ephemeris.nodes {
|
||
frame := newLunarLimbFrame(limb, node.tt, node.next, inst)
|
||
if !frame.valid {
|
||
return nil
|
||
}
|
||
if index == len(ephemeris.nodes)/2 {
|
||
axes.base = frame
|
||
}
|
||
axes.nodes[index] = localEphemerisVectorNode{tt: node.tt, first: frame.axisX, next: frame.axisZ}
|
||
}
|
||
return axes
|
||
}
|
||
|
||
func (axes *solarEclipseLimbAxes) frameAt(tt float64) (lunarLimbFrame, bool) {
|
||
if axes == nil {
|
||
return lunarLimbFrame{}, false
|
||
}
|
||
axisX, axisZ, ok := interpolateLocalEphemerisVectors(axes.nodes, tt)
|
||
if !ok {
|
||
return lunarLimbFrame{}, false
|
||
}
|
||
frame := axes.base
|
||
if frame.axisZ, ok = lunarLimbNormalize(axisZ); !ok {
|
||
return lunarLimbFrame{}, false
|
||
}
|
||
// 两轴分别插值后不再严格正交，按 z 轴重新正交化 x 轴。
|
||
if frame.axisX, ok = lunarLimbNormalize(lunarLimbReject(axisX, frame.axisZ)); !ok {
|
||
return lunarLimbFrame{}, false
|
||
}
|
||
frame.axisY = lunarLimbCross(frame.axisZ, frame.axisX)
|
||
return frame, true
|
||
}
|
||
|
||
func (ephemeris *solarEclipseLocalEphemeris) equatorialAt(tt float64) ([3]float64, [3]float64, bool) {
|
||
var empty [3]float64
|
||
if ephemeris == nil {
|
||
return empty, empty, false
|
||
}
|
||
sunXYZ, moonXYZ, ok := interpolateLocalEphemerisVectors(ephemeris.nodes, tt)
|
||
if !ok {
|
||
return empty, empty, false
|
||
}
|
||
return solarEclipseXYZToLLR(sunXYZ[0], sunXYZ[1], sunXYZ[2]),
|
||
solarEclipseXYZToLLR(moonXYZ[0], moonXYZ[1], moonXYZ[2]), true
|
||
}
|
||
|
||
type starOccultationLocalEphemeris struct {
|
||
star StarCoordinate
|
||
nodes []localEphemerisVectorNode
|
||
dense bool
|
||
// distanceKM 是中心时刻的当日距离；hasDistance 为假表示恒星距离未知，几何按无穷远处理。
|
||
distanceKM float64
|
||
hasDistance bool
|
||
}
|
||
|
||
func newStarOccultationLocalEphemeris(center float64, star StarCoordinate, instances ...*Instance) *starOccultationLocalEphemeris {
|
||
inst := instanceValue(instances)
|
||
|
||
half := occultationLocalEphemerisNodeCount / 2
|
||
nodes := make([]localEphemerisVectorNode, occultationLocalEphemerisNodeCount)
|
||
for index := range nodes {
|
||
tt := center + float64(index-half)*occultationLocalEphemerisStepDays
|
||
state := starOccultationEphemerisStateAt(tt, star, inst)
|
||
moon := occultationPathRaDecVector(state.moonRA, state.moonDec, state.moonDistanceKM)
|
||
targetDistance := state.starDistanceKM
|
||
if targetDistance <= 0 {
|
||
// 恒星距离未知时只需方向：按单位球方向装配，几何只用归一化后的矢量。
|
||
targetDistance = 1
|
||
}
|
||
target := occultationPathRaDecVector(state.starRA, state.starDec, targetDistance)
|
||
nodes[index] = localEphemerisVectorNode{
|
||
tt: tt,
|
||
first: [3]float64{moon.x, moon.y, moon.z},
|
||
next: [3]float64{target.x, target.y, target.z},
|
||
}
|
||
}
|
||
return newStarOccultationLocalEphemerisFromNodes(center, star, nodes, false, inst)
|
||
}
|
||
|
||
// newStarOccultationLocalEphemerisFromNodes 装配局部星历：距离必须与节点同源，密集分支同样要带上。
|
||
func newStarOccultationLocalEphemerisFromNodes(center float64, star StarCoordinate, nodes []localEphemerisVectorNode, dense bool, instances ...*Instance) *starOccultationLocalEphemeris {
|
||
inst := instanceValue(instances)
|
||
|
||
_, _, distanceAU := starApparentRaDecDistanceGeocentric(center, star, inst)
|
||
return &starOccultationLocalEphemeris{
|
||
star: star, nodes: nodes, dense: dense,
|
||
distanceKM: distanceAU * occultationPathAstronomicalUnitKM, hasDistance: distanceAU > 0,
|
||
}
|
||
}
|
||
|
||
func (ephemeris *starOccultationLocalEphemeris) stateAt(tt float64) (starOccultationEphemerisState, bool) {
|
||
moonXYZ, targetXYZ, ok := ephemeris.vectorsAt(tt)
|
||
if !ok {
|
||
return starOccultationEphemerisState{}, false
|
||
}
|
||
moonRA, moonDec, moonDistance, moonOK := occultationPathVectorRaDec(occultationPathVector{
|
||
x: moonXYZ[0], y: moonXYZ[1], z: moonXYZ[2],
|
||
})
|
||
targetRA, targetDec, targetDistance, targetOK := occultationPathVectorRaDec(occultationPathVector{
|
||
x: targetXYZ[0], y: targetXYZ[1], z: targetXYZ[2],
|
||
})
|
||
if !moonOK || !targetOK {
|
||
return starOccultationEphemerisState{}, false
|
||
}
|
||
// 距离取插值矢量自身的模长，才与同一次插值给出的方向同源；距离未知时按 0 上报。
|
||
starDistanceKM := 0.0
|
||
if ephemeris.hasDistance {
|
||
starDistanceKM = targetDistance
|
||
}
|
||
return starOccultationEphemerisState{
|
||
moonRA: moonRA, moonDec: moonDec, moonDistanceKM: moonDistance,
|
||
starRA: targetRA, starDec: targetDec, starDistanceKM: starDistanceKM,
|
||
valid: true,
|
||
}, true
|
||
}
|
||
|
||
func (ephemeris *starOccultationLocalEphemeris) vectorsAt(tt float64) ([3]float64, [3]float64, bool) {
|
||
if ephemeris == nil {
|
||
return [3]float64{}, [3]float64{}, false
|
||
}
|
||
if ephemeris.dense {
|
||
return interpolateDenseOccultationVectors(ephemeris.nodes, tt)
|
||
}
|
||
return interpolateLocalEphemerisVectors(ephemeris.nodes, tt)
|
||
}
|
||
|
||
func (ephemeris *starOccultationLocalEphemeris) starDistanceKM() float64 {
|
||
return ephemeris.distanceKM
|
||
}
|
||
|
||
type planetOccultationLocalEphemeris struct {
|
||
nodes []localEphemerisVectorNode
|
||
dense bool
|
||
}
|
||
|
||
func newPlanetOccultationLocalEphemeris(center float64, config planetOccultationConfig, instances ...*Instance) *planetOccultationLocalEphemeris {
|
||
inst := instanceValue(instances)
|
||
|
||
half := occultationLocalEphemerisNodeCount / 2
|
||
nodes := make([]localEphemerisVectorNode, occultationLocalEphemerisNodeCount)
|
||
for index := range nodes {
|
||
tt := center + float64(index-half)*occultationLocalEphemerisStepDays
|
||
state := planetOccultationEphemerisStateAt(tt, config, inst)
|
||
moon := occultationPathRaDecVector(state.moonRA, state.moonDec, state.moonDistanceKM)
|
||
target := occultationPathRaDecVector(state.planetRA, state.planetDec, state.planetDistanceKM)
|
||
nodes[index] = localEphemerisVectorNode{
|
||
tt: tt,
|
||
first: [3]float64{moon.x, moon.y, moon.z},
|
||
next: [3]float64{target.x, target.y, target.z},
|
||
}
|
||
}
|
||
return &planetOccultationLocalEphemeris{nodes: nodes}
|
||
}
|
||
|
||
func (ephemeris *planetOccultationLocalEphemeris) stateAt(tt float64) (planetOccultationEphemerisState, bool) {
|
||
moonXYZ, targetXYZ, ok := ephemeris.vectorsAt(tt)
|
||
if !ok {
|
||
return planetOccultationEphemerisState{}, false
|
||
}
|
||
moonRA, moonDec, moonDistance, moonOK := occultationPathVectorRaDec(occultationPathVector{
|
||
x: moonXYZ[0], y: moonXYZ[1], z: moonXYZ[2],
|
||
})
|
||
targetRA, targetDec, planetDistance, targetOK := occultationPathVectorRaDec(occultationPathVector{
|
||
x: targetXYZ[0], y: targetXYZ[1], z: targetXYZ[2],
|
||
})
|
||
if !moonOK || !targetOK {
|
||
return planetOccultationEphemerisState{}, false
|
||
}
|
||
return planetOccultationEphemerisState{
|
||
moonRA: moonRA, moonDec: moonDec, moonDistanceKM: moonDistance,
|
||
planetRA: targetRA, planetDec: targetDec, planetDistanceKM: planetDistance,
|
||
valid: true,
|
||
}, true
|
||
}
|
||
|
||
func (ephemeris *planetOccultationLocalEphemeris) vectorsAt(tt float64) ([3]float64, [3]float64, bool) {
|
||
if ephemeris == nil {
|
||
return [3]float64{}, [3]float64{}, false
|
||
}
|
||
if ephemeris.dense {
|
||
return interpolateDenseOccultationVectors(ephemeris.nodes, tt)
|
||
}
|
||
return interpolateLocalEphemerisVectors(ephemeris.nodes, tt)
|
||
}
|