b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
79 lines
3.9 KiB
Go
79 lines
3.9 KiB
Go
package moon
|
|
|
|
import (
|
|
"time"
|
|
|
|
"b612.me/astro/basic"
|
|
)
|
|
|
|
// MaximumDeclinationInfo 月球最大赤纬事件 / maximum lunar declination event.
|
|
type MaximumDeclinationInfo struct {
|
|
// Time 事件时刻，UTC / event time in UTC.
|
|
Time time.Time
|
|
// Declination 该时刻的地心赤纬，单位度 / geocentric declination at the event, in degrees.
|
|
Declination float64
|
|
}
|
|
|
|
// MaximumNorthDeclinationsInMonth 指定年月内的所有月球最大北赤纬事件 / all maximum northern lunar declination events in the given Gregorian month.
|
|
func (module *Moon) MaximumNorthDeclinationsInMonth(year int, month time.Month) []MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfos(basic.MoonMaximumNorthDeclinationsWithInstance(year, month, module.inst))
|
|
}
|
|
|
|
// MaximumSouthDeclinationsInMonth 指定年月内的所有月球最大南赤纬事件 / all maximum southern lunar declination events in the given Gregorian month.
|
|
func (module *Moon) MaximumSouthDeclinationsInMonth(year int, month time.Month) []MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfos(basic.MoonMaximumSouthDeclinationsWithInstance(year, month, module.inst))
|
|
}
|
|
|
|
// LastMaximumNorthDeclination 指定时刻之前最近一次月球最大北赤纬 / last maximum northern lunar declination at or before date.
|
|
func (module *Moon) LastMaximumNorthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.LastMoonMaximumNorthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
// NextMaximumNorthDeclination 指定时刻之后最近一次月球最大北赤纬 / next maximum northern lunar declination after date.
|
|
func (module *Moon) NextMaximumNorthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.NextMoonMaximumNorthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
// ClosestMaximumNorthDeclination 离指定时刻最近一次月球最大北赤纬 / closest maximum northern lunar declination to date.
|
|
func (module *Moon) ClosestMaximumNorthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.ClosestMoonMaximumNorthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
// LastMaximumSouthDeclination 指定时刻之前最近一次月球最大南赤纬 / last maximum southern lunar declination at or before date.
|
|
func (module *Moon) LastMaximumSouthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.LastMoonMaximumSouthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
// NextMaximumSouthDeclination 指定时刻之后最近一次月球最大南赤纬 / next maximum southern lunar declination after date.
|
|
func (module *Moon) NextMaximumSouthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.NextMoonMaximumSouthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
// ClosestMaximumSouthDeclination 离指定时刻最近一次月球最大南赤纬 / closest maximum southern lunar declination to date.
|
|
func (module *Moon) ClosestMaximumSouthDeclination(date time.Time) MaximumDeclinationInfo {
|
|
return convertMaximumDeclinationInfo(date, basic.ClosestMoonMaximumSouthDeclinationWithInstance(timeToUTJDE(date), module.inst))
|
|
}
|
|
|
|
func convertMaximumDeclinationInfos(events []basic.DeclinationEvent) []MaximumDeclinationInfo {
|
|
result := make([]MaximumDeclinationInfo, 0, len(events))
|
|
for _, event := range events {
|
|
result = append(result, convertMaximumDeclinationInfo(time.Time{}, event))
|
|
}
|
|
return result
|
|
}
|
|
|
|
func convertMaximumDeclinationInfo(date time.Time, event basic.DeclinationEvent) MaximumDeclinationInfo {
|
|
location := time.UTC
|
|
if date.Location() != nil {
|
|
location = date.Location()
|
|
}
|
|
return MaximumDeclinationInfo{
|
|
Time: basic.JD2DateByZone(event.JD, location, false),
|
|
Declination: event.Declination,
|
|
}
|
|
}
|
|
|
|
func timeToUTJDE(date time.Time) float64 {
|
|
return basic.Date2JD(date.UTC())
|
|
}
|