Expand description
§embedded-matrix
Matrices 2×2 et 3×3 en f32 pour systèmes embarqués no_std.
Sans dépendance, sans unsafe, sans allocation.
use embedded_matrix::{Matrix2x2, Matrix3x3, MatrixError};
// Produit matriciel avec l'opérateur *
let a = Matrix3x3::new([
[1.0, 2.0, 3.0],
[4.0, 5.0, 6.0],
[7.0, 8.0, 9.0],
]);
let b = Matrix3x3::identity();
assert_eq!(a * b, a);
// Addition, soustraction, scalaire
assert_eq!((a + b) - b, a);
let _double = a * 2.0;
// Matrice × vecteur
let v = Matrix2x2::identity() * [1.0, 2.0];
assert_eq!(v, [1.0, 2.0]);
// Inversion (Err si singulière ou non finie)
match Matrix2x2::new([[2.0, 0.0], [0.0, 4.0]]).inv() {
Ok(inv) => assert_eq!(inv, Matrix2x2::new([[0.5, 0.0], [0.0, 0.25]])),
Err(MatrixError::SingularMatrix) => { /* gérer */ }
Err(e) => panic!("{e}"),
}§Résolution de systèmes
solve(b) résout A·x = b et renvoie directement x :
use embedded_matrix::Matrix2x2;
let a = Matrix2x2::new([[2.0, 1.0], [1.0, 3.0]]);
let x = a.solve([3.0, 5.0]).unwrap(); // x = [0.8, 1.4]
assert!((x[0] - 0.8).abs() < 1e-6);§Feature optionnelle : trig
embedded-matrix = { version = "0.3", features = ["trig"] }Active la dépendance à embedded-trig-f32 et ajoute les constructeurs de
rotation : Matrix2x2::rotation(angle), Matrix3x3::rotation_x / _y / _z(angle)
(angles en radians, règle de la main droite). Sans la feature, la crate
n’a aucune dépendance.
§Pistes futures (non implémentées)
Ces idées ne font pas partie de l’API actuelle ; elles sont notées ici pour la suite :
- Taille quelconque :
Matrix<const R: usize, const C: usize>sur la pile (aliasMatrix2x2 = Matrix<2, 2>), produit de matrices non carrées. - Décomposition LU avec pivot partiel pour
det,invetsolveen taille n. - Cholesky pour les matrices symétriques définies positives (matrices de covariance).
- Type
Vector<N>: produit scalaire, produit vectoriel 3D, norme. #[must_use]sur les opérations arithmétiques.- Benchmarks en cycles (compteur DWT) et CI de compilation embarquée.
§Détection des matrices singulières
inv compare |det| à une borne relative à la taille des termes du
déterminant (et non à une constante absolue) : une matrice 1e-4 · I
reste inversible, alors qu’une matrice de grands coefficients dont le
déterminant n’est que du bruit d’arrondi est correctement rejetée.
Structs§
- Matrix2x2
- Matrice 2×2 en
f32, stockée en row-major. - Matrix3x3
- Matrice 3×3 en
f32, stockée en row-major.
Enums§
- Matrix
Error - Erreur retournée lors d’une opération invalide sur une matrice.