276 lines
7.8 KiB
Go
276 lines
7.8 KiB
Go
package sun
|
||
|
||
import (
|
||
"errors"
|
||
"math"
|
||
"time"
|
||
|
||
"b612.me/astro/basic"
|
||
)
|
||
|
||
var (
|
||
ERR_SUN_NEVER_RISE = errors.New("ERROR:极夜，太阳在今日永远在地平线下！")
|
||
ERR_SUN_NEVER_DOWN = errors.New("ERROR:极昼，太阳在今日永远在地平线上！")
|
||
ERR_TWILIGHT_NOT_EXISTS = errors.New("ERROR:今日晨昏朦影不存在！")
|
||
)
|
||
|
||
/*
|
||
太阳
|
||
视星等 −26.74
|
||
绝对星等 4.839
|
||
光谱类型 G2V
|
||
金属量 Z = 0.0122
|
||
角直径 31.6′ – 32.7′
|
||
*/
|
||
|
||
// 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.GetSunRiseTime(jde, lon, lat, timezone, aeroFloat, height)
|
||
if riseJde == -2 {
|
||
err = ERR_SUN_NEVER_RISE
|
||
}
|
||
if riseJde == -1 {
|
||
err = ERR_SUN_NEVER_DOWN
|
||
}
|
||
return basic.JDE2DateByZone(riseJde, date.Location(), true), err
|
||
}
|
||
|
||
// SunDownTime 太阳落下时间
|
||
// 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
|
||
downJde := basic.GetSunDownTime(jde, lon, lat, timezone, aeroFloat, height)
|
||
if downJde == -2 {
|
||
err = ERR_SUN_NEVER_RISE
|
||
}
|
||
if downJde == -1 {
|
||
err = ERR_SUN_NEVER_DOWN
|
||
}
|
||
return basic.JDE2DateByZone(downJde, date.Location(), true), err
|
||
}
|
||
|
||
// MorningTwilight 晨朦影
|
||
// date，当地时区日期
|
||
// lon，经度，东正西负
|
||
// lat，纬度，北正南负
|
||
// angle，朦影角度：可选-6 -12 -18(民用、航海、天文)
|
||
func MorningTwilight(date time.Time, lon, lat, angle float64) (time.Time, error) {
|
||
var err error
|
||
if date.Hour() > 12 {
|
||
date = date.Add(time.Hour * -12)
|
||
}
|
||
jde := basic.Date2JDE(date)
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
calcJde := basic.GetAsaTime(jde, lon, lat, timezone, angle)
|
||
if calcJde == -2 {
|
||
err = ERR_TWILIGHT_NOT_EXISTS
|
||
}
|
||
if calcJde == -1 {
|
||
err = ERR_TWILIGHT_NOT_EXISTS
|
||
}
|
||
return basic.JDE2Date(calcJde), err
|
||
}
|
||
|
||
// EveningTwilight 昏朦影
|
||
// date，当地时区日期
|
||
// lon，经度，东正西负
|
||
// lat，纬度，北正南负
|
||
// angle，朦影角度：可选-6 -12 -18(民用、航海、天文)
|
||
func EveningTwilight(date time.Time, lon, lat, angle float64) (time.Time, error) {
|
||
var err error
|
||
if date.Hour() > 12 {
|
||
date = date.Add(time.Hour * -12)
|
||
}
|
||
jde := basic.Date2JDE(date)
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
//不需要进行力学时转换，会在GetBanTime中转换
|
||
calcJde := basic.GetBanTime(jde, lon, lat, timezone, angle)
|
||
if calcJde == -2 {
|
||
err = ERR_TWILIGHT_NOT_EXISTS
|
||
}
|
||
if calcJde == -1 {
|
||
err = ERR_TWILIGHT_NOT_EXISTS
|
||
}
|
||
return basic.JDE2Date(calcJde), err
|
||
}
|
||
|
||
// EclipticObliquity 黄赤交角
|
||
// 返回date对应UTC世界时的黄赤交角，nutation为true时，计算交角章动
|
||
func EclipticObliquity(date time.Time, nutation bool) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
//进行力学时转换
|
||
jde = basic.TD2UT(jde, true)
|
||
//黄赤交角计算
|
||
return basic.EclipticObliquity(jde, nutation)
|
||
}
|
||
|
||
// EclipticNutation 黄经章动
|
||
// 返回date对应UTC世界时的黄经章动
|
||
func EclipticNutation(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
//进行力学时转换与章动计算
|
||
return basic.HJZD(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// AxialtiltNutation 交角章动
|
||
// 返回date对应UTC世界时的交角章动
|
||
func AxialtiltNutation(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
//进行力学时转换与章动计算
|
||
return basic.JJZD(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// GeometricLo 太阳几何黄经
|
||
// 返回date对应UTC世界时的太阳几何黄经
|
||
func GeometricLo(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.SunLo(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// TrueLo 太阳真黄经
|
||
// 返回date对应UTC世界时的太阳真黄经
|
||
func TrueLo(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunTrueLo(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// TrueBo 太阳真黄纬
|
||
// 返回date对应UTC世界时的太阳真黄纬
|
||
func TrueBo(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunTrueLo(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// ApparentLo 太阳视黄经
|
||
// 返回date对应UTC世界时的太阳视黄经
|
||
func ApparentLo(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunApparentLo(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// ApparentRa 太阳地心视赤经
|
||
// 返回date对应UTC世界时的太阳视赤经（使用黄道坐标转换，且默认忽略黄纬）
|
||
func ApparentRa(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunApparentRa(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// ApparentDec 太阳地心视赤纬
|
||
// 返回date对应UTC世界时的太阳视赤纬（使用黄道坐标转换，且默认忽略黄纬）
|
||
func ApparentDec(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunApparentDec(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// ApparentRaDec 太阳地心视赤经和赤纬
|
||
// 返回date对应UTC世界时的太阳视赤纬（使用黄道坐标转换，且默认忽略黄纬）
|
||
func ApparentRaDec(date time.Time) (float64, float64) {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.HSunApparentRaDec(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// MidFunc 太阳中间方程
|
||
func MidFunc(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.SunMidFun(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// EquationTime 均时差
|
||
// 返回date对应UTC世界时的均时差
|
||
func EquationTime(date time.Time) float64 {
|
||
//转换为UTC时间
|
||
jde := basic.Date2JDE(date.UTC())
|
||
return basic.SunTime(basic.TD2UT(jde, true))
|
||
}
|
||
|
||
// HourAngle 太阳时角
|
||
// 返回给定经纬度、对应date时区date时刻的太阳时角（
|
||
func HourAngle(date time.Time, lon, lat float64) float64 {
|
||
jde := basic.Date2JDE(date)
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
return basic.SunTimeAngle(jde, lon, lat, timezone)
|
||
}
|
||
|
||
// Azimuth 太阳方位角
|
||
// 返回给定经纬度、对应date时区date时刻的太阳方位角（正北为0，向东增加）
|
||
func Azimuth(date time.Time, lon, lat float64) float64 {
|
||
jde := basic.Date2JDE(date)
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
return basic.SunAngle(jde, lon, lat, timezone)
|
||
}
|
||
|
||
// Zenith 太阳高度角
|
||
// 返回给定经纬度、对应date时区date时刻的太阳高度角
|
||
func Zenith(date time.Time, lon, lat float64) float64 {
|
||
jde := basic.Date2JDE(date)
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
return basic.SunHeight(jde, lon, lat, timezone)
|
||
}
|
||
|
||
// CulminationTime 太阳中天时间
|
||
// 返回给定经纬度、对应date时区date时刻的太阳中天日期
|
||
func CulminationTime(date time.Time, lon float64) time.Time {
|
||
jde := basic.Date2JDE(date)
|
||
if jde-math.Floor(jde) > 0.5 {
|
||
jde++
|
||
}
|
||
_, loc := date.Zone()
|
||
timezone := float64(loc) / 3600.0
|
||
calcJde := basic.GetSunTZTime(jde, lon, timezone) - timezone/24.00
|
||
return basic.JDE2DateByZone(calcJde, date.Location(), false)
|
||
}
|
||
|
||
// EarthDistance 日地距离
|
||
// 返回date对应UTC世界时日地距离
|
||
func EarthDistance(date time.Time) float64 {
|
||
jde := basic.Date2JDE(date.UTC())
|
||
jde = basic.TD2UT(jde, true)
|
||
return basic.EarthAway(jde)
|
||
}
|