anise 0.9.6

Core of the ANISE library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

/*
 * ANISE Toolkit
 * Copyright (C) 2021-onward Christopher Rabotin <christopher.rabotin@gmail.com> et al. (cf. AUTHORS.md)
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 *
 * Documentation: https://nyxspace.com/
 */

use hifitime::{Epoch, HifitimeError};
use snafu::prelude::*;

use crate::{
    astro::Aberration, errors::PhysicsError, math::interpolation::InterpolationError,
    naif::daf::DAFError, prelude::FrameUid, NaifId,
};

#[cfg(feature = "analysis")]
pub mod ephemeris;
pub mod paths;
pub mod translate_to_parent;
pub mod translations;

#[derive(Debug, Snafu, PartialEq)]
#[snafu(visibility(pub))]
#[non_exhaustive]
pub enum EphemerisError {
    /// Somehow you've entered code that should not be reachable, please file a bug.
    Unreachable,
    #[snafu(display("could not {action} because {alias} is not loaded"))]
    AliasNotFound { alias: String, action: &'static str },
    #[snafu(display(
        "Could not translate from {from} to {to}: no common origin found at epoch {epoch}"
    ))]
    TranslationOrigin {
        from: FrameUid,
        to: FrameUid,
        epoch: Epoch,
    },
    #[snafu(display("no ephemeris data loaded (must call load_spk)"))]
    NoEphemerisLoaded,
    #[snafu(display("when {action} caused {source}"))]
    SPK {
        action: &'static str,
        #[snafu(backtrace)]
        source: DAFError,
    },
    #[snafu(display("when {action} for ephemeris {source}"))]
    EphemerisPhysics {
        action: &'static str,
        #[snafu(backtrace)]
        source: PhysicsError,
    },
    #[snafu(display("during an ephemeris interpolation {source}"))]
    EphemInterpolation {
        #[snafu(backtrace)]
        source: InterpolationError,
    },
    #[snafu(display("{ab_corr} corrects epoch from {epoch} to {epoch_lt}, but {source}"))]
    LightTimeCorrection {
        epoch: Epoch,
        epoch_lt: Epoch,
        ab_corr: Aberration,
        #[snafu(source(from(EphemerisError, Box::new)))] // This ensures the source error is boxed
        source: Box<EphemerisError>,
    },
    #[snafu(display("unknown name associated with NAIF ID {id}"))]
    IdToName { id: NaifId },
    #[snafu(display("unknown NAIF ID associated with `{name}`"))]
    NameToId { name: String },
    #[snafu(display("CCSDS OEM parsing error on line {lno}: {details}"))]
    OEMParsingError { lno: usize, details: String },
    #[snafu(display("STK Ephemeris parsing error on line {lno}: {details}"))]
    STKEParsingError { lno: usize, details: String },
    #[snafu(display("CCSDS OEM epoch parsing error on line {line}: {details}"))]
    OEMTimeParsingError {
        line: usize,
        details: String,
        source: HifitimeError,
    },
    #[snafu(display("CCSDS OEM writing error: {details}"))]
    OEMWritingError { details: String },
    #[snafu(display("SPICE BSP/SPK writing error: {details}"))]
    SPKWritingError { details: String },
}