feat: 扩展天文计算能力

- 新增日食、月食、本地可见性、中心线、半影区域、SVG 图示与沙罗周期信息
- 新增行星冲合、留、方照、物理星历、视直径、相位、亮肢角、轨道节点等计算
- 新增木星伽利略卫星位置、现象与接触事件计算
- 新增恒星星表、星座判定、自行修正与观测辅助能力
- 新增 coord、formula、orbit、sundial、lite/sun、lite/moon 等扩展包
- 完善农历年号、月相英文别名、视差角、大气质量、折射、日晷与双星计算
- 增加 NASA、JPL Horizons、IMCCE 等回归测试数据与基线测试
- 重构基础算法文件组织,补充大量公开 API 注释和语义回归测试
- 更新中文和英文 README,补充示例、精度说明、SVG 配图
This commit is contained in:
2026-05-01 22:38:44 +08:00
parent 98ff574495
commit 3ffdbe0034
365 changed files with 63589 additions and 17508 deletions
+43
View File
@@ -0,0 +1,43 @@
package saturn
import (
"time"
"b612.me/astro/basic"
"b612.me/astro/calendar"
)
// RingInfo 土星环观测参数 / Saturn ring observing parameters.
type RingInfo struct {
// EarthLatitude 地球在土星环面上的土星心纬度 B,单位度 / Saturnicentric latitude of Earth, degrees.
EarthLatitude float64
// SunLatitude 太阳在土星环面上的土星心纬度 B',单位度 / Saturnicentric latitude of Sun, degrees.
SunLatitude float64
// PositionAngle 土星环北半短轴位置角,单位度 / position angle of the northern semiminor axis, degrees.
PositionAngle float64
// DeltaU 太阳和地球在环面内的土星心黄经差,单位度 / difference of Saturnicentric ring longitudes, degrees.
DeltaU float64
// MajorAxis 土星环外缘长轴,单位角秒 / outer ring major axis, arcseconds.
MajorAxis float64
// MinorAxis 土星环外缘短轴,单位角秒 / outer ring minor axis, arcseconds.
MinorAxis float64
}
// Ring 土星环观测参数 / Saturn ring observing parameters.
func Ring(date time.Time) RingInfo {
return RingN(date, -1)
}
// RingN 土星环观测参数(截断版) / truncated Saturn ring observing parameters.
func RingN(date time.Time, n int) RingInfo {
jde := calendar.Date2JDE(date.UTC())
earthLatitude, sunLatitude, positionAngle, deltaU, majorAxis, minorAxis := basic.SaturnRingParametersN(basic.TD2UT(jde, true), n)
return RingInfo{
EarthLatitude: earthLatitude,
SunLatitude: sunLatitude,
PositionAngle: positionAngle,
DeltaU: deltaU,
MajorAxis: majorAxis,
MinorAxis: minorAxis,
}
}