pub struct GravitationalField {
pub mu: f64,
pub r_ref: f64,
pub jn: Vec<f64>,
pub schwarzschild_r: f64,
pub kerr_spin_a: f64,
}Expand description
Gravitational field model (OCS §2.3).
Fields§
§mu: f64Standard gravitational parameter μ = GM (m³/s²).
r_ref: f64Reference radius for harmonic expansion (m).
jn: Vec<f64>Zonal harmonic coefficients J₂, J₃, …
schwarzschild_r: f64Schwarzschild radius r_s = 2GM/c² (m). Zero for non-relativistic bodies.
kerr_spin_a: f64Kerr spin parameter a = J/(Mc) (m). Zero for non-spinning bodies.
Implementations§
Source§impl GravitationalField
impl GravitationalField
Sourcepub fn newtonian(mu: f64, r_ref: f64) -> Self
pub fn newtonian(mu: f64, r_ref: f64) -> Self
Create a simple Newtonian field (no relativistic terms).
Sourcepub fn kerr_horizon_r(&self) -> f64
pub fn kerr_horizon_r(&self) -> f64
Kerr event horizon radius r₊ (OCS §2.3). r₊ = r_s/2 + sqrt((r_s/2)² - a²)
Sourcepub fn kerr_ergosphere_r(&self, theta: f64) -> f64
pub fn kerr_ergosphere_r(&self, theta: f64) -> f64
Kerr ergosphere boundary r_E(θ) at θ = π/2 (equator) (OCS §2.3). r_E(θ) = r_s/2 + sqrt((r_s/2)² - a²cos²θ)
Sourcepub fn frame_dragging(&self, r: f64) -> f64
pub fn frame_dragging(&self, r: f64) -> f64
Lense-Thirring frame-dragging precession frequency Ω_LT (OCS §2.3, Packet OCS-12).
Since $\mu = GM$ ($\text{m}^3/\text{s}^2$) and $a = J / (Mc)$ ($\text{m}$), $GJ = \mu c a$, so $\Omega_{\text{LT}} = \frac{2GJ}{c^2 r^3} = \frac{2\mu a}{c r^3}$ ($\text{rad/s}$).
Sourcepub fn shapiro_delay_s(&self, r1_m: [f64; 3], r2_m: [f64; 3]) -> f64
pub fn shapiro_delay_s(&self, r1_m: [f64; 3], r2_m: [f64; 3]) -> f64
First-order post-Newtonian (1PN) Shapiro gravitational time delay $\Delta t_{\text{Shapiro}}$ (s)
for a signal propagating from r1_m to r2_m past this gravitating body at the origin:
$$\Delta t_{\text{Shapiro}} = \frac{2\mu}{c_0^3} \ln!\left(\frac{r_1 + r_2 + R}{r_1 + r_2 - R}\right)$$
Sourcepub fn emf_manifold_causal_interval_s(
&self,
r1_m: [f64; 3],
r2_m: [f64; 3],
coord_dt_s: f64,
medium: &EmfMediumSpec,
) -> Result<(CausalConeRelation, MediumPropagationEstimate), &'static str>
pub fn emf_manifold_causal_interval_s( &self, r1_m: [f64; 3], r2_m: [f64; 3], coord_dt_s: f64, medium: &EmfMediumSpec, ) -> Result<(CausalConeRelation, MediumPropagationEstimate), &'static str>
Evaluate the relativistic causal interval and dispersive medium propagation estimate between two events $(\mathbf{r}_1, t_1)$ and $(\mathbf{r}_2, t_2 = t_1 + \Delta t)$ (§6.2.5.2).
Enforces:
- Vacuum speed $c_0 = 299,792,458\text{ m/s}$ defines the invariant causal cone.
- Signal group velocity satisfies $v_g \le c_0$ ($n_g \ge 1.0$).
- Phase velocity $v_p = c_0 / n_p$ may exceed $c_0$ in cold plasma ($n_p < 1$) without corrupting causal ordering.