change delta T formula and add planet phenomena function

2022-05-16 20:42:15 +08:00
parent bb07e23238
commit 97c017be08
38 changed files with 4700 additions and 779 deletions
@@ -2,69 +2,239 @@ package saturn

 import (
 	"b612.me/astro/basic"
+	"b612.me/astro/calendar"
 	"b612.me/astro/planet"
+	"errors"
+	"time"
 )

-/*
-  土星视黄经
-  jde: 世界时UTC
-*/
-func SeeLo(jde float64) float64 {
-	return basic.SaturnSeeLo(basic.TD2UT(jde, true))
+var (
+	ERR_SATURN_NEVER_RISE = errors.New("ERROR:极夜，木星今日永远在地平线下！")
+	ERR_SATURN_NEVER_DOWN = errors.New("ERROR:极昼，木星今日永远在地平线上！")
+)
+
+// ApparentLo 视黄经
+func ApparentLo(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
+	return basic.SaturnApparentLo(basic.TD2UT(jde, true))
 }

-/*
-  土星视黄纬
-  jde: 世界时UTC
-*/
-func SeeBo(jde float64) float64 {
-	return basic.SaturnSeeBo(basic.TD2UT(jde, true))
+// ApparentBo 视黄纬
+func ApparentBo(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
+	return basic.SaturnApparentBo(basic.TD2UT(jde, true))
 }

-/*
-  土星视赤经
-  jde: 世界时UTC
-*/
-func SeeRa(jde float64) float64 {
-	return basic.SaturnSeeRa(basic.TD2UT(jde, true))
+// ApparentRa 视赤经
+func ApparentRa(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
+	return basic.SaturnApparentRa(basic.TD2UT(jde, true))
 }

-/*
-  土星视赤纬
-  jde: 世界时UTC
-*/
-func SeeDec(jde float64) float64 {
-	return basic.SaturnSeeDec(basic.TD2UT(jde, true))
+// ApparentDec 视赤纬
+func ApparentDec(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
+	return basic.SaturnApparentDec(basic.TD2UT(jde, true))
 }

-/*
-  土星视赤经赤纬
-  jde: 世界时UTC
-*/
-func SeeRaDec(jde float64) (float64, float64) {
-	return basic.SaturnSeeRaDec(basic.TD2UT(jde, true))
+// ApparentRaDec 视赤经赤纬
+func ApparentRaDec(date time.Time) (float64, float64) {
+	jde := calendar.Date2JDE(date)
+	return basic.SaturnApparentRaDec(basic.TD2UT(jde, true))
 }

-/*
-  土星视星等
-  jde: 世界时UTC
-*/
-func SeeMag(jde float64) float64 {
+// ApparentMagnitude 视星等
+func ApparentMagnitude(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
 	return basic.SaturnMag(basic.TD2UT(jde, true))
 }

-/*
-  与地球距离（天文单位）
-  jde: 世界时UTC
-*/
-func EarthAway(jde float64) float64 {
+// EarthDistance 与地球距离（天文单位）
+func EarthDistance(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
 	return basic.EarthSaturnAway(basic.TD2UT(jde, true))
 }

-/*
-  与太阳距离（天文单位）
-  jde: 世界时UTC
-*/
-func SunAway(jde float64) float64 {
-	return planet.WherePlanet(1, 2, basic.TD2UT(jde, true))
+// EarthDistance 与太阳距离（天文单位）
+func SunDistance(date time.Time) float64 {
+	jde := calendar.Date2JDE(date)
+	return planet.WherePlanet(5, 2, basic.TD2UT(jde, true))
+}
+
+// Zenith 高度角
+func Zenith(date time.Time, lon, lat float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	return basic.SaturnHeight(jde, lon, lat, timezone)
+}
+
+// Azimuth 方位角
+func Azimuth(date time.Time, lon, lat float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	return basic.SaturnAzimuth(jde, lon, lat, timezone)
+}
+
+// HourAngle 时角
+// 返回给定经纬度、对应date时区date时刻的时角（
+func HourAngle(date time.Time, lon float64) float64 {
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	return basic.SaturnHourAngle(jde, lon, timezone)
+}
+
+// CulminationTime 中天时间
+// 返回给定经纬度、对应date时区date时刻的中天日期
+func CulminationTime(date time.Time, lon float64) time.Time {
+	if date.Hour() > 12 {
+		date = date.Add(time.Hour * -12)
+	}
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	calcJde := basic.SaturnCulminationTime(jde, lon, timezone) - timezone/24.00
+	return basic.JDE2DateByZone(calcJde, date.Location(), false)
+}
+
+// RiseTime 升起时间
+// date，取日期，时区忽略
+// lon，经度，东正西负
+// lat，纬度，北正南负
+// height，高度
+// aero，true时进行大气修正
+func RiseTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
+	var err error
+	var aeroFloat float64
+	if aero {
+		aeroFloat = 1
+	}
+	if date.Hour() > 12 {
+		date = date.Add(time.Hour * -12)
+	}
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	riseJde := basic.SaturnRiseTime(jde, lon, lat, timezone, aeroFloat, height)
+	if riseJde == -2 {
+		err = ERR_SATURN_NEVER_RISE
+	}
+	if riseJde == -1 {
+		err = ERR_SATURN_NEVER_DOWN
+	}
+	return basic.JDE2DateByZone(riseJde, date.Location(), true), err
+}
+
+// DownTime 落下时间
+// date，取日期，时区忽略
+// lon，经度，东正西负
+// lat，纬度，北正南负
+// height，高度
+// aero，true时进行大气修正
+func DownTime(date time.Time, lon, lat, height float64, aero bool) (time.Time, error) {
+	var err error
+	var aeroFloat float64
+	if aero {
+		aeroFloat = 1
+	}
+	if date.Hour() > 12 {
+		date = date.Add(time.Hour * -12)
+	}
+	jde := basic.Date2JDE(date)
+	_, loc := date.Zone()
+	timezone := float64(loc) / 3600.0
+	riseJde := basic.SaturnDownTime(jde, lon, lat, timezone, aeroFloat, height)
+	if riseJde == -2 {
+		err = ERR_SATURN_NEVER_RISE
+	}
+	if riseJde == -1 {
+		err = ERR_SATURN_NEVER_DOWN
+	}
+	return basic.JDE2DateByZone(riseJde, date.Location(), true), err
+}
+
+// LastConjunction 上次合日时间
+// 返回上次合日时间
+func LastConjunction(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnConjunction(jde), date.Location(), false)
+}
+
+// NextConjunction 下次合日时间
+// 返回下次合日时间
+func NextConjunction(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnConjunction(jde), date.Location(), false)
+}
+
+// LastOpposition 上次冲日时间
+// 返回上次冲日时间
+func LastOpposition(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnOpposition(jde), date.Location(), false)
+}
+
+// NextOpposition 下次冲日时间
+// 返回下次冲日时间
+func NextOpposition(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnOpposition(jde), date.Location(), false)
+}
+
+// LastProgradeToRetrograde 上次留（顺转逆）
+// 返回上次顺转逆留的时间
+func LastProgradeToRetrograde(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnProgradeToRetrograde(jde), date.Location(), false)
+}
+
+// NextProgradeToRetrograde 下次留（顺转逆）
+// 返回下次顺转逆留的时间
+func NextProgradeToRetrograde(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnProgradeToRetrograde(jde), date.Location(), false)
+}
+
+// LastRetrogradeToPrograde 上次留（逆转瞬）
+// 返回上次逆转瞬留的时间
+func LastRetrogradeToPrograde(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnRetrogradeToPrograde(jde), date.Location(), false)
+}
+
+// NextRetrogradeToPrograde 上次留（逆转瞬）
+//// 返回上次逆转瞬留的时间
+func NextRetrogradeToPrograde(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnRetrogradeToPrograde(jde), date.Location(), false)
+}
+
+// LastEasternQuadrature 上次东方照时间
+// 返回上次东方照时间
+func LastEasternQuadrature(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnEasternQuadrature(jde), date.Location(), false)
+}
+
+// NextEasternQuadrature 下次东方照时间
+// 返回下次东方照时间
+func NextEasternQuadrature(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnEasternQuadrature(jde), date.Location(), false)
+}
+
+// LastWesternQuadrature 上次西方照时间
+// 返回上次西方照时间
+func LastWesternQuadrature(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.LastSaturnWesternQuadrature(jde), date.Location(), false)
+}
+
+// NextWesternQuadrature 下次西方照时间
+// 返回下次西方照时间
+func NextWesternQuadrature(date time.Time) time.Time {
+	jde := basic.TD2UT(basic.Date2JDE(date.UTC()), true)
+	return basic.JDE2DateByZone(basic.NextSaturnWesternQuadrature(jde), date.Location(), false)
 }