Struct nyx_space::md::prelude::MetaAlmanac

pub struct MetaAlmanac {
    pub files: Vec<MetaFile>,
}

A structure to set up an Almanac, with automatic downloading, local storage, checksum checking, and more.

Behavior

If the URI is a local path, relative or absolute, nothing will be fetched from a remote. Relative paths are relative to the execution folder (i.e. the current working directory). If the URI is a remote path, the MetaAlmanac will first check if the file exists locally. If it exists, it will check that the CRC32 checksum of this file matches that of the specs. If it does not match, the file will be downloaded again. If no CRC32 is provided but the file exists, then the MetaAlmanac will fetch the remote file and overwrite the existing file. The downloaded path will be stored in the “AppData” folder.

Fields

files: Vec<MetaFile>

Implementations

impl MetaAlmanac

pub fn new(path: String) -> Result<MetaAlmanac, MetaAlmanacError>

Loads the provided path as a Dhall configuration file and processes each file.

pub fn process(&mut self) -> Result<Almanac, AlmanacError>

Fetch all of the URIs and return a loaded Almanac

pub fn latest() -> Result<Almanac, AlmanacError>

Returns an Almanac loaded from the latest NAIF data via the default MetaAlmanac. The MetaAlmanac will download the DE440s.bsp file, the PCK0008.PCA, the full Moon Principal Axis BPC (moon_pa_de440_200625) and the latest high precision Earth kernel from JPL.

File list

• http://public-data.nyxspace.com/anise/de440s.bsp
• http://public-data.nyxspace.com/anise/v0.4/pck11.pca
• http://public-data.nyxspace.com/anise/moon_pa_de440_200625.bpc
• https://naif.jpl.nasa.gov/pub/naif/generic_kernels/pck/earth_latest_high_prec.bpc

Reproducibility

Note that the earth_latest_high_prec.bpc file is regularly updated daily (or so). As such, if queried at some future time, the Earth rotation parameters may have changed between two queries.

impl MetaAlmanac

pub fn dumps(&self) -> Result<String, MetaAlmanacError>

Dumps the configured Meta Almanac into a Dhall string.

Trait Implementations

impl Clone for MetaAlmanac

fn clone(&self) -> MetaAlmanac

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MetaAlmanac

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

Formats the value using the given formatter.

impl Default for MetaAlmanac

By default, the MetaAlmanac will download the DE440s.bsp file, the PCK0008.PCA, the full Moon Principal Axis BPC (moon_pa_de440_200625) and the latest high precision Earth kernel from JPL.

File list

• http://public-data.nyxspace.com/anise/de440s.bsp
• http://public-data.nyxspace.com/anise/v0.4/pck11.pca
• http://public-data.nyxspace.com/anise/v0.4/moon_fk.epa
• http://public-data.nyxspace.com/anise/moon_pa_de440_200625.bpc
• https://naif.jpl.nasa.gov/pub/naif/generic_kernels/pck/earth_latest_high_prec.bpc

Reproducibility

Note that the earth_latest_high_prec.bpc file is regularly updated daily (or so). As such, if queried at some future time, the Earth rotation parameters may have changed between two queries.

fn default() -> MetaAlmanac

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MetaAlmanac

fn deserialize<__D>( __deserializer: __D ) -> Result<MetaAlmanac, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for MetaAlmanac

type Err = MetaAlmanacError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<MetaAlmanac, <MetaAlmanac as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for MetaAlmanac

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for MetaAlmanac

fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MetaAlmanac