Documentation
¶
Overview ¶
Package astronomy is an observer-aware Go astronomy library: sun, moon, star, and constellation positions with twilight bands, arc tracks, and moon phases.
This root package holds the shared domain types (Observer, Horizontal, Position, AngularDiameter) used across the body-specific packages. The heavy math lives in unexported internal packages built on the meeus ephemeris algorithms.
Example (FlightNYCToLondon) ¶
A moving observer passes its position and height for each instant. Here a flight from New York (JFK) to London (LHR) on the June solstice, leaving at 00:00 UTC and cruising at 36000 ft: from altitude the Sun clears the dipped horizon before it rises for anyone on the ground below.
package main
import (
"fmt"
"math"
"time"
astronomy "github.com/Bugs5382/go-astronomy"
"github.com/Bugs5382/go-astronomy/earth"
)
func main() {
jfk := [2]float64{40.64, -73.78}
lhr := [2]float64{51.47, -0.45}
depart := time.Date(2027, 6, 21, 0, 0, 0, 0, time.UTC)
const flight = 7 * time.Hour
for _, f := range []float64{0, 0.25, 0.5, 0.7, 0.75, 1} {
lat, lng := greatCircle(jfk, lhr, f)
height := astronomy.Feet(36000)
if f == 0 || f == 1 {
height = astronomy.SeaLevel // on the runway
}
obs := astronomy.Observer{Lat: lat, Lng: lng, Height: height}
when := depart.Add(time.Duration(f * float64(flight)))
sun := earth.SunPosition(obs, when)
// The Sun is up when its centre clears the refracted horizon, which
// the dip lowers for an observer at height.
horizon := earth.HorizonAltitude - earth.HorizonDip(obs.Height)
ground := sun.Altitude > earth.HorizonAltitude
fmt.Printf("%s %6.2f %7.2f %6.0f ft sun %6.2f up in the air %-5v on the ground %v\n",
when.Format("15:04"), lat, lng, obs.Height.Feet(), sun.Altitude, sun.Altitude > horizon, ground)
}
}
// greatCircle returns the point a fraction f of the way from a to b along the
// great circle, as latitude and longitude in degrees.
func greatCircle(a, b [2]float64, f float64) (float64, float64) {
const r = math.Pi / 180
la1, lo1, la2, lo2 := a[0]*r, a[1]*r, b[0]*r, b[1]*r
d := math.Acos(math.Sin(la1)*math.Sin(la2) + math.Cos(la1)*math.Cos(la2)*math.Cos(lo2-lo1))
s1, s2 := math.Sin((1-f)*d)/math.Sin(d), math.Sin(f*d)/math.Sin(d)
x := s1*math.Cos(la1)*math.Cos(lo1) + s2*math.Cos(la2)*math.Cos(lo2)
y := s1*math.Cos(la1)*math.Sin(lo1) + s2*math.Cos(la2)*math.Sin(lo2)
z := s1*math.Sin(la1) + s2*math.Sin(la2)
return math.Atan2(z, math.Hypot(x, y)) / r, math.Atan2(y, x) / r
}
Output: 00:00 40.64 -73.78 0 ft sun 3.98 up in the air true on the ground true 01:45 47.58 -59.32 36000 ft sun -12.86 up in the air false on the ground false 03:30 52.22 -41.30 36000 ft sun -13.76 up in the air false on the ground false 04:54 53.64 -24.90 36000 ft sun -2.43 up in the air true on the ground false 05:15 53.64 -20.70 36000 ft sun 1.66 up in the air true on the ground true 07:00 51.47 -0.45 0 ft sun 26.78 up in the air true on the ground true
Example (HeightByHand) ¶
By hand: a height in feet or metres, used as given. New York at 5000 ft is not the real ground, and that is allowed.
package main
import (
"fmt"
"time"
astronomy "github.com/Bugs5382/go-astronomy"
"github.com/Bugs5382/go-astronomy/earth"
)
// sunrise returns the start of the sunrise band on the civil day of date.
func sunrise(obs astronomy.Observer, date time.Time) time.Time {
day, err := earth.NewSunTimes(obs, date)
if err != nil {
panic(err)
}
for _, s := range day.Segments() {
if s.Label == earth.LabelSunrise {
return s.From
}
}
return time.Time{}
}
func main() {
date := time.Date(2027, 6, 21, 12, 0, 0, 0, time.UTC)
nyc := astronomy.Observer{Lat: 40.71, Lng: -74.01, TZ: time.UTC}
high := astronomy.Observer{Lat: 40.71, Lng: -74.01, TZ: time.UTC, Height: astronomy.Feet(5000)}
same := astronomy.Observer{Lat: 40.71, Lng: -74.01, TZ: time.UTC, Height: astronomy.Meters(1524)}
fmt.Println("5000 ft is", high.Height, "and equal to Meters(1524):", high == same)
fmt.Printf("dip %.3f degrees\n", earth.HorizonDip(high.Height))
fmt.Printf("sunrise %.1f minutes earlier\n", sunrise(nyc, date).Sub(sunrise(high, date)).Minutes())
}
Output: 5000 ft is 1524 m and equal to Meters(1524): true dip 1.145 degrees sunrise 7.2 minutes earlier
Example (Lookup) ¶
Lookup: a chain tries a height the caller already has, then a fixed value, and falls back to sea level only when nothing answers. The Open-Meteo lookup (package openmeteo) slots into the same chain.
package main
import (
"context"
"fmt"
astronomy "github.com/Bugs5382/go-astronomy"
)
func main() {
ctx := context.Background()
weatherHeight, haveIt := astronomy.Meters(0), false // no reading this time
resolver := astronomy.ChainElevation(
astronomy.CallerElevation(weatherHeight, haveIt),
astronomy.StaticElevation(astronomy.Meters(21)),
)
obs, source, err := astronomy.ResolveObserverWith(ctx, resolver, 40.71, -74.01)
if err != nil {
panic(err) // only for a cancelled or expired ctx
}
fmt.Println(obs.Height, "from", source)
obs, source, _ = astronomy.ResolveObserverWith(ctx, astronomy.ChainElevation(), 40.71, -74.01)
fmt.Println(obs.Height, "from", source)
}
Output: 21 m from static 0 m from sea-level
Example (SeaLevel) ¶
Always sea level: an observer with no height. Nothing is looked up.
package main
import (
"fmt"
"time"
astronomy "github.com/Bugs5382/go-astronomy"
"github.com/Bugs5382/go-astronomy/earth"
)
// sunrise returns the start of the sunrise band on the civil day of date.
func sunrise(obs astronomy.Observer, date time.Time) time.Time {
day, err := earth.NewSunTimes(obs, date)
if err != nil {
panic(err)
}
for _, s := range day.Segments() {
if s.Label == earth.LabelSunrise {
return s.From
}
}
return time.Time{}
}
func main() {
nyc := astronomy.Observer{Lat: 40.71, Lng: -74.01, TZ: time.UTC}
fmt.Println("height:", nyc.Height)
fmt.Println("sunrise:", sunrise(nyc, time.Date(2027, 6, 21, 12, 0, 0, 0, time.UTC)).Format("15:04:05 MST"))
}
Output: height: 0 m sunrise: 09:25:00 UTC
Index ¶
Examples ¶
Constants ¶
const ( // CodeInvalidLatitude marks an observer latitude outside [-90, 90]. CodeInvalidLatitude = 7001 // CodeInvalidLongitude marks an observer longitude outside [-180, 180]. CodeInvalidLongitude = 7002 // CodeInvalidSegmentation marks a Segmentation whose levels are empty or not // in strictly ascending altitude order. CodeInvalidSegmentation = 7003 // CodeInvalidMagnitudeRange marks a stellar magnitude query whose bright // bound is fainter than its faint bound, which can select no star. CodeInvalidMagnitudeRange = 7004 // CodeInvalidCanvas marks a screen projection whose canvas width or height is // not positive, so it spans no pixels. CodeInvalidCanvas = 7005 // CodeInvalidHorizonFraction marks a viewport whose horizon fraction is // outside [0, 1], so the horizon line would fall off the canvas. CodeInvalidHorizonFraction = 7006 // CodeInvalidPeakAltitude marks a NormalizedByPeak projection whose peak // altitude is not positive, which cannot normalize an arch. CodeInvalidPeakAltitude = 7007 // CodeInvalidFieldOfView marks an azimuth-based projection whose field of view // (Directional) or sunrise-to-sunset azimuth span (FullArc) is not positive. CodeInvalidFieldOfView = 7008 // CodeInvalidElevationScale marks a Geometric projection whose elevation // degrees-per-pixel is not positive. CodeInvalidElevationScale = 7009 // CodeXModeNotAzimuth marks a column-to-azimuth inverse query on a projection // whose horizontal mode is not azimuth-based, so no azimuth axis exists. CodeXModeNotAzimuth = 7010 // CodeInvalidHeight marks an observer Height that is NaN or infinite. CodeInvalidHeight = 7011 // CodeInvalidElements marks a satellite element set (TLE or OMM) that // could not be parsed. CodeInvalidElements = 7014 // CodeSatellitePropagation marks an element set SGP4 could not propagate // to the requested instant, such as a satellite that has decayed. CodeSatellitePropagation = 7015 // CodeInvalidPassWindow marks a pass search whose end is not after its // start, or which spans more than 31 days. CodeInvalidPassWindow = 7016 )
Stable numeric error codes for the module. Each error-returning function wraps its cause with one of these via go-apperr, so a caller can recover the code with apperr.Code and branch on it without matching error strings. The values are part of the public contract: never renumber a code, only add new ones.
const ( // SourceCaller is a height the caller already had (CallerElevation). SourceCaller = "caller" // SourceStatic is a fixed, configured height (StaticElevation). SourceStatic = "static" // SourceOpenMeteo is a height from the Open-Meteo elevation API. SourceOpenMeteo = "open-meteo" // SourceSeaLevel means no resolver produced a height, so the answer is // sea level. SourceSeaLevel = "sea-level" )
Sources an ElevationResolver reports for the height it returns.
const ErrorServiceDigit = 7
ErrorServiceDigit is the leading digit that every go-astronomy error code shares, so a code is attributable to this module at a glance. It is the go-apperr service prefix for the module's code namespace.
const MetersPerFoot = 0.3048
MetersPerFoot is the international foot, exactly.
Variables ¶
var ErrInvalidHeight = errors.New("astronomy: height is not a finite number")
ErrInvalidHeight is the cause when a Height is NaN or infinite; the coded error carries CodeInvalidHeight.
var SeaLevel = Height{}
SeaLevel is the zero Height, and the height of an Observer that gives none.
Functions ¶
func Errors ¶
Errors returns the module's go-apperr registry: the stable code table plus the presentation and logging policy around it. A consumer renders a coded error at its edge with Registry.Present (or PresentContext, which also drives the wired go-log logger) to obtain a sanitized, quotable message, looks a code up with Registry.Describe, or emits the whole table as Markdown with Registry.Markdown. The registry is built once and is safe for concurrent use.
Types ¶
type AngularDiameter ¶
type AngularDiameter float64
AngularDiameter is the apparent angular size of a body's disc, in degrees.
func (AngularDiameter) Radius ¶
func (a AngularDiameter) Radius() float64
Radius returns half the angular diameter, in degrees.
type ElevationResolver ¶ added in v1.1.0
type ElevationResolver interface {
Elevation(ctx context.Context, lat, lng float64) (Height, string, error)
}
ElevationResolver finds the height of the ground at a coordinate (degrees, latitude positive north and longitude positive east).
Elevation returns the height and the source that produced it. A resolver that cannot produce a height, for any reason, returns SeaLevel and SourceSeaLevel instead of an error: a missing height is never fatal. The error is only for a cancelled or expired context, which it returns with SeaLevel. Implementations must be safe for concurrent use.
func CallerElevation ¶ added in v1.1.0
func CallerElevation(h Height, ok bool) ElevationResolver
CallerElevation returns a resolver for a height the caller may already have, such as the ground elevation in a weather reading: with ok set it answers h with SourceCaller, and with ok unset it reports sea level so a chain moves on to the next resolver.
func ChainElevation ¶ added in v1.1.0
func ChainElevation(resolvers ...ElevationResolver) ElevationResolver
ChainElevation returns a resolver that asks each of resolvers in order and returns the first answer that is not SourceSeaLevel, with that resolver's source. When every resolver reports sea level, so does the chain; it only falls back at the end. A done context stops the chain with its error.
func StaticElevation ¶ added in v1.1.0
func StaticElevation(h Height) ElevationResolver
StaticElevation returns a resolver that always answers h, with SourceStatic, whatever the coordinate: for a fixed installation whose height is configured. A NaN or infinite h is no answer, so the resolver reports sea level.
type Height ¶ added in v1.1.0
type Height struct {
// contains filtered or unexported fields
}
Height is a height above sea level. Build one with Meters or Feet; the zero value is SeaLevel. Any real value is valid as given: below sea level (the Dead Sea shore is -430 m), on a mountain, or in flight. Only NaN and the infinities are invalid (see Err), and the functions that take an observer reject them with ErrInvalidHeight.
A Height is stored in metres, the unit every calculation uses.
func Feet ¶ added in v1.1.0
Feet returns the height of ft feet above sea level (one foot is 0.3048 m).
func (Height) Err ¶ added in v1.1.0
Err returns the coded ErrInvalidHeight for a NaN or infinite height, and nil for every real value.
type Horizontal ¶
Horizontal is a direction in the local horizontal (alt-az) frame. Azimuth is measured clockwise from true north and Altitude is the angle above the horizon; both are in degrees. A negative Altitude is below the horizon.
func (Horizontal) AboveHorizon ¶
func (h Horizontal) AboveHorizon() bool
AboveHorizon reports whether the direction is above the geometric horizon.
type Observer ¶
type Observer struct {
// Lat is the geographic latitude in degrees, positive north, in [-90, 90].
Lat float64
// Lng is the geographic longitude in degrees, positive east, in [-180, 180].
Lng float64
// TZ is the observer's local time zone. A nil value is treated as UTC.
TZ *time.Location
// Height is the observer's height above sea level, optional: the zero
// value is SeaLevel, which reproduces the sea-level answers exactly and
// needs no lookup. Set it with Meters or Feet, or look it up with an
// ElevationResolver (see ResolveObserverWith).
//
// From height the sea horizon lies below the astronomical horizon by the
// dip (see earth.HorizonDip), so the Sun and Moon rise earlier and set
// later; the height also enters their parallax. The dip assumes an
// unobstructed sea horizon. For an observer in motion, such as a plane,
// pass the position and height for each instant to each call.
Height Height
}
Observer is a location on the Earth's surface for which celestial positions are computed. Time is never captured here; it is always supplied as a parameter to the calculation functions, keeping the library stateless.
func ResolveObserverWith ¶ added in v1.1.0
func ResolveObserverWith(ctx context.Context, r ElevationResolver, lat, lng float64) (Observer, string, error)
ResolveObserverWith returns an observer at the coordinate with its height from r, and the source that produced it. The time zone is left nil (UTC); set TZ on the result. The error is only for a cancelled or expired context; every lookup failure falls back to sea level with SourceSeaLevel.
type Position ¶
type Position struct {
Horizontal
Diameter AngularDiameter
}
Position is the apparent placement of a body: the direction to the center of its disc paired with the disc's apparent angular size. Pairing the center with the angular diameter lets a consumer size and place the disc and reason about alignment and overlap between bodies.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package constellation identifies which of the 88 IAU constellations a celestial position falls in, and lists the constellations.
|
Package constellation identifies which of the 88 IAU constellations a celestial position falls in, and lists the constellations. |
|
Package earth adds Earth-bound conventions on top of the universal solar geometry in the sun package: named twilight bands, sunrise and sunset, solar noon, polar states, and atmospheric refraction.
|
Package earth adds Earth-bound conventions on top of the universal solar geometry in the sun package: named twilight bands, sunrise and sunset, solar noon, polar states, and atmospheric refraction. |
|
moon
Package moon provides the Earth vantage on Luna, the Earth's moon: its topocentric horizontal position and apparent size, its phase and illumination, its rise and set for an observer, and an arc track over a time span.
|
Package moon provides the Earth vantage on Luna, the Earth's moon: its topocentric horizontal position and apparent size, its phase and illumination, its rise and set for an observer, and an arc track over a time span. |
|
internal
|
|
|
angles
Package angles provides small, dependency-free helpers for working with angles expressed in degrees: conversion to and from radians, normalization into the range [0, 360), and clamping of declinations to [-90, 90].
|
Package angles provides small, dependency-free helpers for working with angles expressed in degrees: conversion to and from radians, normalization into the range [0, 360), and clamping of declinations to [-90, 90]. |
|
cmd/genvsop
command
Command genvsop generates the truncated VSOP87 tables in internal/ephemeris.
|
Command genvsop generates the truncated VSOP87 tables in internal/ephemeris. |
|
coordinates
Package coordinates converts celestial positions between the ecliptic, equatorial, and local horizontal (alt-az) frames.
|
Package coordinates converts celestial positions between the ecliptic, equatorial, and local horizontal (alt-az) frames. |
|
ephemeris
Package ephemeris implements the astronomical series this library needs, ported directly rather than pulled in as a dependency.
|
Package ephemeris implements the astronomical series this library needs, ported directly rather than pulled in as a dependency. |
|
julian
Package julian converts civil instants into the time quantities the ephemeris math depends on: the Julian Date, Greenwich and local mean sidereal time, and the mean obliquity of the ecliptic.
|
Package julian converts civil instants into the time quantities the ephemeris math depends on: the Julian Date, Greenwich and local mean sidereal time, and the mean obliquity of the ecliptic. |
|
planetary
Package planetary reduces a planet's VSOP87 table to what an observer on Earth sees: the light-time, the apparent place, the phase, the magnitude, and rise, set, and transit.
|
Package planetary reduces a planet's VSOP87 table to what an observer on Earth sees: the light-time, the apparent place, the phase, the magnitude, and rise, set, and transit. |
|
planettest
Package planettest holds the checks every planet package runs against the committed JPL Horizons fixtures in planet/testdata.
|
Package planettest holds the checks every planet package runs against the committed JPL Horizons fixtures in planet/testdata. |
|
vsop87
Package vsop87 evaluates the VSOP87 planetary theory: the series types the generated tables are written in, and the sum that turns a table into a heliocentric position.
|
Package vsop87 evaluates the VSOP87 planetary theory: the series types the generated tables are written in, and the sum that turns a table into a heliocentric position. |
|
Package openmeteo looks an observer's height up from the Open-Meteo elevation API (https://open-meteo.com/en/docs/elevation-api), which is worldwide, free, and needs no key, and serves the Copernicus DEM at 90 m.
|
Package openmeteo looks an observer's height up from the Open-Meteo elevation API (https://open-meteo.com/en/docs/elevation-api), which is worldwide, free, and needs no key, and serves the Copernicus DEM at 90 m. |
|
Package planet holds the types every planet package shares: the result of placing a planet for an observer, the heliocentric position, the Body interface each planet satisfies, and the errors they return.
|
Package planet holds the types every planet package shares: the result of placing a planet for an observer, the heliocentric position, the Body interface each planet satisfies, and the errors they return. |
|
all
Package all lists every planet package, for a caller who wants to iterate over the planets or pick one by name.
|
Package all lists every planet package, for a caller who wants to iterate over the planets or pick one by name. |
|
jupiter
Package jupiter places Jupiter in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Jupiter's heliocentric position.
|
Package jupiter places Jupiter in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Jupiter's heliocentric position. |
|
mars
Package mars places Mars in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Mars's heliocentric position.
|
Package mars places Mars in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Mars's heliocentric position. |
|
mercury
Package mercury places Mercury in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Mercury's heliocentric position.
|
Package mercury places Mercury in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Mercury's heliocentric position. |
|
neptune
Package neptune places Neptune in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Neptune's heliocentric position.
|
Package neptune places Neptune in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Neptune's heliocentric position. |
|
saturn
Package saturn places Saturn in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Saturn's heliocentric position.
|
Package saturn places Saturn in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Saturn's heliocentric position. |
|
uranus
Package uranus places Uranus in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Uranus's heliocentric position.
|
Package uranus places Uranus in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Uranus's heliocentric position. |
|
venus
Package venus places Venus in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Venus's heliocentric position.
|
Package venus places Venus in an observer's sky: topocentric apparent position, apparent diameter, phase, magnitude, elongation from the Sun, rise, set, and transit, and Venus's heliocentric position. |
|
Package project maps already-computed celestial positions, expressed in degrees, to canvas pixels.
|
Package project maps already-computed celestial positions, expressed in degrees, to canvas pixels. |
|
Package satellite places Earth satellites, the International Space Station among them, in an observer's sky from an element set the caller supplies.
|
Package satellite places Earth satellites, the International Space Station among them, in an observer's sky from an element set the caller supplies. |
|
celestrak
Package celestrak fetches satellite element sets from CelesTrak's GP API (https://celestrak.org/NORAD/elements/gp.php) as CCSDS OMM JSON, for a caller who wants the current set rather than supplying its own.
|
Package celestrak fetches satellite element sets from CelesTrak's GP API (https://celestrak.org/NORAD/elements/gp.php) as CCSDS OMM JSON, for a caller who wants the current set rather than supplying its own. |
|
horizons
Package horizons fetches spacecraft ephemerides from the JPL Horizons API (https://ssd.jpl.nasa.gov/api/horizons.api), for objects SGP4 and two-line element sets cannot describe, such as the telescopes at the Sun-Earth L2 point (satellite/jwst, satellite/roman).
|
Package horizons fetches spacecraft ephemerides from the JPL Horizons API (https://ssd.jpl.nasa.gov/api/horizons.api), for objects SGP4 and two-line element sets cannot describe, such as the telescopes at the Sun-Earth L2 point (satellite/jwst, satellite/roman). |
|
hubble
Package hubble follows the Hubble Space Telescope: its position in an observer's sky and its passes, propagated with SGP4 from an element set.
|
Package hubble follows the Hubble Space Telescope: its position in an observer's sky and its passes, propagated with SGP4 from an element set. |
|
iss
Package iss follows the International Space Station: its position in an observer's sky and its passes, propagated with SGP4 from an element set.
|
Package iss follows the International Space Station: its position in an observer's sky and its passes, propagated with SGP4 from an element set. |
|
jwst
Package jwst places the James Webb Space Telescope in an observer's sky, from JPL Horizons.
|
Package jwst places the James Webb Space Telescope in an observer's sky, from JPL Horizons. |
|
roman
Package roman places the Nancy Grace Roman Space Telescope in an observer's sky, from JPL Horizons.
|
Package roman places the Nancy Grace Roman Space Telescope in an observer's sky, from JPL Horizons. |
|
tiangong
Package tiangong follows the Tiangong space station (the Tianhe core module carries the station's catalogue entry): its position in an observer's sky and its passes, propagated with SGP4 from an element set.
|
Package tiangong follows the Tiangong space station (the Tianhe core module carries the station's catalogue entry): its position in an observer's sky and its passes, propagated with SGP4 from an element set. |
|
Package star provides a universal, observer-independent catalog of stars: the quantities that belong to a star itself, not to any vantage.
|
Package star provides a universal, observer-independent catalog of stars: the quantities that belong to a star itself, not to any vantage. |
|
Package sun provides universal Sun physics: quantities that depend only on the Sun itself, not on any observer, atmosphere, or vantage body.
|
Package sun provides universal Sun physics: quantities that depend only on the Sun itself, not on any observer, atmosphere, or vantage body. |