astro/orbit/doc.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

23 lines
1.2 KiB
Go

// Package orbit propagates lightweight Sun-centered two-body conic orbits.
//
// Supported input styles:
// - classical elliptic elements: A/E/I/Omega/W/M0 at EpochJD
// - perihelion form: Q/E/I/Omega/W/TpJD for high-eccentricity, parabolic,
// or hyperbolic comet-like trajectories
//
// All input angles are in degrees. EpochJD and TpJD are TT/TDB Julian days.
// Returned geometric positions do not include perturbations beyond the supplied
// elements. Astrometric results include down-leg light-time correction.
// Apparent results follow this repository's existing planet semantics:
// astrometric position plus nutation/of-date coordinate conversion, without a
// full external aberration model. The package also provides observer-facing
// altitude/azimuth/hour-angle and rise/transit/set helpers built on top of the
// apparent topocentric coordinates. Rise/set helpers return package-local
// sentinel errors ERR_ORBIT_NEVER_RISE / ERR_ORBIT_NEVER_SET, matching the
// convention used by other public observation packages in this repository.
//
// In addition, the package includes a small classical visual-binary helper
// based on the standard P/T/e/a/i/Omega/omega element set, returning apparent
// position angle and separation on the sky.
package orbit