lox-frames 0.1.0-alpha.16

Reference frame transformations for the Lox ecosystem
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

// SPDX-FileCopyrightText: 2025 Helge Eichhorn <git@helgeeichhorn.de>
//
// SPDX-License-Identifier: MPL-2.0

use fast_polynomial::poly_array;
use lox_test_utils::ApproxEq;
use lox_time::{Time, julian_dates::JulianDate, time_scales::Tt};
use lox_units::Angle;

use crate::iers::ReferenceSystem;

impl ReferenceSystem {
    /// Returns the mean obliquity of the ecliptic for the given IERS convention.
    pub fn mean_obliquity(&self, time: Time<Tt>) -> MeanObliquity {
        match self {
            ReferenceSystem::Iers1996 | ReferenceSystem::Iers2003(_) => {
                MeanObliquity::iau1980(time)
            }
            ReferenceSystem::Iers2010 => MeanObliquity::iau2006(time),
        }
    }
}

/// Mean obliquity of the ecliptic.
#[derive(Debug, Clone, Copy, PartialEq, PartialOrd, ApproxEq)]
pub struct MeanObliquity(pub Angle);

impl MeanObliquity {
    /// Returns the mean obliquity of the ecliptic based on the IAU1980 precession model.
    pub fn iau1980(time: Time<Tt>) -> Self {
        let t = time.centuries_since_j2000();

        Self(Angle::arcseconds(poly_array(
            t,
            &[84381.448, -46.8150, -0.00059, 0.001813],
        )))
    }

    /// Returns the mean obliquity of the ecliptic based on the IAU2006 precession model.
    pub fn iau2006(time: Time<Tt>) -> Self {
        let t = time.centuries_since_j2000();

        Self(Angle::arcseconds(poly_array(
            t,
            &[
                84381.406,
                -46.836769,
                -0.0001831,
                0.00200340,
                -0.000000576,
                -0.0000000434,
            ],
        )))
    }
}

#[cfg(test)]
mod tests {
    use lox_test_utils::assert_approx_eq;

    use super::*;

    #[test]
    fn test_mean_obliquity_iers1996() {
        let time = Time::from_two_part_julian_date(Tt, 2400000.5, 54388.0);
        let exp = MeanObliquity(Angle::new(0.409_075_134_764_381_6));
        let act = ReferenceSystem::Iers1996.mean_obliquity(time);
        assert_approx_eq!(act, exp, rtol <= 1e-14);
    }

    #[test]
    fn test_mean_obliquity_iers2010() {
        let time = Time::from_two_part_julian_date(Tt, 2400000.5, 54388.0);
        let exp = MeanObliquity(Angle::new(0.409_074_922_938_725_8));
        let act = ReferenceSystem::Iers2010.mean_obliquity(time);
        assert_approx_eq!(act, exp, rtol <= 1e-14);
    }
}