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

// SPDX-FileCopyrightText: 2023 Angus Morrison <github@angus-morrison.com>
// SPDX-FileCopyrightText: 2024 Helge Eichhorn <git@helgeeichhorn.de>
//
// SPDX-License-Identifier: MPL-2.0

use lox_time::Time;
use lox_time::julian_dates::JulianDate;
use lox_time::time_scales::Tdb;

use crate::iers::nutation::Nutation;

impl Nutation {
    /// The IAU 2000A nutation model adjusted to match the IAU 2006 precession model per
    /// Wallace & Capitaine, 2006.
    pub fn iau2006a(time: Time<Tdb>) -> Nutation {
        let mut nutation = Self::iau2000a(time);

        let j2_correction = -2.7774e-6 * time.centuries_since_j2000();
        nutation.dpsi += (0.4697e-6 + j2_correction) * nutation.dpsi;
        nutation.deps += j2_correction * nutation.deps;

        nutation
    }
}

#[cfg(test)]
mod tests {
    use crate::iers::nutation::Nutation;

    use lox_core::units::AngleUnits;
    use lox_test_utils::assert_approx_eq;
    use lox_time::{Time, time_scales::Tdb};

    #[test]
    fn test_nutation_iau2006a() {
        let time = Time::from_two_part_julian_date(Tdb, 2400000.5, 53736.0);
        let expected = Nutation {
            dpsi: -9.630_912_025_820_31e-6.rad(),
            deps: 4.063_238_496_887_25e-5.rad(),
        };
        let actual = Nutation::iau2006a(time);
        assert_approx_eq!(expected, actual, rtol <= 1e-13);
    }
}