Skip to main content

embedded_maths/embedded-maths-functions/
sin.rs

1//! Sinus pour `f32`, sans dépendance externe.
2//!
3//! Utilise la réduction d'argument et les polynômes de `sin_cos`
4//! (erreur de l'ordre de 1e-6, contre 2e-3 pour l'ancienne version via `cos`).
5
6use super::sin_cos::sin_cos; // adapte le chemin à ton arborescence
7
8/// Sinus de `x` (en radians).
9///
10/// - `x` infini ou NaN → NaN
11pub fn sin(x: f32) -> f32 {
12    sin_cos(x).0
13}
14
15#[cfg(test)]
16mod tests {
17    use super::sin;
18    use core::f32::consts::{FRAC_PI_2, FRAC_PI_6, PI, TAU};
19
20    const TOL: f32 = 2e-6;
21
22    fn close(a: f32, b: f32) -> bool {
23        (a - b).abs() <= TOL
24    }
25
26    #[test]
27    fn known_angles() {
28        assert_eq!(sin(0.0), 0.0);
29        assert!(close(sin(FRAC_PI_6), 0.5));
30        assert!(close(sin(FRAC_PI_2), 1.0));
31        assert!(close(sin(PI), 0.0));
32        assert!(close(sin(3.0 * FRAC_PI_2), -1.0));
33        assert!(close(sin(TAU), 0.0));
34    }
35
36    #[test]
37    fn known_values() {
38        // Valeurs de référence connues, indépendantes de notre implémentation.
39        let cases: &[(f32, f32)] = &[
40            (0.5, 0.479_425_5),
41            (1.0, 0.841_470_96),
42            (2.0, 0.909_297_4),
43            (3.0, 0.141_120_01),
44            (4.0, -0.756_802_5),
45            (5.0, -0.958_924_3),
46            (6.0, -0.279_415_5),
47        ];
48        for &(x, expected) in cases {
49            let got = sin(x);
50            assert!(close(got, expected), "sin({x}) = {got}, attendu {expected}");
51        }
52    }
53
54    #[test]
55    fn odd_symmetry() {
56        for i in 1..=100 {
57            let x = i as f32 * 0.173;
58            assert!(close(sin(-x), -sin(x)), "x={x}");
59        }
60    }
61
62    #[test]
63    fn periodicity() {
64        for i in 0..=100 {
65            let x = i as f32 * 0.061;
66            assert!((sin(x + TAU) - sin(x)).abs() <= 5e-6, "x={x}");
67        }
68    }
69
70    #[test]
71    fn bounded() {
72        for i in -500..=500 {
73            let x = i as f32 * 0.0731;
74            assert!(sin(x).abs() <= 1.0 + 1e-6, "x={x}");
75        }
76    }
77
78    #[test]
79    fn special_values() {
80        assert!(sin(f32::NAN).is_nan());
81        assert!(sin(f32::INFINITY).is_nan());
82        assert!(sin(f32::NEG_INFINITY).is_nan());
83    }
84}