feat: 引入可切换星历模型并扩展天象观测链路
- 新增半解析、旧模型、自定义与多源堆叠星历实例,提供 Context、Instance、SPK 读取及状态与视位置计算 - 统一太阳、月球和行星实例接口,扩展黄经穿越、留、相位、最近角距、偕日可见、任意高度升落、轨道节点及凌日等天象查询 - 完善日月食、月掩与凌日的月缘剖面、有限盘面接触、站心修正、局地可见性、全球路径和地图输出 - 新增 SVG、GeoJSON、KML 天象输出及凌日、月掩和月缘地形相关缓存与几何求解 - 新增恒星星表导入与查询,支持 CSV、Hipparcos、BSC5、Stellarium 等格式及名称、交叉标识、锥面检索和星等过滤 - 补充 IAU 2006、地球定向、折射消光、大气观测、轨道传播及半解析行星/月球数据支持 - 将默认未来民用时标切换为 TimeScaleLeapHour,更新 2027–2400 农历速查表、中文日期解析和时区边界处理 - 增加事件基线、跨模型回归、几何边界、月缘地形和输出契约测试,完善中英文手册、示例资源、NOTICE 与忽略规则
This commit is contained in:
@@ -0,0 +1,66 @@
|
||||
package basic
|
||||
|
||||
import "math"
|
||||
|
||||
const (
|
||||
riseSetWeatherMaxPressureHPa = 1200.0
|
||||
riseSetWeatherMinTemperatureC = -100.0
|
||||
riseSetWeatherMaxTemperatureC = 80.0
|
||||
)
|
||||
|
||||
// validRiseSetWeather 气压与气温须落在地表可能出现的量程内。
|
||||
func validRiseSetWeather(pressureHPa, temperatureC float64) bool {
|
||||
return pressureHPa > 0 && pressureHPa <= riseSetWeatherMaxPressureHPa &&
|
||||
temperatureC >= riseSetWeatherMinTemperatureC && temperatureC <= riseSetWeatherMaxTemperatureC
|
||||
}
|
||||
|
||||
type riseSetWeatherResidual func(jd, longitude, latitude, timeZone, zenithShift, height, pressureHPa, temperatureC float64, n int, inst *Instance) float64
|
||||
|
||||
// riseSetWithWeather 以标准气象结果为种子,在给定气压气温下重新求解同一民用日的升落;种子失效时按分钟扫描。
|
||||
func riseSetWithWeather(seed float64, seedErr error, julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC float64,
|
||||
isRise bool, n int, inst *Instance, residualAt riseSetWeatherResidual) (float64, error) {
|
||||
if !isFiniteFloat(julianDay) || !isFiniteFloat(longitude) || !isFiniteFloat(latitude) || !isFiniteFloat(timeZone) ||
|
||||
!isFiniteFloat(height) || !validRiseSetWeather(pressureHPa, temperatureC) {
|
||||
return 0, ErrInvalidObservationInput
|
||||
}
|
||||
civilDayStart := math.Floor(julianDay) + 0.5
|
||||
residual := func(jd float64) float64 {
|
||||
return residualAt(jd, longitude, latitude, timeZone, 1, height, pressureHPa, temperatureC, n, inst)
|
||||
}
|
||||
if seedErr == nil && isFiniteFloat(seed) {
|
||||
const derivativeStep = 0.000005
|
||||
slope := math.NaN()
|
||||
refined, ok := eventNewtonRefine(seed, 1e-7, func(jd float64) float64 {
|
||||
slope = (residual(jd+derivativeStep) - residual(jd-derivativeStep)) / (2 * derivativeStep)
|
||||
return residual(jd) / slope
|
||||
})
|
||||
if ok && math.Abs(refined-seed) < 0.02 && eventRiseSetCandidateValid(refined, civilDayStart, slope, isRise) {
|
||||
return refined, nil
|
||||
}
|
||||
}
|
||||
return eventDirectionalRiseSetSearch(civilDayStart, isRise, nil, residual)
|
||||
}
|
||||
|
||||
// GetSunRiseTimeWithAtmosphere 按给定气压(hPa)与气温(°C)计算日出,口径同 GetSunRiseTimeWithInstance 开启大气修正 / sunrise with explicit pressure and temperature.
|
||||
func GetSunRiseTimeWithAtmosphere(julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC float64, inst *Instance) (float64, error) {
|
||||
seed, err := GetSunRiseTimeWithInstance(julianDay, longitude, latitude, timeZone, 1, height, inst)
|
||||
return riseSetWithWeather(seed, err, julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC, true, -1, inst, sunRiseSetResidualWeather)
|
||||
}
|
||||
|
||||
// GetSunSetTimeWithAtmosphere 按给定气压(hPa)与气温(°C)计算日落 / sunset with explicit pressure and temperature.
|
||||
func GetSunSetTimeWithAtmosphere(julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC float64, inst *Instance) (float64, error) {
|
||||
seed, err := GetSunSetTimeWithInstance(julianDay, longitude, latitude, timeZone, 1, height, inst)
|
||||
return riseSetWithWeather(seed, err, julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC, false, -1, inst, sunRiseSetResidualWeather)
|
||||
}
|
||||
|
||||
// GetMoonRiseTimeWithAtmosphere 按给定气压(hPa)与气温(°C)计算月出 / moonrise with explicit pressure and temperature.
|
||||
func GetMoonRiseTimeWithAtmosphere(julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC float64, inst *Instance) (float64, error) {
|
||||
seed, err := GetMoonRiseTimeWithInstance(julianDay, longitude, latitude, timeZone, 1, height, inst)
|
||||
return riseSetWithWeather(seed, err, julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC, true, -1, inst, moonRiseSetResidualWeather)
|
||||
}
|
||||
|
||||
// GetMoonSetTimeWithAtmosphere 按给定气压(hPa)与气温(°C)计算月落 / moonset with explicit pressure and temperature.
|
||||
func GetMoonSetTimeWithAtmosphere(julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC float64, inst *Instance) (float64, error) {
|
||||
seed, err := GetMoonSetTimeWithInstance(julianDay, longitude, latitude, timeZone, 1, height, inst)
|
||||
return riseSetWithWeather(seed, err, julianDay, longitude, latitude, timeZone, height, pressureHPa, temperatureC, false, -1, inst, moonRiseSetResidualWeather)
|
||||
}
|
||||
Reference in New Issue
Block a user