erfars 0.2.0

Safe Rust bindings to the Essential Routines for Fundamental Astronomy (ERFA) C 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

//! ERFA Ephemerides Functions

use crate::{ERFAResult, raw::ephemerides::*, unexpected_val_err};

/// Earth position and velocity, heliocentric and barycentric, with respect to
/// the Barycentric Celestial Reference System.
///
/// Please see the full ERFA docs for this function [here](https://github.com/liberfa/erfa/blob/master/src/epv00.c)
pub fn Epv00(date1: f64, date2: f64) -> ERFAResult<([f64; 6], [f64; 6])> {
    let mut pvh: [f64; 6] = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0];
    let mut pvb: [f64; 6] = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0];
    let err: i32;
    unsafe { err = eraEpv00(date1, date2, &mut pvh, &mut pvb) }

    match err {
        0 => Ok(((pvh, pvb), 0)),
        1 => Ok(((pvh, pvb), 1)),
        _ => unexpected_val_err!(eraEpv00),
    }
}

/// Approximate geocentric position and velocity of the Moon.
///
/// Please see the full ERFA docs for this function [here](https://github.com/liberfa/erfa/blob/master/src/moon98.c)
pub fn Moon98(date1: f64, date2: f64) -> [f64; 6] {
    let mut pv: [f64; 6] = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0];
    unsafe { eraMoon98(date1, date2, &mut pv) }

    return pv;
}

/// Approximate heliocentric position and velocity of a nominated planet:
/// Mercury, Venus, EMB, Mars, Jupiter, Saturn, Uranus or Neptune (but not the
/// Earth itself).
///
/// Please see the full ERFA docs for this function [here](https://github.com/liberfa/erfa/blob/master/src/plan94.c)
pub fn Plan94(date1: f64, date2: f64, planet: i32) -> ERFAResult<[f64; 6]> {
    let mut pv: [f64; 6] = [0.0, 0.0, 0.0, 0.0, 0.0, 0.0];
    let err: i32;
    unsafe { err = eraPlan94(date1, date2, planet, &mut pv) }

    match err {
        0 => Ok((pv, 0)),
        1 => Ok((pv, 1)),
        2 => Ok((pv, 2)),
        -1 => Err(-1),
        _ => unexpected_val_err!(eraPlan94),
    }
}