astro/basic/orbit_phase.go
starainrt 3ffdbe0034
feat: 扩展天文计算能力
- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息
- 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算
- 新增木星伽利略卫星位置、现象与接触事件计算
- 新增恒星星表、星座判定、自行修正与观测辅助能力
- 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包
- 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算
- 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试
- 重构基础算法文件组织,补充大量公开 API 注释和语义回归测试
- 更新中文和英文 README,补充示例、精度说明、SVG 配图
2026-05-01 22:38:44 +08:00

40 lines
1.5 KiB
Go

package basic
import . "b612.me/astro/tools"
// OrbitSunDistance 返回轨道目标在给定 TT/TDB 儒略日的日心距离,单位 AU。
func OrbitSunDistance(jd float64, elements OrbitElements) float64 {
_, _, distance := OrbitHeliocentricEclipticJ2000(jd, elements)
return distance
}
// OrbitEarthDistance 返回轨道目标在给定 TT/TDB 儒略日的地心距离,单位 AU。
func OrbitEarthDistance(jd float64, elements OrbitElements) float64 {
_, _, distance := OrbitGeocentricEclipticJ2000(jd, elements)
return distance
}
// OrbitPhaseAngle 返回轨道目标的相位角,单位度。
func OrbitPhaseAngle(jd float64, elements OrbitElements) float64 {
return ArcCos(orbitPhaseCosine(jd, elements))
}
// OrbitIlluminatedFraction 返回轨道目标的被照亮比例。
func OrbitIlluminatedFraction(jd float64, elements OrbitElements) float64 {
return (1 + orbitPhaseCosine(jd, elements)) / 2
}
// OrbitElongation 返回轨道目标相对于太阳的地心视角距,单位度。
func OrbitElongation(jd float64, elements OrbitElements) float64 {
lon, lat, _ := OrbitApparentGeocentricEcliptic(jd, elements)
return StarAngularSeparation(lon, lat, HSunApparentLo(jd), HSunTrueBo(jd))
}
func orbitPhaseCosine(jd float64, elements OrbitElements) float64 {
sunDistance := OrbitSunDistance(jd, elements)
earthDistance := OrbitEarthDistance(jd, elements)
earthSunDistance := EarthAway(jd)
cosine := (sunDistance*sunDistance + earthDistance*earthDistance - earthSunDistance*earthSunDistance) / (2 * sunDistance * earthDistance)
return clampUnit(cosine)
}