Enum StepError 

pub enum StepError {
    EphemerisLookup {
        source_idx: usize,
        target: EphemerisBody,
        observer: EphemerisBody,
        tdb_jd: f64,
        message: String,
    },
    FrameSwitchTargetMissing {
        body_idx: usize,
        target_source: usize,
        num_sources: usize,
    },
}

Reasons a Simulation step can fail at runtime.

Construct via the variant constructors (the kernel returns these from step_internal on the relevant failure paths). Inspect via pattern match. Implements core::error::Error so it composes with ? and the rest of the standard error-handling ecosystem.

Reading the carried context

All variant fields are part of the public surface (an enum variant’s fields inherit the enum’s visibility, so no per-field pub qualifier is needed or accepted by the language). Downstream recovery logic can destructure freely:

use astrodyn_runner::StepError;

fn handle(err: StepError) {
    match err {
        StepError::EphemerisLookup {
            source_idx,
            tdb_jd,
            ..
        } => {
            eprintln!("source {source_idx} missing at TDB JD {tdb_jd}");
        }
        StepError::FrameSwitchTargetMissing {
            body_idx,
            target_source,
            num_sources,
        } => {
            eprintln!(
                "body {body_idx}: target {target_source} >= {num_sources}"
            );
        }
    }
}

Variants

EphemerisLookup

DE4xx ephemeris lookup failed for a source whose position is driven by an attached ephemeris. Carries enough context to identify the source and the time scale at which the lookup failed.

Fields

source_idx: usize

Index of the source whose position update failed.

target: EphemerisBody

Target body passed to Ephemeris::get_state_typed.

observer: EphemerisBody

Observer body passed to Ephemeris::get_state_typed.

tdb_jd: f64

TDB Julian Date at which the lookup was attempted.

message: String

Underlying error message from the ephemeris kernel.

FrameSwitchTargetMissing

A body’s FrameSwitchConfig referenced a target_source index that doesn’t correspond to any registered gravity source. Typically a mid-mission edit hazard caught at step time when Simulation::validate wasn’t re-run after the change.

Fields

body_idx: usize

Index of the body whose frame switch contains the bad target.

target_source: usize

Out-of-range target source index.

num_sources: usize

Number of sources currently registered.

Trait Implementations

impl Clone for StepError

fn clone(&self) -> StepError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StepError

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

Formats the value using the given formatter.

impl Display for StepError

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

Formats the value using the given formatter.

impl Error for StepError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.