docs: 统一公开 API 的中英双语注释
- 补齐公开接口说明段的英文描述,保持签名注释和详细说明均为中英双语结构 - 规范农历、坐标、公式、轨道、日晷、太阳、恒星及行星事件等 API 的注释口径
This commit is contained in:
@@ -9,6 +9,8 @@ import "math"
|
||||
// 返回:
|
||||
//
|
||||
// 距离模数 m-M
|
||||
//
|
||||
// Returns the distance modulus m-M for the supplied distance in parsecs.
|
||||
func DistanceModulus(distanceParsec float64) float64 {
|
||||
if distanceParsec <= 0 || math.IsNaN(distanceParsec) || math.IsInf(distanceParsec, 0) {
|
||||
return math.NaN()
|
||||
@@ -24,6 +26,8 @@ func DistanceModulus(distanceParsec float64) float64 {
|
||||
// 返回:
|
||||
//
|
||||
// 视星等 m
|
||||
//
|
||||
// Returns apparent magnitude from absolute magnitude and distance.
|
||||
func ApparentMagnitudeFromAbsolute(absoluteMagnitude, distanceParsec float64) float64 {
|
||||
modulus := DistanceModulus(distanceParsec)
|
||||
if math.IsNaN(modulus) {
|
||||
@@ -40,6 +44,8 @@ func ApparentMagnitudeFromAbsolute(absoluteMagnitude, distanceParsec float64) fl
|
||||
// 返回:
|
||||
//
|
||||
// 绝对星等 M
|
||||
//
|
||||
// Returns absolute magnitude from apparent magnitude and distance.
|
||||
func AbsoluteMagnitudeFromApparent(apparentMagnitude, distanceParsec float64) float64 {
|
||||
modulus := DistanceModulus(distanceParsec)
|
||||
if math.IsNaN(modulus) {
|
||||
|
||||
Reference in New Issue
Block a user