PINE LIBRARY

Ephemeris

Library "Ephemeris"
TODO: add library description here

mercuryElements()

mercuryRates()

venusElements()

venusRates()

earthElements()

earthRates()

marsElements()

marsRates()

jupiterElements()

jupiterRates()

saturnElements()

saturnRates()

uranusElements()

uranusRates()

neptuneElements()

neptuneRates()

rev360(x)
Normalize degrees to within [0, 360)
Parameters:
x (float): degrees to be normalized
Returns: Normalized degrees

scaleAngle(longitude, magnitude, harmonic)
Scale angle in degrees
Parameters:
longitude (float)
magnitude (float)
harmonic (int)
Returns: Scaled angle in degrees

julianCenturyInJulianDays()
Constant Julian days per century
Returns: 36525

julianEpochJ2000()
Julian date on J2000 epoch start (2000-01-01)
Returns: 2451545.0

meanObliquityForJ2000()
Mean obliquity of the ecliptic on J2000 epoch start (2000-01-01)
Returns: 23.43928

getJulianDate(Year, Month, Day, Hour, Minute)
Convert calendar date to Julian date
Parameters:
Year (int): calendar year as integer (e.g. 2018)
Month (int): calendar month (January = 1, December = 12)
Day (int): calendar day of month (e.g. January valid days are 1-31)
Hour (int): valid values 0-23
Minute (int): valid values 0-60

julianCenturies(date, epoch_start)
Centuries since Julian Epoch 2000-01-01
Parameters:
date (float): Julian date to conver to Julian centuries
epoch_start (float): Julian date of epoch start (e.g. J2000 epoch = 2451545)
Returns: Julian date converted to Julian centuries

julianCenturiesSinceEpochJ2000(julianDate)
Calculate Julian centuries since epoch J2000 (2000-01-01)
Parameters:
julianDate (float): Julian Date in days
Returns: Julian centuries since epoch J2000 (2000-01-01)

atan2(y, x)
Specialized arctan function
Parameters:
y (float): radians
x (float): radians
Returns: special arctan of y/x

eccAnom(ec, m_param, dp)
Compute eccentricity of the anomaly
Parameters:
ec (float): Eccentricity of Orbit
m_param (float): Mean Anomaly ?
dp (int): Decimal places to round to
Returns: Eccentricity of the Anomaly

planetEphemerisCalc(TGen, planetElementId, planetRatesId)
Compute planetary ephemeris (longtude relative to Earth or Sun) on a Julian date
Parameters:
TGen (float): Julian Date
planetElementId (float[]): All planet orbital elements in an array. This index references a specific planet's elements.
planetRatesId (float[]): All planet orbital rates in an array. This index references a specific planet's rates.
Returns: [xGen, yGen, zGen, rGen] X,Y,Z ecliptic rectangular coordinates and R radius from reference body.

calculateRightAscensionAndDeclination(earthX, earthY, earthZ, planetX, planetY, planetZ)
Calculate right ascension and declination for a planet relative to Earth
Parameters:
earthX (float): Earth X ecliptic rectangular coordinate relative to Sun
earthY (float): Earth Y ecliptic rectangular coordinate relative to Sun
earthZ (float): Earth Z ecliptic rectangular coordinate relative to Sun
planetX (float): Planet X ecliptic rectangular coordinate relative to Sun
planetY (float): Planet Y ecliptic rectangular coordinate relative to Sun
planetZ (float): Planet Z ecliptic rectangular coordinate relative to Sun
Returns: [distPlanet, raPlanetDegrees, decPlanet] Planet geocentric orbital radius, geocentric right ascension, and geocentric declination

mercuryHelio(T)
Compute Mercury heliocentric longitude on date
Parameters:
T (float)
Returns: Mercury heliocentric longitude on date

venusHelio(T)
Compute Venus heliocentric longitude on date
Parameters:
T (float)
Returns: Venus heliocentric longitude on date

earthHelio(T)
Compute Earth heliocentric longitude on date
Parameters:
T (float)
Returns: Earth heliocentric longitude on date

marsHelio(T)
Compute Mars heliocentric longitude on date
Parameters:
T (float)
Returns: Mars heliocentric longitude on date

jupiterHelio(T)
Compute Jupiter heliocentric longitude on date
Parameters:
T (float)
Returns: Jupiter heliocentric longitude on date

saturnHelio(T)
Compute Saturn heliocentric longitude on date
Parameters:
T (float)
Returns: Saturn heliocentric longitude on date

neptuneHelio(T)
Compute Neptune heliocentric longitude on date
Parameters:
T (float)
Returns: Neptune heliocentric longitude on date

uranusHelio(T)
Compute Uranus heliocentric longitude on date
Parameters:
T (float)
Returns: Uranus heliocentric longitude on date

sunGeo(T)
Parameters:
T (float)

mercuryGeo(T)
Parameters:
T (float)

venusGeo(T)
Parameters:
T (float)

marsGeo(T)
Parameters:
T (float)

jupiterGeo(T)
Parameters:
T (float)

saturnGeo(T)
Parameters:
T (float)

neptuneGeo(T)
Parameters:
T (float)

uranusGeo(T)
Parameters:
T (float)

moonGeo(T_JD)
Parameters:
T_JD (float)

mercuryOrbitalPeriod()
Mercury orbital period in Earth days
Returns: 87.9691

venusOrbitalPeriod()
Venus orbital period in Earth days
Returns: 224.701

earthOrbitalPeriod()
Earth orbital period in Earth days
Returns: 365.256363004

marsOrbitalPeriod()
Mars orbital period in Earth days
Returns: 686.980

jupiterOrbitalPeriod()
Jupiter orbital period in Earth days
Returns: 4332.59

saturnOrbitalPeriod()
Saturn orbital period in Earth days
Returns: 10759.22

uranusOrbitalPeriod()
Uranus orbital period in Earth days
Returns: 30688.5

neptuneOrbitalPeriod()
Neptune orbital period in Earth days
Returns: 60195.0

jupiterSaturnCompositePeriod()

jupiterNeptuneCompositePeriod()

jupiterUranusCompositePeriod()

saturnNeptuneCompositePeriod()

saturnUranusCompositePeriod()

planetSineWave(julianDateInCenturies, planetOrbitalPeriod, planetHelio)
Convert heliocentric longitude of planet into a sine wave
Parameters:
julianDateInCenturies (float)
planetOrbitalPeriod (float): Orbital period of planet in Earth days
planetHelio (float): Heliocentric longitude of planet in degrees
Returns: Sine of heliocentric longitude on a Julian date