Struct EopData 

pub struct EopData {
    pub rows: Vec<EopDataRow>,
    pub strip_offset_leaps: bool,
    pub epoch_scale: Scale,
}

Sorted orientation-parameter table for a body.

Interpolate with eop_offset. On Earth, load IERS data and use Dt::to_ut1. For other bodies, load custom rows and call Dt::to_eop / Dt::from_eop with the epoch you computed for that instant.

Fields

rows: Vec<EopDataRow>

Sample rows, sorted by ascending EopDataRow::epoch.

Loaders and from_rows keep this order. eop_offset and merge assume it.

strip_offset_leaps: bool

When true, a ~1 s jump between neighboring offset samples is removed before interpolation (leap-second days on Earth UT1−UTC tables).

Finals2000A / C04 loaders set this true; JplEop2 and Custom set false.

epoch_scale: Scale

Time scale of each row’s EopDataRow::epoch MJD.

Dt::to_ut1 converts the Dt to this scale before lookup. C04 / Finals2000A → Scale::UTC; JplEop2 and from_rows → Scale::TAI. Override with with_epoch_scale.

Implementations

impl EopData

pub fn from_rows(rows: Vec<EopDataRow>, strip_offset_leaps: bool) -> Self

Build a table from already-parsed rows (sorted by epoch).

Set strip_offset_leaps true for Earth UT1−UTC-style leap days. epoch_scale defaults to Scale::TAI; chain with_epoch_scale for UTC-indexed tables.

pub fn with_strip_offset_leaps(self, on: bool) -> Self

Set strip_offset_leaps.

pub fn with_epoch_scale(self, scale: Scale) -> Self

Set epoch_scale.

impl EopData

pub fn data_from_reader<R: BufRead>( reader: R, format: EopFormat, separator: Separator, ) -> Result<Vec<EopDataRow>, DtErr>

Parse EOP data from any std::io::BufRead (file, network stream, etc.).

Lines starting with # or longer than EopData::MAX_LINE_LEN are skipped. The returned vector is always sorted by epoch.

pub fn data_from_text_file<P: AsRef<Path>>( path: P, format: EopFormat, separator: Separator, ) -> Result<Vec<EopDataRow>, DtErr>

Returns a Vec of EopDataRow from a text file on disk.

Examples

use deep_time::eop::{EopData, EopFormat, Separator};

let path = "tests/assets/finals.all.iau2000.txt";
let rows = EopData::data_from_text_file(path, EopFormat::Finals2000A, Separator::Whitespace).unwrap();

See also

• EopData::from_text_file

pub fn from_text_file<P: AsRef<Path>>( path: P, format: EopFormat, separator: Separator, ) -> Result<Self, DtErr>

Create an EopData by loading from a text file on disk.

Examples

use deep_time::eop::{EopData, EopFormat, Separator};

let path = "tests/assets/finals.all.iau2000.txt";
let provider = EopData::from_text_file(path, EopFormat::Finals2000A, Separator::Whitespace).unwrap();

impl EopData

pub const MAX_LINE_LEN: usize = 8192

Maximum accepted length of a single input line when parsing EOP text.

pub fn data_from_str( s: &str, format: EopFormat, separator: Separator, ) -> Result<Vec<EopDataRow>, DtErr>

Parse EOP data from a &str.

Useful when the data is already in memory (embedded resource, downloaded string, etc.).

pub fn data_from_bytes( bytes: &[u8], format: EopFormat, separator: Separator, ) -> Result<Vec<EopDataRow>, DtErr>

Parse EOP data from raw bytes.

The bytes are interpreted as UTF-8. Invalid UTF-8 sequences result in an empty string (and therefore an error).

pub fn from_str( s: &str, format: EopFormat, separator: Separator, ) -> Result<Self, DtErr>

Create an EopData from a string slice.

pub fn from_bytes( bytes: &[u8], format: EopFormat, separator: Separator, ) -> Result<Self, DtErr>

Create an EopData from raw bytes.

pub fn merge(&mut self, other: &EopData, add_rows: bool, overwrite_rows: bool)

Merge rows from other into self by epoch.

For each row in other:

• Same epoch already in self: if overwrite_rows, replace offset / pm_x / pm_y; otherwise leave self’s row as-is.
• Epoch not in self: if add_rows, insert the row (table stays sorted by epoch); otherwise skip it.

Both flags may be true or only one. If both are false, this is a no-op. strip_offset_leaps and epoch_scale on self are unchanged.

Example

use deep_time::eop::{EopData, EopFormat, Separator};

let mut eop = EopData::from_text_file(
    "tests/assets/EOP_20u24_C04_one_file_1962-now.txt",
    EopFormat::C04,
    Separator::Whitespace,
).unwrap();
let finals = EopData::from_text_file(
    "tests/assets/finals.all.iau2000.txt",
    EopFormat::Finals2000A,
    Separator::Whitespace,
).unwrap();
// Keep C04 on overlap; append Finals prediction days only.
eop.merge(&finals, true, false);

pub fn with_merge( self, other: &EopData, add_rows: bool, overwrite_rows: bool, ) -> Self

Convenience: merge consuming self.

pub fn eop_offset(&self, epoch: Real) -> Option<EopOffset>

Interpolated orientation parameters at epoch.

Linear blend between neighboring samples. If strip_offset_leaps is set, a ~1 s jump in offset between those samples is removed before blending. Outside the table range the nearest endpoint is held. Returns None if empty.

Trait Implementations

impl Clone for EopData

fn clone(&self) -> EopData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EopData

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

Formats the value using the given formatter.