b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
307 lines
16 KiB
Go
307 lines
16 KiB
Go
package jupiter
|
||
|
||
import (
|
||
"time"
|
||
)
|
||
|
||
// Altitude 站心视高度角，不含大气折射 / topocentric apparent altitude without refraction.
|
||
func Altitude(date time.Time, lon, lat float64) float64 {
|
||
return defaultModule.Altitude(date, lon, lat)
|
||
}
|
||
|
||
// AltitudeN 站心视高度角（n 变体） / n-parameterised topocentric apparent altitude.
|
||
func AltitudeN(date time.Time, lon, lat float64, n int) float64 {
|
||
return defaultModule.AltitudeN(date, lon, lat, n)
|
||
}
|
||
|
||
// ApparentBo 视黄纬 / apparent ecliptic latitude.
|
||
func ApparentBo(date time.Time) float64 { return defaultModule.ApparentBo(date) }
|
||
|
||
// ApparentBoN 视黄纬（n 变体） / n-parameterised apparent ecliptic latitude.
|
||
func ApparentBoN(date time.Time, n int) float64 { return defaultModule.ApparentBoN(date, n) }
|
||
|
||
// ApparentDec 视赤纬 / apparent declination.
|
||
func ApparentDec(date time.Time) float64 { return defaultModule.ApparentDec(date) }
|
||
|
||
// ApparentDecN 视赤纬（n 变体） / n-parameterised apparent declination.
|
||
func ApparentDecN(date time.Time, n int) float64 { return defaultModule.ApparentDecN(date, n) }
|
||
|
||
// ApparentLo 视黄经 / apparent ecliptic longitude.
|
||
func ApparentLo(date time.Time) float64 { return defaultModule.ApparentLo(date) }
|
||
|
||
// ApparentLoN 视黄经（n 变体） / n-parameterised apparent ecliptic longitude.
|
||
func ApparentLoN(date time.Time, n int) float64 { return defaultModule.ApparentLoN(date, n) }
|
||
|
||
// ApparentMagnitude 视星等 / apparent magnitude.
|
||
func ApparentMagnitude(date time.Time) float64 { return defaultModule.ApparentMagnitude(date) }
|
||
|
||
// ApparentMagnitudeN 视星等（n 变体） / n-parameterised apparent magnitude.
|
||
func ApparentMagnitudeN(date time.Time, n int) float64 {
|
||
return defaultModule.ApparentMagnitudeN(date, n)
|
||
}
|
||
|
||
// ApparentRa 视赤经 / apparent right ascension.
|
||
func ApparentRa(date time.Time) float64 { return defaultModule.ApparentRa(date) }
|
||
|
||
// ApparentRaDec 视赤经、视赤纬 / apparent right ascension and declination.
|
||
func ApparentRaDec(date time.Time) (float64, float64) { return defaultModule.ApparentRaDec(date) }
|
||
|
||
// ApparentRaDecN 视赤经赤纬（n 变体） / n-parameterised apparent right ascension and declination.
|
||
func ApparentRaDecN(date time.Time, n int) (float64, float64) {
|
||
return defaultModule.ApparentRaDecN(date, n)
|
||
}
|
||
|
||
// ApparentRaN 视赤经（n 变体） / n-parameterised apparent right ascension.
|
||
func ApparentRaN(date time.Time, n int) float64 { return defaultModule.ApparentRaN(date, n) }
|
||
|
||
// AscendingNode 木星升交点黄经 / ascending node longitude of Jupiter.
|
||
func AscendingNode(date time.Time) float64 { return defaultModule.AscendingNode(date) }
|
||
|
||
// AscendingNodeN 木星升交点黄经（n 变体） / n-parameterised ascending node longitude of Jupiter.
|
||
func AscendingNodeN(date time.Time, n int) float64 { return defaultModule.AscendingNodeN(date, n) }
|
||
|
||
// Azimuth 站心方位角，自正北向东量 / topocentric azimuth, measured from north through east.
|
||
func Azimuth(date time.Time, lon, lat float64) float64 { return defaultModule.Azimuth(date, lon, lat) }
|
||
|
||
// AzimuthN 站心方位角（n 变体） / n-parameterised topocentric azimuth.
|
||
func AzimuthN(date time.Time, lon, lat float64, n int) float64 {
|
||
return defaultModule.AzimuthN(date, lon, lat, n)
|
||
}
|
||
|
||
// BrightLimbPositionAngle 亮面中心位置角，单位度 / bright limb position angle in degrees.
|
||
func BrightLimbPositionAngle(date time.Time) float64 {
|
||
return defaultModule.BrightLimbPositionAngle(date)
|
||
}
|
||
|
||
// BrightLimbPositionAngleN 亮面中心位置角（n 变体），单位度 / n-parameterised bright limb position angle in degrees.
|
||
func BrightLimbPositionAngleN(date time.Time, n int) float64 {
|
||
return defaultModule.BrightLimbPositionAngleN(date, n)
|
||
}
|
||
|
||
// CentralMeridians 木星 System I/II/III 中央经线 / Jupiter System I/II/III central meridians.
|
||
func CentralMeridians(date time.Time) CentralMeridianInfo {
|
||
return defaultModule.CentralMeridians(date)
|
||
}
|
||
|
||
// CentralMeridiansN 木星 System I/II/III 中央经线（n 变体） / n-parameterised Jupiter System I/II/III central meridians.
|
||
func CentralMeridiansN(date time.Time, n int) CentralMeridianInfo {
|
||
return defaultModule.CentralMeridiansN(date, n)
|
||
}
|
||
|
||
// ClosestGalileanPhenomenonContactEvent 最近一次 IMCCE 风格接触事件 / closest IMCCE-style contact event.
|
||
func ClosestGalileanPhenomenonContactEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonContactEvent {
|
||
return defaultModule.ClosestGalileanPhenomenonContactEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// ClosestGalileanPhenomenonEvent 最近一次伽利略卫星现象 / closest Galilean-satellite event.
|
||
func ClosestGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return defaultModule.ClosestGalileanPhenomenonEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// CulminationTime 中天时刻，取 date 所在当地民用日 / culmination time, on the local civil day of date.
|
||
func CulminationTime(date time.Time, lon float64) time.Time {
|
||
return defaultModule.CulminationTime(date, lon)
|
||
}
|
||
|
||
// CulminationTimeN 中天时间（n 变体） / n-parameterised culmination time.
|
||
func CulminationTimeN(date time.Time, lon float64, n int) time.Time {
|
||
return defaultModule.CulminationTimeN(date, lon, n)
|
||
}
|
||
|
||
// DescendingNode 木星降交点黄经 / descending node longitude of Jupiter.
|
||
func DescendingNode(date time.Time) float64 { return defaultModule.DescendingNode(date) }
|
||
|
||
// DescendingNodeN 木星降交点黄经（n 变体） / n-parameterised descending node longitude of Jupiter.
|
||
func DescendingNodeN(date time.Time, n int) float64 { return defaultModule.DescendingNodeN(date, n) }
|
||
|
||
// Diameter 木星视直径，单位角秒 / apparent Jupiter diameter in arcseconds.
|
||
func Diameter(date time.Time) float64 { return defaultModule.Diameter(date) }
|
||
|
||
// DiameterN 木星视直径（n 变体），单位角秒 / n-parameterised apparent Jupiter diameter in arcseconds.
|
||
func DiameterN(date time.Time, n int) float64 { return defaultModule.DiameterN(date, n) }
|
||
|
||
// DownTime 落下时间别名 / deprecated set-time alias.
|
||
//
|
||
// Deprecated: use SetTime instead.
|
||
func DownTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
|
||
return defaultModule.DownTime(date, lon, lat, height, aero)
|
||
}
|
||
|
||
// DownTimeN 落下时间别名（n 变体） / n-parameterised down-time alias.
|
||
func DownTimeN(date time.Time, lon, lat, height float64, aero bool, n int) (time.Time, error) {
|
||
return defaultModule.DownTimeN(date, lon, lat, height, aero, n)
|
||
}
|
||
|
||
// EarthDistance 地心距离 / Earth distance.
|
||
func EarthDistance(date time.Time) float64 { return defaultModule.EarthDistance(date) }
|
||
|
||
// EarthDistanceN 地球距离（n 变体） / n-parameterised Earth distance.
|
||
func EarthDistanceN(date time.Time, n int) float64 { return defaultModule.EarthDistanceN(date, n) }
|
||
|
||
// HourAngle 地心视时角，不含站心视差 / geocentric apparent hour angle without topocentric parallax.
|
||
func HourAngle(date time.Time, lon float64) float64 { return defaultModule.HourAngle(date, lon) }
|
||
|
||
// HourAngleN 时角（n 变体） / n-parameterised hour angle.
|
||
func HourAngleN(date time.Time, lon float64, n int) float64 {
|
||
return defaultModule.HourAngleN(date, lon, n)
|
||
}
|
||
|
||
// IlluminatedFraction 被照亮比例 / illuminated fraction.
|
||
func IlluminatedFraction(date time.Time) float64 { return defaultModule.IlluminatedFraction(date) }
|
||
|
||
// IlluminatedFractionN 被照亮比例（n 变体） / n-parameterised illuminated fraction.
|
||
func IlluminatedFractionN(date time.Time, n int) float64 {
|
||
return defaultModule.IlluminatedFractionN(date, n)
|
||
}
|
||
|
||
// LastConjunction 上一次合日，取 date 所在当地民用日 / previous conjunction with the Sun, on the local civil day of date.
|
||
func LastConjunction(date time.Time) time.Time { return defaultModule.LastConjunction(date) }
|
||
|
||
// LastEasternQuadrature 上一次东方照，取 date 所在当地民用日 / previous eastern quadrature, on the local civil day of date.
|
||
func LastEasternQuadrature(date time.Time) time.Time {
|
||
return defaultModule.LastEasternQuadrature(date)
|
||
}
|
||
|
||
// LastGalileanPhenomenonContactEvent 上一次 IMCCE 风格接触事件 / previous IMCCE-style contact event.
|
||
func LastGalileanPhenomenonContactEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonContactEvent {
|
||
return defaultModule.LastGalileanPhenomenonContactEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// LastGalileanPhenomenonEvent 上一次伽利略卫星现象，satellite 取 1=Io 2=Europa 3=Ganymede 4=Callisto；phenomenonType 取 transit/occultation/eclipse/shadow_transit / previous Galilean-satellite event, satellite is 1=Io 2=Europa 3=Ganymede 4=Callisto; phenomenonType is transit/occultation/eclipse/shadow_transit.
|
||
func LastGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return defaultModule.LastGalileanPhenomenonEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// LastOpposition 上一次冲日，取 date 所在当地民用日 / previous opposition, on the local civil day of date.
|
||
func LastOpposition(date time.Time) time.Time { return defaultModule.LastOpposition(date) }
|
||
|
||
// LastProgradeToRetrograde 上一次顺行转逆行留，取 date 所在当地民用日 / previous station from prograde to retrograde, on the local civil day of date.
|
||
func LastProgradeToRetrograde(date time.Time) time.Time {
|
||
return defaultModule.LastProgradeToRetrograde(date)
|
||
}
|
||
|
||
// LastRetrogradeToPrograde 上一次逆行转顺行留，取 date 所在当地民用日 / previous station from retrograde to prograde, on the local civil day of date.
|
||
func LastRetrogradeToPrograde(date time.Time) time.Time {
|
||
return defaultModule.LastRetrogradeToPrograde(date)
|
||
}
|
||
|
||
// LastWesternQuadrature 上一次西方照，取 date 所在当地民用日 / previous western quadrature, on the local civil day of date.
|
||
func LastWesternQuadrature(date time.Time) time.Time {
|
||
return defaultModule.LastWesternQuadrature(date)
|
||
}
|
||
|
||
// NextConjunction 下一次合日，取 date 所在当地民用日 / next conjunction with the Sun, on the local civil day of date.
|
||
func NextConjunction(date time.Time) time.Time { return defaultModule.NextConjunction(date) }
|
||
|
||
// NextEasternQuadrature 下一次东方照，取 date 所在当地民用日 / next eastern quadrature, on the local civil day of date.
|
||
func NextEasternQuadrature(date time.Time) time.Time {
|
||
return defaultModule.NextEasternQuadrature(date)
|
||
}
|
||
|
||
// NextGalileanPhenomenonContactEvent 下一次 IMCCE 风格接触事件 / next IMCCE-style contact event.
|
||
func NextGalileanPhenomenonContactEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonContactEvent {
|
||
return defaultModule.NextGalileanPhenomenonContactEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// NextGalileanPhenomenonEvent 下一次伽利略卫星现象 / next Galilean-satellite event.
|
||
func NextGalileanPhenomenonEvent(date time.Time, satellite int, phenomenonType GalileanPhenomenonType) GalileanPhenomenonEvent {
|
||
return defaultModule.NextGalileanPhenomenonEvent(date, satellite, phenomenonType)
|
||
}
|
||
|
||
// NextOpposition 下一次冲日，取 date 所在当地民用日 / next opposition, on the local civil day of date.
|
||
func NextOpposition(date time.Time) time.Time { return defaultModule.NextOpposition(date) }
|
||
|
||
// NextProgradeToRetrograde 下一次顺行转逆行留，取 date 所在当地民用日 / next station from prograde to retrograde, on the local civil day of date.
|
||
func NextProgradeToRetrograde(date time.Time) time.Time {
|
||
return defaultModule.NextProgradeToRetrograde(date)
|
||
}
|
||
|
||
// NextRetrogradeToPrograde 下一次逆行转顺行留，取 date 所在当地民用日 / next station from retrograde to prograde, on the local civil day of date.
|
||
func NextRetrogradeToPrograde(date time.Time) time.Time {
|
||
return defaultModule.NextRetrogradeToPrograde(date)
|
||
}
|
||
|
||
// NextWesternQuadrature 下一次西方照，取 date 所在当地民用日 / next western quadrature, on the local civil day of date.
|
||
func NextWesternQuadrature(date time.Time) time.Time {
|
||
return defaultModule.NextWesternQuadrature(date)
|
||
}
|
||
|
||
// ParallacticAngle 木星视差角（天顶方向角） / Jupiter parallactic angle.
|
||
func ParallacticAngle(date time.Time, lon, lat float64) float64 {
|
||
return defaultModule.ParallacticAngle(date, lon, lat)
|
||
}
|
||
|
||
// ParallacticAngleN 木星视差角（天顶方向角）（n 变体） / n-parameterised Jupiter parallactic angle.
|
||
func ParallacticAngleN(date time.Time, lon, lat float64, n int) float64 {
|
||
return defaultModule.ParallacticAngleN(date, lon, lat, n)
|
||
}
|
||
|
||
// Phase 相位，被照亮比例 / phase, illuminated fraction.
|
||
func Phase(date time.Time) float64 { return defaultModule.Phase(date) }
|
||
|
||
// PhaseAngle 相位角，单位度 / phase angle in degrees.
|
||
func PhaseAngle(date time.Time) float64 { return defaultModule.PhaseAngle(date) }
|
||
|
||
// PhaseAngleN 相位角（n 变体），单位度 / n-parameterised phase angle in degrees.
|
||
func PhaseAngleN(date time.Time, n int) float64 { return defaultModule.PhaseAngleN(date, n) }
|
||
|
||
// PhaseN 相位（n 变体），被照亮比例 / n-parameterised phase, illuminated fraction.
|
||
func PhaseN(date time.Time, n int) float64 { return defaultModule.PhaseN(date, n) }
|
||
|
||
// Physical 木星物理观测参数 / physical observing parameters of Jupiter.
|
||
func Physical(date time.Time) PhysicalInfo { return defaultModule.Physical(date) }
|
||
|
||
// PhysicalN 木星物理观测参数（n 变体） / n-parameterised physical observing parameters of Jupiter.
|
||
func PhysicalN(date time.Time, n int) PhysicalInfo { return defaultModule.PhysicalN(date, n) }
|
||
|
||
// RiseTime 升起时间，取 date 所在当地民用日 / rise time, on the local civil day of date.
|
||
func RiseTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
|
||
return defaultModule.RiseTime(date, lon, lat, height, aero)
|
||
}
|
||
|
||
// RiseTimeN 升起时间（n 变体） / n-parameterised rise time.
|
||
func RiseTimeN(date time.Time, lon, lat, height float64, aero bool, n int) (time.Time, error) {
|
||
return defaultModule.RiseTimeN(date, lon, lat, height, aero, n)
|
||
}
|
||
|
||
// SatellitePhenomena 木星四颗伽利略卫星瞬时现象，内部换算为 TT/TDB 历元求值 / instantaneous phenomena of Jupiter's four Galilean satellites, converted internally to the TT/TDB epoch.
|
||
func SatellitePhenomena(date time.Time) GalileanPhenomenaInfo {
|
||
return defaultModule.SatellitePhenomena(date)
|
||
}
|
||
|
||
// Satellites 木星四颗伽利略卫星视位置，内部换算为 TT/TDB 历元求值 / apparent positions of Jupiter's four Galilean satellites, converted internally to the TT/TDB epoch.
|
||
func Satellites(date time.Time) GalileanSatellitesInfo { return defaultModule.Satellites(date) }
|
||
|
||
// Semidiameter 木星视半径，单位角秒 / apparent Jupiter semidiameter in arcseconds.
|
||
func Semidiameter(date time.Time) float64 { return defaultModule.Semidiameter(date) }
|
||
|
||
// SemidiameterN 木星视半径（n 变体），单位角秒 / n-parameterised apparent Jupiter semidiameter in arcseconds.
|
||
func SemidiameterN(date time.Time, n int) float64 { return defaultModule.SemidiameterN(date, n) }
|
||
|
||
// SetTime 落下时间，取 date 所在当地民用日 / set time, on the local civil day of date.
|
||
func SetTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
|
||
return defaultModule.SetTime(date, lon, lat, height, aero)
|
||
}
|
||
|
||
// SetTimeN 落下时间（n 变体） / n-parameterised set time.
|
||
func SetTimeN(date time.Time, lon, lat, height float64, aero bool, n int) (time.Time, error) {
|
||
return defaultModule.SetTimeN(date, lon, lat, height, aero, n)
|
||
}
|
||
|
||
// SunDistance 日心距离 / Sun distance.
|
||
func SunDistance(date time.Time) float64 { return defaultModule.SunDistance(date) }
|
||
|
||
// SunDistanceN 太阳距离（n 变体） / n-parameterised Sun distance.
|
||
func SunDistanceN(date time.Time, n int) float64 { return defaultModule.SunDistanceN(date, n) }
|
||
|
||
// Zenith 天顶距 / zenith distance.
|
||
func Zenith(date time.Time, lon, lat float64) float64 { return defaultModule.Zenith(date, lon, lat) }
|
||
|
||
// ZenithN 天顶距（n 变体） / n-parameterised zenith distance.
|
||
func ZenithN(date time.Time, lon, lat float64, n int) float64 {
|
||
return defaultModule.ZenithN(date, lon, lat, n)
|
||
}
|
||
|
||
// ApparentMagnitude2018 视星等（Mallama & Hilton 2018 模型）/ apparent magnitude, Mallama & Hilton 2018 model.
|
||
func ApparentMagnitude2018(date time.Time) float64 { return defaultModule.ApparentMagnitude2018(date) }
|