Documentation Github

Module

Saturn

Members

# static constant exports.constants

Planet constants, copied from the JPL Reference: https://ssd.jpl.nasa.gov/?planet_phys_par
Properties:
Name Type Description
equatorialRadius Kilometer Planet's equatorial radius
meanRadius Kilometer Planet's mean radius
mass Kilogram24 Planet's mass
bulkDensity GramPerCubicCentimeter Planet's bulk density
siderealRotationPeriod Day Planet's sidereal rotation period
siderealOrbitPeriod Year Planet's orbit rotation period
visualMagnitude Magnitude Planet's visual magnitude
geometricAlbedo Albedo Planet's geometric albedo
equatorialGravity MeterPerSquareSecond Planet's equatorial gravity
Planet's KilometerPerSecond escale velocity

View Source planets/saturn/constants.ts, line 21

# static constant orbitalElements

Orbital Elements for the mean equinox of date and std J2000 Reference: Astronomical Algorithms, J. Meus, pp. 212-215 (Table 31.A & 31.B).

View Source planets/saturn/constants.ts, line 37

Methods

# static exports.getAccurateRiseTransitSet(jd, geoCoords) → {RiseTransitSet}

Computes the accurate (better than a minute) times of the rise, transit and set of the planet.
Parameters:
Name Type Description
jd JulianDay The julian day
geoCoords GeographicCoordinates The observer location.

View Source planets/saturn/elliptical.ts, line 123

The rise, transit and set times
RiseTransitSet

# static exports.getAphelion(jd) → {JulianDay}

Aphelion (time of passage at the closest point to the Sun)
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/base.ts, line 15

JulianDay

# static exports.getApparentGeocentricEclipticCoordinates(jd) → {EclipticCoordinates}

Apparent geocentric ecliptic coordinates It takes into account for the effects of light-time travel & Earth nutation and annual aberration.
Parameters:
Name Type Description
jd JulianDay The julian day
See:
  • getEclipticCoordinates
  • getGeocentricEquatorialCoordinates

View Source planets/saturn/elliptical.ts, line 42

EclipticCoordinates

# static exports.getApparentGeocentricEquatorialCoordinates(jd) → {EquatorialCoordinates}

Apparent geocentric apparent equatorial coordinates It takes into account the effects of light-time travel & Earth nutation and annual aberration.
Parameters:
Name Type Description
jd JulianDay The julian day
See:
  • getEquatorialCoordinates
  • getGeocentricEclipticCoordinates

View Source planets/saturn/elliptical.ts, line 67

EquatorialCoordinates

# static exports.getEccentricity(jd) → {Degree}

Computes the orbit eccentricity
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/orbital.ts, line 30

The orbit eccentricity
Degree

# static exports.getEclipticCoordinates(jd) → {EclipticCoordinates}

Heliocentric ecliptic coordinates
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/coordinates.ts, line 82

EclipticCoordinates

# static exports.getEclipticLatitude(jd) → {Degree}

Ecliptic latitude
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/coordinates.ts, line 38

Degree

# static exports.getEclipticLongitude(jd) → {Degree}

Ecliptic longitude
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/coordinates.ts, line 15

Degree

# static exports.getEquatorialCoordinates(jd, obliquity) → {EquatorialCoordinates}

Heliocentric equatorial coordinates
Parameters:
Name Type Description
jd JulianDay The julian day
obliquity Obliquity The obliquity of the ecliptic: Mean (default) or True.
See:
  • getApparentEquatorialCoordinates

View Source planets/saturn/coordinates.ts, line 96

EquatorialCoordinates

# static exports.getEquatorialSemiDiameter(jd) → {ArcSecond}

Equatorial semi diameter of the planet. Note that values of the Astronomical Almanac of 1984 are returned. There are also older values (1980) named "A" values. In the case of Venus, the "B" value refers to the planet's crust, while the "A" value refers to the top of the cloud level. The latter is more relevant for astronomical phenomena such as transits and occultations.
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/details.ts, line 59

ArcSecond

# static exports.getGeocentricDistance(jd) → {AstronomicalUnit}

Geocentric distance (distance between the planet and Earth's center). It takes into account the effects of light-time travel & Earth nutation and annual aberration.
Parameters:
Name Type Description
jd JulianDay The julian day
See:
  • getEclipticCoordinates
  • getGeocentricEquatorialCoordinates

View Source planets/saturn/elliptical.ts, line 18

AstronomicalUnit

# static exports.getGeocentricEclipticCoordinates(jd) → {EclipticCoordinates}

Geocentric ecliptic coordinates It takes NO account for the effects of light-time travel & Earth nutation and annual aberration.
Parameters:
Name Type Description
jd JulianDay The julian day
See:
  • getEclipticCoordinates
  • getGeocentricEquatorialCoordinates

View Source planets/saturn/elliptical.ts, line 30

EclipticCoordinates

# static exports.getGeocentricEquatorialCoordinates(jd, obliquity) → {EquatorialCoordinates}

Geocentric equatorial coordinates It takes NO account for the effects of light-time travel & Earth nutation and annual aberration.
Parameters:
Name Type Description
jd JulianDay The julian day
obliquity Obliquity The obliquity of the ecliptic: Mean (default) or True.
See:
  • getEquatorialCoordinates
  • getGeocentricEclipticCoordinates

View Source planets/saturn/elliptical.ts, line 55

EquatorialCoordinates

# static exports.getIlluminatedFraction(jd) → {number}

Illuminated fraction of the planet as seen from the Earth. Between 0 and 1.
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/details.ts, line 26

number

# static exports.getInclination(jd, equinox) → {Degree}

Computes the orbit inclination
Parameters:
Name Type Description
jd JulianDay The julian day
equinox Equinox (optional) The equinox to be used: MeanOfTheDate (default) or StandardJ2000.

View Source planets/saturn/orbital.ts, line 40

The orbit inclination
Degree

# static exports.getInstantaneousVelocity(jd) → {KilometerPerSecond}

Computes the object instantaneous velocity in the orbit
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/elliptical.ts, line 76

The velocity
KilometerPerSecond

# static exports.getLengthOfEllipse(jd) → {AstronomicalUnit}

Computes the object's length of orbit ellipse
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/elliptical.ts, line 103

The ellipse length
AstronomicalUnit

# static exports.getLongitudeOfAscendingNode(jd, equinox) → {Degree}

Computes the longitude of the ascending node
Parameters:
Name Type Description
jd JulianDay The julian day
equinox Equinox (optional) The equinox to be used: MeanOfTheDate (default) or StandardJ2000.

View Source planets/saturn/orbital.ts, line 50

The longitude of ascending node
Degree

# static exports.getLongitudeOfPerihelion(jd, equinox) → {Degree}

Computes the longitude of the perihelion
Parameters:
Name Type Description
jd JulianDay The julian day
equinox Equinox (optional) The equinox to be used: MeanOfTheDate (default) or StandardJ2000.

View Source planets/saturn/orbital.ts, line 60

The longitude of perihelion
Degree

# static exports.getMagnitude(jd) → {Magnitude}

Magnitude of the planet, which depends on the planet's distance to the Earth, its distance to the Sun and the phase angle i (Sun-planet-Earth). Implementation return the modern American Astronomical Almanac value instead of Mueller's. Includes the contribution from the ring.
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/details.ts, line 39

Magnitude

# static exports.getMeanLongitude(jd, equinox) → {Degree}

Computes the orbit mean longitude at a given time.
Parameters:
Name Type Description
jd JulianDay The julian day
equinox Equinox (optional) The equinox to be used: MeanOfTheDate (default) or StandardJ2000.

View Source planets/saturn/orbital.ts, line 12

The mean longitude
Degree

# static exports.getPerihelion(jd) → {JulianDay}

Perihelion (time of passage at the farthest point to the Sun)
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/base.ts, line 25

JulianDay

# static exports.getPhaseAngle(jd) → {Degree}

Phase angle (angle Sun-planet-Earth).
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/details.ts, line 14

Degree

# static exports.getPolarSemiDiameter(jd) → {ArcSecond}

Polar semi diameter of the planet. See `equatorialSemiDiameter` about "A" et "B" values. Note that for all planets but Jupiter and Saturn, the polarSemiDiameter is identical to the equatorial one.
Parameters:
Name Type Description
jd JulianDay The julian day
See:
  • getEquatorialSemiDiameter

View Source planets/saturn/details.ts, line 72

ArcSecond

# static exports.getRadiusVector(jd) → {AstronomicalUnit}

Radius vector (distance from the Sun)
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/coordinates.ts, line 59

AstronomicalUnit

# static exports.getRingSystemDetails(jd) → {SaturnRingSystem}

The details of Saturn's ring system.
Parameters:
Name Type Description
jd JulianDay

View Source planets/saturn/ringSystem.ts, line 16

SaturnRingSystem

# static exports.getRiseTransitSet(jd, geoCoords) → {RiseTransitSet}

Computes the (low-accuracy but fast) times of the rise, transit and set of the planet.
Parameters:
Name Type Description
jd JulianDay The julian day
geoCoords GeographicCoordinates The observer location.

View Source planets/saturn/elliptical.ts, line 113

The rise, transit and set times
RiseTransitSet

# static exports.getSemiMajorAxis(jd) → {Degree}

Computes the orbit semi major axis at a given time.
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/orbital.ts, line 21

The semi major axis
Degree

# static exports.getVelocityAtAphelion(jd) → {KilometerPerSecond}

Computes the object's velocity at aphelion
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/elliptical.ts, line 94

The velocity
KilometerPerSecond

# static exports.getVelocityAtPerihelion(jd) → {KilometerPerSecond}

Computes the object's velocity at perihelion
Parameters:
Name Type Description
jd JulianDay The julian day

View Source planets/saturn/elliptical.ts, line 85

The velocity
KilometerPerSecond