Skip to main content

Module celestial

Module celestial 

Source
Expand description

Celestial body taxonomy, relativistic gravito-electromagnetic propagation, and pulsar triangulation (OCS §2, §6.2.5.2).

Reference: OCS Specification v2.2.0 §2 & Playbook v4 §6.2.5.2.

Structs§

CelestialBodyProfile
A celestial body profile (OCS §2).
EmfMediumSpec
Electromagnetic medium specification for signal propagation vs causal geometry (§6.2.5.2).
GravitationalField
Gravitational field model (OCS §2.3).
MediumPropagationEstimate
Medium propagation estimate paired with invariant causal cone classification (§6.2.5.2).
PulsarAnchor
Millisecond pulsar timing anchor for deep-space BCRS navigation (OCS-12, §6.2.5.2).

Enums§

CausalConeRelation
Relativistic causal cone classification separated from medium signal arrival (§6.2.5.2).
CelestialBodyClass
Celestial body classification (OCS §2.1).
ReferenceSurface
Reference ellipsoid type (OCS §2.2).

Constants§

C0_VACUUM_M_S
Exact SI speed of light in vacuum $c_0$ (m/s).
PULSAR_DISPERSION_CONSTANT_MS_GHZ2
Cold-plasma pulsar dispersion constant $\mathcal{D} \approx 4.148808\text{ ms}\cdot\text{GHz}^2\cdot\text{pc}^{-1}\cdot\text{cm}^3$.

Functions§

body_profile_by_name
Look up a body profile by name (OCS §2).
dual_band_dedisperse_delay_s
Differential cold-plasma dispersion delay (s) between two radio carrier frequencies $f_1, f_2$ (§6.2.5.2):
earth_profile
Known celestial body profiles (OCS §2 examples).
emf_manifold_causal_interval_s
Convenience wrapper for GravitationalField::emf_manifold_causal_interval_s (§6.2.5.2).
europa_profile
Europa — icy moon with subsurface ocean (OCS §2.6).
infer_dispersion_measure_dual_band
Infer both the interstellar Dispersion Measure ($\text{pc}\cdot\text{cm}^{-3}$) and the infinite-frequency vacuum time of arrival $t_{\infty}$ (s) from dual-band TOAs $(t_1, f_1)$ and $(t_2, f_2)$.
jupiter_profile
Jupiter — gas giant (OCS §2.1).
mars_profile
Mars profile.
moon_profile
Earth’s Moon — natural satellite (OCS §2.1).
neutron_star_profile
Neutron star — compact relativistic object (OCS §2.1).
pulsar_dispersion_delay_s
Single-band cold-plasma dispersion delay (s) relative to infinite frequency (§6.2.5.2):
saturn_profile
Saturn — gas giant (OCS §2.1).
sgr_a_profile
Sagittarius A* — supermassive black hole (OCS §2.1, §2.3).
sun_profile
The Sun — main sequence star (OCS §2.1).
triangulate_from_pulsars
Triangulate 3D BCRS position $\mathbf{r} = [x, y, z]$ (m) from 4 pulsar phase observations (OCS-12, §6.2.5.2).