b612
044f2f4381
- 新增半解析、旧模型、自定义与多源堆叠星历实例，提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口，扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询，支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour，更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试，完善中英文手册、示例资源、NOTICE 与忽略规则
97 lines
3.9 KiB
Go
97 lines
3.9 KiB
Go
package venus
|
|
|
|
import (
|
|
"time"
|
|
|
|
"b612.me/astro/basic"
|
|
)
|
|
|
|
// TransitInfo 地心金星凌日信息 / geocentric Venus transit information.
|
|
//
|
|
// Start、Greatest、End、InternalStart、InternalEnd 都保持调用者输入的时区。
|
|
// 内切接触不存在时 InternalStart / InternalEnd 为零值。
|
|
// Start, Greatest, End, InternalStart, and InternalEnd preserve the caller's timezone.
|
|
// InternalStart and InternalEnd are zero values when internal contacts do not exist.
|
|
type TransitInfo struct {
|
|
Valid bool
|
|
|
|
Start time.Time
|
|
InternalStart time.Time
|
|
Greatest time.Time
|
|
InternalEnd time.Time
|
|
End time.Time
|
|
|
|
Duration time.Duration
|
|
InternalDuration time.Duration
|
|
|
|
MinimumSeparationArcsec float64
|
|
SunSemidiameterArcsec float64
|
|
PlanetSemidiameterArcsec float64
|
|
|
|
HasInternal bool
|
|
}
|
|
|
|
// NextTransit 下一次地心金星凌日 / next geocentric Venus transit.
|
|
func (module *Venus) NextTransit(date time.Time) TransitInfo {
|
|
return transitInfoFromBasic(basic.NextVenusTransitWithInstance(basic.Date2JD(date.UTC()), module.inst), date.Location())
|
|
}
|
|
|
|
// LastTransit 上一次地心金星凌日 / previous geocentric Venus transit.
|
|
func (module *Venus) LastTransit(date time.Time) TransitInfo {
|
|
return transitInfoFromBasic(basic.LastVenusTransitWithInstance(basic.Date2JD(date.UTC()), module.inst), date.Location())
|
|
}
|
|
|
|
// ClosestTransit 最近一次地心金星凌日 / closest geocentric Venus transit.
|
|
func (module *Venus) ClosestTransit(date time.Time) TransitInfo {
|
|
return transitInfoFromBasic(basic.ClosestVenusTransitWithInstance(basic.Date2JD(date.UTC()), module.inst), date.Location())
|
|
}
|
|
|
|
func transitInfoFromBasic(result basic.PlanetTransitResult, loc *time.Location) TransitInfo {
|
|
if !result.Valid {
|
|
return TransitInfo{}
|
|
}
|
|
start := basic.JD2DateByZone(result.ExternalIngress, loc, false)
|
|
greatest := basic.JD2DateByZone(result.Greatest, loc, false)
|
|
end := basic.JD2DateByZone(result.ExternalEgress, loc, false)
|
|
info := TransitInfo{
|
|
Valid: true,
|
|
Start: start,
|
|
Greatest: greatest,
|
|
End: end,
|
|
Duration: end.Sub(start),
|
|
MinimumSeparationArcsec: result.MinimumSeparationArcsec,
|
|
SunSemidiameterArcsec: result.SunSemidiameterArcsec,
|
|
PlanetSemidiameterArcsec: result.PlanetSemidiameterArcsec,
|
|
HasInternal: result.HasInternal,
|
|
}
|
|
if result.HasInternal {
|
|
info.InternalStart = basic.JD2DateByZone(result.InternalIngress, loc, false)
|
|
info.InternalEnd = basic.JD2DateByZone(result.InternalEgress, loc, false)
|
|
info.InternalDuration = info.InternalEnd.Sub(info.InternalStart)
|
|
}
|
|
return info
|
|
}
|
|
|
|
// LocalTransitInfo 站心金星凌日信息 / topocentric Venus transit information.
|
|
//
|
|
// 时刻保持调用者传入的 TransitInfo 的时区；太阳高度为几何中心高度，不含折射。
|
|
// Times keep the timezone of the supplied TransitInfo; Sun altitudes are geometric centre altitudes without refraction.
|
|
type LocalTransitInfo = basic.PlanetTransitLocalInfo
|
|
|
|
// LocalTransitContact 站心凌日接触 / topocentric transit contact.
|
|
type LocalTransitContact = basic.PlanetTransitLocalContactInfo
|
|
|
|
// LocalTransit 地心凌日 transit 在观测地的站心接触与凌甚 / topocentric contacts of transit seen from the site.
|
|
//
|
|
// lon、lat 为度，东经、北纬为正；height 为海拔米。
|
|
// lon and lat are in degrees, east and north positive; height is in meters.
|
|
func (module *Venus) LocalTransit(transit TransitInfo, lon, lat, height float64) LocalTransitInfo {
|
|
if !transit.Valid {
|
|
return LocalTransitInfo{}
|
|
}
|
|
result := basic.PlanetTransitResultFromTimes(2,
|
|
transit.Start, transit.InternalStart, transit.Greatest, transit.InternalEnd, transit.End)
|
|
local := basic.PlanetTransitLocalWithInstance(result, basic.Observer{Longitude: lon, Latitude: lat, Height: height}, module.inst)
|
|
return basic.PlanetTransitLocalInfoFromResult(local, transit.Greatest.Location())
|
|
}
|