runmat-runtime 0.4.9

Core runtime for RunMat with builtins, BLAS/LAPACK integration, and execution APIs
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

//! Internal helpers shared by the MATLAB-compatible degree-trig builtins
//! (`sind`, `cosd`, `tand`).
//!
//! The reduction routine maps any finite angle (in degrees) into the
//! canonical half-open range `(-180.0, 180.0]`, using a sign convention
//! that makes the exact-value tables in each builtin straightforward to
//! consult. Non-finite inputs are propagated as `None` so callers can
//! emit `NaN` without further bookkeeping.

#[inline]
pub(super) fn reduce_degrees(angle: f64) -> Option<f64> {
    if !angle.is_finite() {
        return None;
    }
    let wrapped = angle.rem_euclid(360.0);
    let reduced = if wrapped > 180.0 {
        wrapped - 360.0
    } else {
        wrapped
    };
    Some(reduced)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn reduce_degrees_handles_canonical_angles() {
        assert_eq!(reduce_degrees(0.0), Some(0.0));
        assert_eq!(reduce_degrees(30.0), Some(30.0));
        assert_eq!(reduce_degrees(90.0), Some(90.0));
        assert_eq!(reduce_degrees(180.0), Some(180.0));
        assert_eq!(reduce_degrees(-180.0), Some(180.0));
        assert_eq!(reduce_degrees(270.0), Some(-90.0));
        assert_eq!(reduce_degrees(-270.0), Some(90.0));
        assert_eq!(reduce_degrees(360.0), Some(0.0));
        assert_eq!(reduce_degrees(-360.0), Some(0.0));
        assert_eq!(reduce_degrees(720.0), Some(0.0));
        assert_eq!(reduce_degrees(-30.0), Some(-30.0));
    }

    #[test]
    fn reduce_degrees_rejects_nonfinite() {
        assert!(reduce_degrees(f64::NAN).is_none());
        assert!(reduce_degrees(f64::INFINITY).is_none());
        assert!(reduce_degrees(f64::NEG_INFINITY).is_none());
    }
}