Struct nyx_space::dynamics::momentum::AngularMom

pub struct AngularMom { /* fields omitted */ }

AngularMom exposes the equations of motion for the angular momentum of a rigid body.

Methods

impl AngularMom

pub fn from_tensor_matrix(
    tensor: &Matrix3<f64>,
    velocity: &Vector3<f64>
) -> AngularMom

Initializes a new AngularMom struct with an time-invariant inertia tensor of a rigid body and its original angular velocity.

Throughout this documentation [I] refers to the inertia tensor and ω to the angular velocity. NOTE: The provided inertia tensor must be expressed in a frame such that it is a diagonal matrix. There is always such a frame. If this is not the primary frame desired, use the parallel axis theorem. This theorem is developped in Schaub & Junkins, "Analytical Mechanics of Space Systems", 3th ed., page 163, section 4.2.2 "Inertia Matrix Properties". This function will panic! if the inertia tensor is not diagonal.

pub fn momentum(&self) -> Vector3<f64>

Returns the angular momentum of the system, i.e. [I]ω

Trait Implementations

impl Clone for AngularMom

fn clone(&self) -> AngularMom

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for AngularMom

impl Debug for AngularMom

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

Formats the value using the given formatter.

impl Dynamics for AngularMom

type StateSize = U3

Defines the state size for these dynamics. It must be imported from nalgebra.

type StateType = Vector3<f64>

Defines the type which will be published on the propagator channel

fn time(&self) -> f64

Returns the time of the current state

fn state_vector(&self) -> VectorN<f64, Self::StateSize>

Returns the angular velocity ω of the system, not its momentum.

fn state(&self) -> Vector3<f64>

Returns the state of the dynamics

fn set_state(
    &mut self,
    new_t: f64,
    new_angular_velocity: &VectorN<f64, Self::StateSize>
)

Set the angular velocity ω of the system and the time.

fn eom(
    &self,
    _t: f64,
    omega: &VectorN<f64, Self::StateSize>
) -> VectorN<f64, Self::StateSize>

Computes the instantaneous equations of motion of the angular velocity of a tensor (i.e. the angular acceleration). [I]̲̇ω = -[̃ω][I]̲ω + ̲L

Source: Schaub & Junkins, 3th ed., eq. 4.32.