astro/formula/orbit.go
starainrt c8dd777a7b
docs: 统一公开 API 的中英双语注释
- 补齐公开接口说明段的英文描述,保持签名注释和详细说明均为中英双语结构
- 规范农历、坐标、公式、轨道、日晷、太阳、恒星及行星事件等 API 的注释口径
2026-05-27 16:08:11 +08:00

32 lines
847 B
Go

package formula
import "math"
// SynodicPeriod 会合周期 / synodic period.
//
// period1: 第一个天体的恒星周期或朔望周期,单位自定,但必须与 period2 一致
// period2: 第二个天体的周期,单位需与 period1 一致
//
// 返回:
//
// 会合周期,单位与输入相同
//
// Returns the synodic period in the same unit as the two input periods.
//
// 例:
//
// // 地球与金星的会合周期,单位天
// s := formula.SynodicPeriod(365.25636, 224.70069)
func SynodicPeriod(period1, period2 float64) float64 {
if period1 <= 0 || period2 <= 0 ||
math.IsNaN(period1) || math.IsInf(period1, 0) ||
math.IsNaN(period2) || math.IsInf(period2, 0) {
return math.NaN()
}
frequencyDiff := math.Abs(1/period1 - 1/period2)
if frequencyDiff == 0 {
return math.Inf(1)
}
return 1 / frequencyDiff
}