Struct SphericalHarmonicGravity 

pub struct SphericalHarmonicGravity { /* private fields */ }

Fully normalized spherical-harmonic gravity perturbation.

The force is perturbation-only: degree 0 and degree 1 rows are ignored, and acceleration sums begin at degree 2.

Implementations

impl SphericalHarmonicGravity

pub fn egm96_degree_order_36() -> Result<SphericalHarmonicGravity, PropagationError>

Build the embedded EGM96 degree and order 36 model.

pub fn egm96_truncated( max_degree: u16, max_order: u16, ) -> Result<SphericalHarmonicGravity, PropagationError>

Build the embedded EGM96 model truncated to max_degree and max_order.

pub fn earth_egm96_truncated( max_degree: u16, max_order: u16, ) -> Result<SphericalHarmonicGravity, PropagationError>

Build an Earth-constant model over the embedded EGM96 coefficient table.

pub fn from_normalized_coefficients( mu_km3_s2: f64, reference_radius_km: f64, max_degree: u16, max_order: u16, coefficients: &[SphericalHarmonicCoefficient], ) -> Result<SphericalHarmonicGravity, PropagationError>

Build from caller-supplied fully normalized coefficients.

Coefficients above the requested degree or order are ignored. Degree 0 and 1 coefficients are ignored because this force contains only the perturbation sum from degree 2 upward.

pub fn from_normalized_ascii_table( mu_km3_s2: f64, reference_radius_km: f64, max_degree: u16, max_order: u16, table: &str, ) -> Result<SphericalHarmonicGravity, PropagationError>

Build from an ASCII coefficient table.

Accepted data rows are either n m Cnm Snm ... or gfc n m Cnm Snm .... Blank lines and lines beginning with # are ignored.

pub fn mu_km3_s2(&self) -> f64

Gravitational parameter, km^3/s^2.

pub fn reference_radius_km(&self) -> f64

Reference equatorial radius, km.

pub fn max_degree(&self) -> u16

Highest active degree.

pub fn max_order(&self) -> u16

Highest active order.

pub fn coefficient( &self, degree: u16, order: u16, ) -> Option<SphericalHarmonicCoefficient>

Return the coefficient at degree, order, if it lies inside the model.

pub fn body_fixed_acceleration_km_s2( &self, position_body_fixed_km: [f64; 3], ) -> Result<[f64; 3], PropagationError>

Evaluate the perturbation acceleration in the body-fixed frame.

Trait Implementations

impl Clone for SphericalHarmonicGravity

fn clone(&self) -> SphericalHarmonicGravity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SphericalHarmonicGravity

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

Formats the value using the given formatter.

impl Default for SphericalHarmonicGravity

fn default() -> SphericalHarmonicGravity

Returns the “default value” for a type.

impl ForceModel for SphericalHarmonicGravity

fn acceleration( &self, state: &CartesianState, ctx: &PropagationContext, ) -> Result<Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>, PropagationError>

impl PartialEq for SphericalHarmonicGravity

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SphericalHarmonicGravity