Struct EarthOrientation 

pub struct EarthOrientation { /* private fields */ }

A single evaluated Earth-orientation state for one epoch.

The stored direction-cosine matrix maps GCRF/GCRS inertial coordinates to ITRF/ITRS Earth-fixed coordinates using the existing IAU 2006/2000A precession-nutation chain, apparent sidereal rotation, and optional polar motion. The inverse matrix is cached as the transpose so callers can evaluate the frame once and reuse it across many satellite states.

Implementations

impl EarthOrientation

pub fn from_time_scales(ts: &TimeScales) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation with zero polar motion.

pub fn from_time_scales_with_polar_motion( ts: &TimeScales, polar_motion: PolarMotion, ) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation with caller-supplied polar motion.

pub fn from_utc( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: f64, ) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation from UTC calendar fields with zero polar motion.

pub fn from_utc_with_polar_motion( year: i32, month: i32, day: i32, hour: i32, minute: i32, second: f64, polar_motion: PolarMotion, ) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation from UTC calendar fields with caller-supplied polar motion.

pub fn from_instant(epoch: Instant) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation from a scale-tagged instant with zero polar motion.

pub fn from_instant_with_polar_motion( epoch: Instant, polar_motion: PolarMotion, ) -> Result<Self, FrameTransformError>

Evaluate the full GCRF to ITRF rotation from a scale-tagged instant with caller-supplied polar motion.

pub fn time_scales(&self) -> TimeScales

Time scales used to evaluate this orientation.

pub fn polar_motion(&self) -> PolarMotion

Polar-motion coordinates used to evaluate this orientation.

pub fn earth_rotation_vector_itrf_rad_s(&self) -> [f64; 3]

Earth rotation vector in ITRF axes, radians per second.

pub fn gcrf_to_itrf_matrix(&self) -> Mat3

GCRF to ITRF direction-cosine matrix.

pub fn itrf_to_gcrf_matrix(&self) -> Mat3

ITRF to GCRF direction-cosine matrix.

pub fn gcrf_to_itrf_rotation_rate_matrix(&self) -> Mat3

Time derivative of the GCRF to ITRF matrix from Earth rotation, with precession, nutation, and polar motion frozen at this evaluation point.

pub fn itrf_to_gcrf_rotation_rate_matrix(&self) -> Mat3

Time derivative of the ITRF to GCRF matrix from Earth rotation, with precession, nutation, and polar motion frozen at this evaluation point.

pub fn gcrf_to_itrf_position_km( &self, position_gcrf_km: [f64; 3], ) -> Result<[f64; 3], FrameTransformError>

Rotate a GCRF position vector in kilometers into ITRF.

pub fn itrf_to_gcrf_position_km( &self, position_itrf_km: [f64; 3], ) -> Result<[f64; 3], FrameTransformError>

Rotate an ITRF position vector in kilometers into GCRF.

pub fn gcrf_to_itrf_state_km( &self, position_gcrf_km: [f64; 3], velocity_gcrf_km_s: [f64; 3], ) -> Result<([f64; 3], [f64; 3]), FrameTransformError>

Transform a GCRF state in kilometers and kilometers per second into ITRF.

The velocity includes the rotating-frame term v_itrf = R v_gcrf - omega_itrf x r_itrf.

pub fn itrf_to_gcrf_state_km( &self, position_itrf_km: [f64; 3], velocity_itrf_km_s: [f64; 3], ) -> Result<([f64; 3], [f64; 3]), FrameTransformError>

Transform an ITRF state in kilometers and kilometers per second into GCRF.

The velocity includes the inertial transport term v_gcrf = R^T (v_itrf + omega_itrf x r_itrf).

Trait Implementations

impl Clone for EarthOrientation

fn clone(&self) -> EarthOrientation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EarthOrientation

impl Debug for EarthOrientation

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

Formats the value using the given formatter.

impl PartialEq for EarthOrientation

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for EarthOrientation