|
|
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，纬度，北正南负
|
|
|
// aero，true时进行大气修正
|
|
|
func RiseTime(date time.Time, lon, lat 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)
|
|
|
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，纬度，北正南负
|
|
|
// aero，true时进行大气修正
|
|
|
func DownTime(date time.Time, lon, lat 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)
|
|
|
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
|
|
|
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
|
|
|
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))
|
|
|
}
|
|
|
|
|
|
// SeeLo 太阳视黄经
|
|
|
// 返回date对应UTC世界时的太阳视黄经
|
|
|
func SeeLo(date time.Time) float64 {
|
|
|
//转换为UTC时间
|
|
|
jde := basic.Date2JDE(date.UTC())
|
|
|
return basic.HSunSeeLo(basic.TD2UT(jde, true))
|
|
|
}
|
|
|
|
|
|
// SeeRa 太阳地心视赤经
|
|
|
// 返回date对应UTC世界时的太阳视赤经（使用黄道坐标转换，且默认忽略黄纬）
|
|
|
func SeeRa(date time.Time) float64 {
|
|
|
//转换为UTC时间
|
|
|
jde := basic.Date2JDE(date.UTC())
|
|
|
return basic.HSunSeeRa(basic.TD2UT(jde, true))
|
|
|
}
|
|
|
|
|
|
// SeeDec 太阳地心视赤纬
|
|
|
// 返回date对应UTC世界时的太阳视赤纬（使用黄道坐标转换，且默认忽略黄纬）
|
|
|
func SeeDec(date time.Time) float64 {
|
|
|
//转换为UTC时间
|
|
|
jde := basic.Date2JDE(date.UTC())
|
|
|
return basic.HSunSeeDec(basic.TD2UT(jde, true))
|
|
|
}
|
|
|
|
|
|
// SeeRaDec 太阳地心视赤经和赤纬
|
|
|
// 返回date对应UTC世界时的太阳视赤纬（使用黄道坐标转换，且默认忽略黄纬）
|
|
|
func SeeRaDec(date time.Time) (float64, float64) {
|
|
|
//转换为UTC时间
|
|
|
jde := basic.Date2JDE(date.UTC())
|
|
|
return basic.HSunSeeRaDec(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)
|
|
|
}
|