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 |
# static constant exports.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).
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. |
The rise, transit and set times
# 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 |
# 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
# 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
# static exports.getEccentricity(jd) → {Degree}
Computes the orbit eccentricity
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The orbit eccentricity
# static exports.getEclipticCoordinates(jd) → {EclipticCoordinates}
Heliocentric ecliptic coordinates
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# static exports.getEclipticLatitude(jd) → {Degree}
Ecliptic latitude
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# static exports.getEclipticLongitude(jd) → {Degree}
Ecliptic longitude
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# 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
# 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 |
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
# 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
# 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
# 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 |
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. |
The orbit inclination
# static exports.getInstantaneousVelocity(jd) → {KilometerPerSecond}
Computes the object instantaneous velocity in the orbit
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The velocity
# static exports.getLengthOfEllipse(jd) → {AstronomicalUnit}
Computes the object's length of orbit ellipse
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The ellipse length
# 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. |
The longitude of ascending node
# 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. |
The longitude of perihelion
# 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
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# 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. |
The mean longitude
# 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 |
# static exports.getPhaseAngle(jd) → {Degree}
Phase angle (angle Sun-planet-Earth).
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# 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
ArcSecond
# static exports.getRadiusVector(jd) → {AstronomicalUnit}
Radius vector (distance from the Sun)
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
# 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. |
The rise, transit and set times
# static exports.getSemiMajorAxis(jd) → {Degree}
Computes the orbit semi major axis at a given time.
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The semi major axis
# static exports.getVelocityAtAphelion(jd) → {KilometerPerSecond}
Computes the object's velocity at aphelion
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The velocity
# static exports.getVelocityAtPerihelion(jd) → {KilometerPerSecond}
Computes the object's velocity at perihelion
Parameters:
Name | Type | Description |
---|---|---|
jd |
JulianDay
|
The julian day |
The velocity