Struct nyx_space::md::trajectory::Traj

pub struct Traj<S: State> where
    DefaultAllocator: Allocator<f64, S::PropVecSize> + Allocator<f64, S::Size>,  {
    pub segments: BTreeMap<i32, Segment<S>>,
    pub timeout_ms: u64,
    // some fields omitted
}

Store a trajectory of any State.

Fields

segments: BTreeMap<i32, Segment<S>>

Segments are organized as a binary tree map whose index is the number of seconds since the start of this ephemeris rounded down

timeout_ms: u64

Timeout is used to stop listening to new state (default is 50ms, should work well in release and debug mode).

Implementations

impl<S: State> Traj<S> where
    DefaultAllocator: Allocator<f64, S::PropVecSize> + Allocator<f64, S::Size>, 

pub fn new(state: S, rx: Receiver<S>) -> Result<Self, NyxError>

Creates a new trajectory with the provided starting state (used as a template) and a receiving channel. The trajectories are always generated on a separate thread.

pub fn new_bucket_as(
    state: S,
    items_per_segments: usize,
    rx: Receiver<S>
) -> Result<Self, NyxError>

Creates a new trajectory but specifies the number of items per segment

pub fn evaluate(&self, epoch: Epoch) -> Result<S, NyxError>

Evaluate the trajectory at this specific epoch.

pub fn first(&self) -> S

Returns the first state in this ephemeris

pub fn last(&self) -> S

Returns the last state in this ephemeris

pub fn every(&self, step: Duration) -> TrajIterator<'_, S>

Creates an iterator through the trajectory by the provided step size

pub fn every_between(
    &self,
    step: Duration,
    start: Epoch,
    end: Epoch
) -> TrajIterator<'_, S>

Creates an iterator through the trajectory by the provided step size between the provided bounds

pub fn find_bracketed<E>(
    &self,
    start: Epoch,
    end: Epoch,
    event: &E
) -> Result<S, NyxError> where
    E: EventEvaluator<S>, 

Find the exact state where the request event happens. The event function is expected to be monotone in the provided interval.

pub fn find_all<E>(&self, event: &E) -> Result<Vec<S>, NyxError> where
    E: EventEvaluator<S>, 

Find (usually) all of the states where the event happens. WARNING: The initial search step is 1% of the duration of the trajectory duration! For example, if the trajectory is 100 days long, then we split the trajectory into 100 chunks of 1 day and see whether the event is in there. If the event happens twice or more times within 1% of the trajectory duration, only the one of such events will be found.

pub fn find_minmax<E>(
    &self,
    event: &E,
    precision: TimeUnit
) -> Result<(S, S), NyxError> where
    E: EventEvaluator<S>, 

Find the minimum and maximum of the provided event through the trajectory

impl Traj<Orbit>

pub fn to_frame(
    &self,
    new_frame: Frame,
    cosm: Arc<Cosm>
) -> Result<Self, NyxError>

Allows converting the source trajectory into the (almost) equivalent trajectory in another frame This is super slow.

pub fn to_csv_with_step(
    &self,
    filename: &str,
    step: Duration,
    cosm: Arc<Cosm>
) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with the default headers and the provided step

pub fn to_csv_between_with_step(
    &self,
    filename: &str,
    start: Option<Epoch>,
    end: Option<Epoch>,
    step: Duration,
    cosm: Arc<Cosm>
) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with the default headers and the provided step

pub fn to_csv(&self, filename: &str, cosm: Arc<Cosm>) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with the default headers, one state per minute

pub fn to_csv_between(
    &self,
    filename: &str,
    start: Option<Epoch>,
    end: Option<Epoch>,
    cosm: Arc<Cosm>
) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with the default headers, one state per minute

pub fn to_groundtrack_csv(
    &self,
    filename: &str,
    body_fixed_frame: Frame,
    cosm: Arc<Cosm>
) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with only the epoch, the geodetic latitude, longitude, and height at one state per minute. Must provide a body fixed frame to correctly compute the latitude and longitude.

pub fn to_csv_custom(
    &self,
    filename: &str,
    headers: Vec<&str>,
    step: Duration,
    cosm: Arc<Cosm>
) -> Result<(), NyxError>

Exports this trajectory to the provided filename in CSV format with the provided headers and the provided step

impl Traj<Spacecraft>

pub fn to_frame(
    &self,
    new_frame: Frame,
    cosm: Arc<Cosm>
) -> Result<Self, NyxError>

Allows converting the source trajectory into the (almost) equivalent trajectory in another frame This is super slow.

Trait Implementations

impl<S: Clone + State> Clone for Traj<S> where
    DefaultAllocator: Allocator<f64, S::PropVecSize> + Allocator<f64, S::Size>, 

fn clone(&self) -> Traj<S>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: State> Display for Traj<S> where
    DefaultAllocator: Allocator<f64, S::PropVecSize> + Allocator<f64, S::Size>, 

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

Formats the value using the given formatter.