Skip to main content

GravitationalField

Struct GravitationalField 

Source
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: f64

Standard gravitational parameter μ = GM (m³/s²).

§r_ref: f64

Reference radius for harmonic expansion (m).

§jn: Vec<f64>

Zonal harmonic coefficients J₂, J₃, …

§schwarzschild_r: f64

Schwarzschild radius r_s = 2GM/c² (m). Zero for non-relativistic bodies.

§kerr_spin_a: f64

Kerr spin parameter a = J/(Mc) (m). Zero for non-spinning bodies.

Implementations§

Source§

impl GravitationalField

Source

pub fn newtonian(mu: f64, r_ref: f64) -> Self

Create a simple Newtonian field (no relativistic terms).

Source

pub fn kerr_horizon_r(&self) -> f64

Kerr event horizon radius r₊ (OCS §2.3). r₊ = r_s/2 + sqrt((r_s/2)² - a²)

Source

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²θ)

Source

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}$).

Source

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)$$

Source

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:

  1. Vacuum speed $c_0 = 299,792,458\text{ m/s}$ defines the invariant causal cone.
  2. Signal group velocity satisfies $v_g \le c_0$ ($n_g \ge 1.0$).
  3. Phase velocity $v_p = c_0 / n_p$ may exceed $c_0$ in cold plasma ($n_p < 1$) without corrupting causal ordering.

Trait Implementations§

Source§

impl Clone for GravitationalField

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for GravitationalField

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl PartialEq for GravitationalField

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for GravitationalField

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<T> Downcast<T> for T

§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> Upcast<T> for T

§

fn upcast(&self) -> Option<&T>

§

impl<T> WasmNotSend for T
where T: Send,

§

impl<T> WasmNotSendSync for T
where T: WasmNotSend + WasmNotSync,

§

impl<T> WasmNotSync for T
where T: Sync,