Constants#

Scarabaeus defines both physical constants and planetary constants, tabulated below. Additionally, the source code definitions and their references are available further down under API Reference.

Physical Constants#

Name

Value

Units

G

6.6743e-20

km^3/(kg*sec^2)

L_tilde_GR

1.480827e-08

unitless

Stefan_Boltzmann

5.670374419e-08

kg/sec^3

TT_minus_TAI

32.184

sec

c

299792.458

km/sec

earth_rotation_rate

7.292115e-05

Hz

gamma_GR

1.0

unitless

omega_Earth

7.292115e-05

rad/sec

srp_constant1

102115339416981.84

(kg*km)/sec^2

srp_constant2

101979437570000.0

(kg*km)/sec^2

zero_Celsius

273.15

unitless

Major Bodies#

Body

SPICE ID

Mass (kg)

GM (km³/s²)

Mean Radius (km)

Eq. Radius (km)

Primary

Sun

10

1.9884e+30

1.32712e+11

696000.0

—

—

Mercury

199

3.3010e+23

22031.8

2439.7

2441

—

Venus

299

4.8673e+24

324859

6051.8

6052

—

Earth

399

5.9722e+24

398600

6371.0084

6378

—

Mars

499

6.4169e+23

42828.4

3389.5

3396

—

Jupiter

599

1.8981e+27

1.26687e+08

69911.0

7.149e+04

—

Saturn

699

5.6832e+26

3.79312e+07

58232.0

6.027e+04

—

Uranus

799

8.6810e+25

5.79395e+06

25362.0

2.556e+04

—

Neptune

899

1.0241e+26

6.8351e+06

24622.0

2.476e+04

—

Minor Bodies#

Body

SPICE ID

Mass (kg)

GM (km³/s²)

Mean Radius (km)

Eq. Radius (km)

Primary

Scheeres

20008887

6.2400e+14

4.16e-05

3.907

—

SUN

Deimos

402

1.4407e+15

9.61557e-05

6.0

—

Mars

McMahon

20046829

4.2900e+13

2.86e-06

1.6

—

SUN

Justitia

20000269

1.0488e+17

0.007

50.728

—

SUN

Mattia Pugliatti

2042042

6.2928e+17

0.042

4.2

—

SUN

Moon

301

7.3458e+22

4902.8

1737.4

1738

Earth

Phobos

401

1.0619e+16

0.000708755

11.4

—

Mars

Pluto

999

1.3029e+22

869.614

1195.0

1195

—

API Reference#

class Constants#

Constant values defined within Scarabaeus.

Notes

Contains physical constants and planetary constants.

DANIEL_SCHEERES = PCInfo(name='Scheeres', spice_name='SCHEERES', ref_name=None, body_center_id=20008887, barycenter_id=None, mass=624000000000000.0 kg, GM=4.16e-05 mu, mean_radius=3.907 km, equatorial_radius=None, GM_barycenter=None, primary_body='SUN')#

Planetary constants and related information for asteroid (8887) Scheeres, given as PCInfo.

Named in honor of Prof. Daniel J. Scheeres (ORCCA, CU Boulder), pioneer of small-body gravitational dynamics and orbital mechanics. Mean radius from NEOWISE thermal survey (diameter 7.814 +/- 0.071 km, albedo 0.187 +/- 0.014). GM estimated from assumed S-type bulk density of 2500 kg/m^3; no spacecraft measurement exists.

[1]

JPL Small-Body Database, https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=8887

DEIMOS = PCInfo(name='Deimos', spice_name='DEIMOS', ref_name='IAU_DEIMOS', body_center_id=402, barycenter_id=None, mass=1440685861906164.2 kg, GM=9.615569648120313e-05 mu, mean_radius=6.0 km, equatorial_radius=None, GM_barycenter=None, primary_body='Mars')#

Planetary constants and related information for Deimos, given as PCInfo.

EARTH = PCInfo(name='Earth', spice_name='EARTH', ref_name='ITRF93', body_center_id=399, barycenter_id=3, mass=5.972168398724898e+24 kg, GM=398600.435436096 mu, mean_radius=6371.0084 km, equatorial_radius=6378.1366 km, GM_barycenter=403503.23550226 mu, primary_body=None)#

Planetary constants and related information for Earth, given as PCInfo.

EARTH_OCEAN_LOADING = OceanLoadingInfo(tides=('M2', 'S2', 'N2', 'K2', 'K1', 'O1', 'P1', 'Q1', 'Mf', 'Mm', 'Ssa'), doodson=((2, 0, 0, 0, 0, 0), (2, 2, -2, 0, 0, 0), (2, -1, 0, 1, 0, 0), (2, 2, 0, 0, 0, 0), (1, 1, 0, 0, 0, 0), (1, -1, 0, 0, 0, 0), (1, 1, -2, 0, 0, 0), (1, -2, 0, 1, 0, 0), (0, 2, 0, 0, 0, 0), (0, 1, 0, -1, 0, 0), (0, 0, 2, 0, 0, 0)), schwiderski_phase=(0.0, 0.0, 0.0, 0.0, 90.0, -90.0, -90.0, -90.0, 0.0, 0.0, 0.0), fundamental_arguments={'l': (485866.733, 1717915922.633, 31.31, 0.064), "l'": (1287099.804, 129596581.244, -0.577, -0.012), 'F': (335778.877, 1739527263.137, -13.257, 0.011), 'D': (1072261.307, 1602961601.328, -6.891, 0.019), 'Omega': (450160.28, -6962890.539, 7.455, 0.008)}, nodal_factor=((1.0004, -0.0373, 0.0002, 0.0), (1.0, 0.0, 0.0, 0.0), (1.0004, -0.0373, 0.0002, 0.0), (1.0241, 0.2863, 0.0083, -0.0015), (1.006, 0.115, -0.0088, 0.0006), (1.0089, 0.1871, -0.0147, 0.0014), (1.0, 0.0, 0.0, 0.0), (1.0089, 0.1871, -0.0147, 0.0014), (1.0429, 0.4135, -0.004, 0.0), (1.0, -0.13, 0.0013, 0.0), (1.0, 0.0, 0.0, 0.0)), nodal_angle=((-2.14, 0.0, 0.0), (0.0, 0.0, 0.0), (-2.14, 0.0, 0.0), (-17.74, 0.68, -0.04), (-8.86, 0.68, -0.07), (10.8, -1.34, 0.19), (0.0, 0.0, 0.0), (10.8, -1.34, 0.19), (-23.74, 2.68, -0.38), (0.0, 0.0, 0.0), (0.0, 0.0, 0.0)), gmst_minus_era=(0.014506, 4612.156534, 1.3915817, -4.4e-07, -2.9956e-05, -3.68e-08))#

The eleven ocean-loading constituents, given as OceanLoadingInfo: Doodson numbers, Schwiderski phases, the IAU 1980 fundamental arguments, the nodal corrections of the lunar constituents, and the GMST that turns an Earth rotation angle into the Doodson variable \(\tau\).

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Section 5.

[2]

McCarthy, D.D. (1996). IERS Conventions (1996), IERS Technical Note 21, Chapter 7, routine ARG.

[3]

Pugh, D.T. (1987). Tides, Surges and Mean Sea-Level. Wiley, Table 4.3, after Schureman, P. (1958), Manual of Harmonic Analysis and Prediction of Tides, US Coast and Geodetic Survey SP 98.

[4]

Petit, G. and Luzum, B. (2010). IERS Conventions (2010), IERS Technical Note 36, eq. 5.32.

EARTH_POLE_TIDE = PoleTideInfo(love_h2=0.609, shida_l2=0.0852, c21=-1.7e-10, s21=1.19e-09, j2=0.00048417)#

Earth’s pole-tide constants, given as PoleTideInfo: the Love numbers and mean-pole harmonics of the JPL navigation formulation.

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Section 5.

EARTH_SOLID_TIDE = SolidTideInfo(love_h2=0.6078, shida_l2=0.0847, love_k={(2, 0): 0.29525, (2, 1): 0.2947, (2, 2): 0.29801, (3, 0): 0.093, (3, 1): 0.093, (3, 2): 0.093, (3, 3): 0.094}, tide_bodies=('MOON', 'SUN'), love_h3=0.292, shida_l3=0.015, love_h2_latitude=-0.0006, shida_l2_latitude=0.0002, out_of_phase_diurnal=(-0.0025, -0.0007), out_of_phase_semidiurnal=(-0.0022, -0.0007), shida_l1=(0.0012, 0.0024), mass_ratio_sun=332946.0482, mass_ratio_moon=0.0123000371, step2_diurnal=((-3, 0, 2, 0, 0, -0.01, 0, 0, 0), (-3, 2, 0, 0, 0, -0.01, 0, 0, 0), (-2, 0, 1, -1, 0, -0.02, 0, 0, 0), (-2, 0, 1, 0, 0, -0.08, 0, -0.01, 0.01), (-2, 2, -1, 0, 0, -0.02, 0, 0, 0), (-1, 0, 0, -1, 0, -0.1, 0, 0, 0), (-1, 0, 0, 0, 0, -0.51, 0, -0.02, 0.03), (-1, 2, 0, 0, 0, 0.01, 0, 0, 0), (0, -2, 1, 0, 0, 0.01, 0, 0, 0), (0, 0, -1, 0, 0, 0.02, 0, 0, 0), (0, 0, 1, 0, 0, 0.06, 0, 0, 0), (0, 0, 1, 1, 0, 0.01, 0, 0, 0), (0, 2, -1, 0, 0, 0.01, 0, 0, 0), (1, -3, 0, 0, 1, -0.06, 0, 0, 0), (1, -2, 0, -1, 0, 0.01, 0, 0, 0), (1, -2, 0, 0, 0, -1.23, -0.07, 0.06, 0.01), (1, -1, 0, 0, -1, 0.02, 0, 0, 0), (1, -1, 0, 0, 1, 0.04, 0, 0, 0), (1, 0, 0, -1, 0, -0.22, 0.01, 0.01, 0), (1, 0, 0, 0, 0, 12.0, -0.8, -0.67, -0.03), (1, 0, 0, 1, 0, 1.73, -0.12, -0.1, 0), (1, 0, 0, 2, 0, -0.04, 0, 0, 0), (1, 1, 0, 0, -1, -0.5, -0.01, 0.03, 0), (1, 1, 0, 0, 1, 0.01, 0, 0, 0), (0, 1, 0, 1, -1, -0.01, 0, 0, 0), (1, 2, -2, 0, 0, -0.01, 0, 0, 0), (1, 2, 0, 0, 0, -0.11, 0.01, 0.01, 0), (2, -2, 1, 0, 0, -0.01, 0, 0, 0), (2, 0, -1, 0, 0, -0.02, 0, 0, 0), (3, 0, 0, 0, 0, 0, 0, 0, 0), (3, 0, 0, 1, 0, 0, 0, 0, 0)), step2_long_period=((0, 0, 0, 1, 0, 0.47, 0.16, 0.23, 0.07), (0, 2, 0, 0, 0, -0.2, -0.11, -0.12, -0.05), (1, 0, -1, 0, 0, -0.11, -0.09, -0.08, -0.04), (2, 0, 0, 0, 0, -0.13, -0.15, -0.11, -0.07), (2, 0, 0, 1, 0, -0.05, -0.06, -0.05, -0.03)), step2_arguments={'s': (218.31664563, 481267.88194, -0.0014663889, 1.85139e-06), 'h': (280.46645, 36000.7697489, 0.00030322222, 2e-08, -6.54e-09), 'p': (83.35324312, 4069.01363525, -0.01032172222, -1.24991e-05, 5.263e-08), "N'": (234.95544499, 1934.13626197, -0.00207561111, -2.13944e-06, 1.65e-08), 'ps': (282.93734098, 1.71945766667, 0.00045688889, -1.778e-08, -3.34e-09), 'pr': (0.0, 1.396971278, 0.000308889, 2.1e-08, 7e-09), 'GMST': (280.4606184, 36000.7700536, 0.00038793, -2.58e-08)}, permanent_tide_radial=(-0.1206, 0.0001), permanent_tide_north=(-0.0252, -0.0001))#

Earth’s solid-tide constants, given as SolidTideInfo: the nominal Love and Shida numbers of Chapter 7, the potential Love numbers of Table 6.3, and every number of the DEHANTTIDEINEL routine.

[1]

IERS Conventions (2010), IERS Technical Note No. 36, Chapters 6 and 7, and the routine DEHANTTIDEINEL with ST1IDIU, ST1ISEM, ST1L1, STEP2DIU and STEP2LON (iers-conventions.obspm.fr).

G = 6.6743e-20 km^3/(kg*sec^2)#

Universal gravitational constant.

JAY_MCMAHON = PCInfo(name='McMahon', spice_name='MCMAHON', ref_name=None, body_center_id=20046829, barycenter_id=None, mass=42900000000000.0 kg, GM=2.86e-06 mu, mean_radius=1.6 km, equatorial_radius=None, GM_barycenter=None, primary_body='SUN')#

Planetary constants and related information for asteroid (46829) McMahon, given as PCInfo.

Named in honor of Prof. Jay W. McMahon (ORCCA, CU Boulder), co-developer of Scarabaeus. A main-belt binary system (1998 OS14); the radius is estimated from absolute magnitude H = 15.10 assuming S-type albedo ~0.15. GM estimated from assumed bulk density of 2500 kg/m^3; no spacecraft measurement exists.

[1]

JPL Small-Body Database, https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=46829

JUPITER = PCInfo(name='Jupiter', spice_name='JUPITER', ref_name='IAU_JUPITER', body_center_id=599, barycenter_id=5, mass=1.898124671078627e+27 kg, GM=126686534.92180079 mu, mean_radius=69911.0 km, equatorial_radius=71492.0 km, GM_barycenter=126712764.8 mu, primary_body=None)#

Planetary constants and related information for Jupiter, given as PCInfo.

JUSTITIA = PCInfo(name='Justitia', spice_name='JUSTITIA', ref_name=None, body_center_id=20000269, barycenter_id=None, mass=1.0487991250018728e+17 kg, GM=0.007 mu, mean_radius=50.728 km, equatorial_radius=None, GM_barycenter=None, primary_body='SUN')#

Planetary constants and related information for Justitia, given as PCInfo.

L_tilde_GR = 1.480827e-08 unitless#

L tilde constant for General Relativity.

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Monograph 2, Deep Space Communications and Navigation Series, pp. 4-13, Eq. 4-17.

MARS = PCInfo(name='Mars', spice_name='MARS', ref_name='IAU_MARS', body_center_id=499, barycenter_id=4, mass=6.416908682663213e+23 kg, GM=42828.37362069909 mu, mean_radius=3389.5 km, equatorial_radius=3396.19 km, GM_barycenter=42828.375214 mu, primary_body=None)#

Planetary constants and related information for Mars, given as PCInfo.

MATTIA_PUGLIATTI = PCInfo(name='Mattia Pugliatti', spice_name='MATTIA_PUGLIATTI', ref_name=None, body_center_id=2042042, barycenter_id=None, mass=6.292794750011237e+17 kg, GM=0.042 mu, mean_radius=4.2 km, equatorial_radius=None, GM_barycenter=None, primary_body='SUN')#

Planetary constants and related information for asteroid Mattia Pugliatti, given as PCInfo.

A fictitious S-type asteroid in the main belt, named in honor of Dr. Mattia Pugliatti (ORCCA, CU Boulder), co-developer of Scarabaeus. All physical parameters are suspiciously close to multiples of 42.

MERCURY = PCInfo(name='Mercury', spice_name='MERCURY', ref_name='IAU_MERCURY', body_center_id=199, barycenter_id=1, mass=3.300987369461969e+23 kg, GM=22031.78 mu, mean_radius=2439.7 km, equatorial_radius=2440.53 km, GM_barycenter=22031.78 mu, primary_body=None)#

Planetary constants and related information for Mercury, given as PCInfo.

MOON = PCInfo(name='Moon', spice_name='MOON', ref_name='IAU_MOON', body_center_id=301, barycenter_id=None, mass=7.345789170645305e+22 kg, GM=4902.8000661638 mu, mean_radius=1737.4 km, equatorial_radius=1738.14 km, GM_barycenter=None, primary_body='Earth')#

Planetary constants and related information for the Moon, given as PCInfo.

NEPTUNE = PCInfo(name='Neptune', spice_name='NEPTUNE', ref_name='IAU_NEPTUNE', body_center_id=899, barycenter_id=8, mass=1.0240923396370664e+26 kg, GM=6835099.502439672 mu, mean_radius=24622.0 km, equatorial_radius=24764.0 km, GM_barycenter=6836527.10058002 mu, primary_body=None)#

Planetary constants and related information for Neptune, given as PCInfo.

PHOBOS = PCInfo(name='Phobos', spice_name='PHOBOS', ref_name='IAU_PHOBOS', body_center_id=401, barycenter_id=None, mass=1.0619160161956238e+16 kg, GM=0.0007087546066894452 mu, mean_radius=11.4 km, equatorial_radius=None, GM_barycenter=None, primary_body='Mars')#

Planetary constants and related information for Phobos, given as PCInfo.

PLUTO = PCInfo(name='Pluto', spice_name='PLUTO', ref_name='IAU_PLUTO', body_center_id=999, barycenter_id=9, mass=1.3029288730816338e+22 kg, GM=869.6138177608749 mu, mean_radius=1195.0 km, equatorial_radius=1195.0 km, GM_barycenter=977.000000000001 mu, primary_body=None)#

Planetary constants and related information for Pluto, given as PCInfo.

RLT_BODIES = (('399', 398600.435436096 mu), ('301', 4902.8000661638 mu), ('4', 42828.375214 mu), ('5', 126712764.8 mu), ('6', 37940585.2 mu))#

Default bodies of the relativistic light-time delay, as (spice_id, GM) pairs, besides the Sun.

Earth and the Moon are taken at their centres, as the station sits next to them. Mars, Jupiter and Saturn are taken at their system barycentres with the system GM, so that only the planetary ephemeris is needed, not the satellite kernels. For a Mars orbiter (DSS-34 tracking, 2020-21 and 2025) this moves the round-trip light time by at most 2.1 ps, 0.63 mm of round-trip path, mostly Jupiter’s GM difference, and the 60 s X-band Doppler by less than 1e-6 mHz. Close to Jupiter or Saturn the barycentre is a poor stand-in for the planet (an orbiter at 1.1 planet radii sees up to 3 cm and 0.25 mHz), so pass the planet centres there.

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Monograph 2, Deep Space Communications and Navigation Series, Eq. 8-55.

SATURN = PCInfo(name='Saturn', spice_name='SATURN', ref_name='IAU_SATURN', body_center_id=699, barycenter_id=6, mass=5.683173890692993e+26 kg, GM=37931207.49865224 mu, mean_radius=58232.0 km, equatorial_radius=60268.0 km, GM_barycenter=37940585.2 mu, primary_body=None)#

Planetary constants and related information for Saturn, given as PCInfo.

SUN = PCInfo(name='Sun', spice_name='SUN', ref_name='IAU_SUN', body_center_id=10, barycenter_id=0, mass=1.9884098713264208e+30 kg, GM=132712440041.939 mu, mean_radius=696000.0 km, equatorial_radius=None, GM_barycenter=None, primary_body=None)#

Planetary constants and related information for the Sun, given as PCInfo. The mean and equatorial radii of the Sun are taken to be equivalent, and so only mean_radius is given.

Stefan_Boltzmann = 5.670374419e-08 kg/sec^3#

Stefan-Boltzmann constant.

Note that the units of the Stefan-Boltzmann constant are W/(m^2*K^4). ArrayWUnits does not support units of Kelvin (K), so the constant is returned in kg/s^3, or W/m^2, with the 1/K^4 omitted.

TT_minus_TAI = 32.184 sec#

Terrestrial Time minus International Atomic Time.

Exact by definition. It is ET - TAI in the local geocentric space-time frame, where the coordinate time is TT.

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Monograph 2, Deep Space Communications and Navigation Series, Sec. 2.3.

URANUS = PCInfo(name='Uranus', spice_name='URANUS', ref_name='IAU_URANUS', body_center_id=799, barycenter_id=7, mass=8.680987253013813e+25 kg, GM=5793951.322279009 mu, mean_radius=25362.0 km, equatorial_radius=25559.0 km, GM_barycenter=5794548.60000001 mu, primary_body=None)#

Planetary constants and related information for Uranus, given as PCInfo.

VENUS = PCInfo(name='Venus', spice_name='VENUS', ref_name='IAU_VENUS', body_center_id=299, barycenter_id=2, mass=4.867305814842005e+24 kg, GM=324858.592 mu, mean_radius=6051.8 km, equatorial_radius=6051.8 km, GM_barycenter=324858.592 mu, primary_body=None)#

Planetary constants and related information for Venus, given as PCInfo.

c = 299792.458 km/sec#

Speed of light in a vacuum.

day_per_julian_century = 36525.0#

Days per Julian century.

The IAU rotation models give the pole right ascension and declination as polynomials in Julian centuries past J2000, and the prime meridian in days past J2000.

day_to_sec = 86400.0#

Seconds per day.

deg_per_day_to_rad_per_sec = 2.0200570046230665e-07#

Radians per second per degree per day.

Prime-meridian rates (pole_pm) are carried in deg/day, as the IAU rotation models give them, while the dynamics run in rad/s.

earth_rotation_rate = 7.292115e-05 Hz#

Earth’s nominal mean angular velocity.

The IERS conventional value, used where a uniform rotation rate is adequate — converting a UT1 offset into an angle, for instance. Actual Earth rotation varies at the 1e-8 level and a kernel’s own orientation model carries that; this is not a substitute for it.

[1]

IERS Conventions (2010), IERS Technical Note No. 36, Table 1.1.

gamma_GR = 1.0 unitless#

Gamma constant for General Relativity.

[1]

Moyer, T.D. (2000). Formulation for Observed and Computed Values of Deep Space Network Data Types for Navigation. JPL Publication 00-7, Monograph 2, Deep Space Communications and Navigation Series, pp. 4-13, Eq. 4-17.

hour_to_sec = 3600.0#

Seconds per hour.

km_to_m = 1000.0#

Metres per kilometre.

Positions and the speed of light are kept in km and km/s, while the media models and the solar corona model work in metres. Multiply by this to go from km to m, divide by it to go from m to km.

min_to_sec = 60.0#

Seconds per minute.

omega_Earth = 7.292115e-05 rad/sec#

Nominal mean angular velocity of the Earth.

Used by the EOP partials to turn a UT1 correction into a station displacement along the direction of the Earth’s rotation.

[1]

Petit, G., Luzum, B. (eds.) (2010). IERS Conventions (2010), IERS Technical Note 36, Table 1.1.

srp_constant1 = 102115339416981.84 (kg*km)/sec^2#

SRP Constant #1.

srp_constant2 = 101979437570000.0 (kg*km)/sec^2#

SRP Constant #2.

zero_Celsius = 273.15 unitless#

Temperature of 0 degrees Celsius, in kelvin.

ArrayWUnits does not support units of Kelvin (K), so the value is stored unitless. A Celsius temperature \(t\) is \(t + 273.15\) K.

[1]

BIPM, The International System of Units (SI), 9th ed., 2019, Sec. 2.3.1.