sidereon-core 0.10.0

The complete Sidereon engine: numerical astrodynamics propagation core plus the GNSS domain layer (SP3, broadcast ephemeris, multi-GNSS positioning, RTK/PPP, ionosphere/troposphere, DOP) behind a default-on gnss feature
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

use crate::astro::almanac::{norm_checked, wrap360, AlmanacError};
use crate::astro::frames::nutation::{skyfield_iau2000a_radians, skyfield_mean_obliquity_radians};
use crate::astro::time::scales::TimeScales;

/// Geocentric apparent ecliptic longitude and latitude of a body, degrees, of date.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct EclipticLonLat {
    pub longitude_deg: f64,
    pub latitude_deg: f64,
}

/// Convert a geocentric true-equator-and-equinox-of-date apparent position,
/// metres, to true ecliptic longitude and latitude of date.
pub fn geocentric_ecliptic(
    pos_true_of_date_m: [f64; 3],
    ts: &TimeScales,
) -> Result<EclipticLonLat, AlmanacError> {
    let distance_m = norm_checked(pos_true_of_date_m, "pos_true_of_date_m")?;
    let mean =
        skyfield_mean_obliquity_radians(ts.jd_tdb).map_err(|_| AlmanacError::Frame("obliquity"))?;
    let (_dpsi, deps) =
        skyfield_iau2000a_radians(ts.jd_tt).map_err(|_| AlmanacError::Frame("nutation"))?;
    let eps = mean + deps;
    if !eps.is_finite() {
        return Err(AlmanacError::Frame("obliquity"));
    }

    let cos_eps = eps.cos();
    let sin_eps = eps.sin();
    let x = pos_true_of_date_m[0] / distance_m;
    let y_eq = pos_true_of_date_m[1] / distance_m;
    let z_eq = pos_true_of_date_m[2] / distance_m;
    let y = cos_eps * y_eq + sin_eps * z_eq;
    let z = -sin_eps * y_eq + cos_eps * z_eq;
    Ok(EclipticLonLat {
        longitude_deg: wrap360(y.atan2(x).to_degrees()),
        latitude_deg: z.clamp(-1.0, 1.0).asin().to_degrees(),
    })
}