Skip to main content

Matrix3x3

Struct Matrix3x3 

Source
pub struct Matrix3x3 { /* private fields */ }
Expand description

A 3×3 f32 matrix stored in row-major order.

use embedded_matrix::Matrix3x3;

let m = Matrix3x3::identity();
assert!((m.det() - 1.0).abs() < 1e-5);
assert!((m.trace() - 3.0).abs() < 1e-5);

Implementations§

Source§

impl Matrix3x3

Source

pub const fn new(data: [[f32; 3]; 3]) -> Matrix3x3

Creates a matrix from a row-major array.

Source

pub const fn identity() -> Matrix3x3

Identity matrix.

Source

pub const fn zero() -> Matrix3x3

Zero matrix.

Source

pub const fn from_diagonal(d: [f32; 3]) -> Matrix3x3

Diagonal matrix.

Source

pub fn get(&self, row: usize, col: usize) -> f32

Returns the element at row row and column col (zero-indexed).

§Panics

Panics if row or col is 3 or greater.

Source

pub fn as_array(&self) -> &[[f32; 3]; 3]

Provides access to the raw row-major data.

Source

pub fn add(&self, rhs: &Matrix3x3) -> Matrix3x3

Element-wise addition.

Source

pub fn sub(&self, rhs: &Matrix3x3) -> Matrix3x3

Element-wise subtraction.

Source

pub fn mul(&self, rhs: &Matrix3x3) -> Matrix3x3

Standard matrix multiplication.

Source

pub fn scale(&self, s: f32) -> Matrix3x3

Scalar multiplication.

Source

pub fn mul_vec(&self, v: [f32; 3]) -> [f32; 3]

Matrix × column vector product.

Source

pub fn transpose(&self) -> Matrix3x3

Transpose.

Source

pub fn det(&self) -> f32

Determinant by expansion along the first row (cofactors).

Source

pub fn trace(&self) -> f32

Trace (sum of the diagonal elements).

Source

pub fn solve(&self, b: [f32; 3]) -> Result<[f32; 3], MatrixError>

Solves the system A·x = b.

Computed as A⁻¹·b: same cost and singularity criterion as inv. For multiple right-hand sides with the same matrix, compute inv() only once.

use embedded_matrix::Matrix3x3;

let a = Matrix3x3::new([[1.0, 2.0, 3.0], [0.0, 1.0, 4.0], [5.0, 6.0, 0.0]]);
let x = a.solve([1.0, 2.0, 3.0]).unwrap();
assert!((x[0] - 27.0).abs() < 1e-3);
assert!((x[1] + 22.0).abs() < 1e-3);
assert!((x[2] - 6.0).abs() < 1e-3);
§Errors
Source

pub fn approx_eq(&self, other: &Matrix3x3, tol: f32) -> bool

Compares two matrices element-wise with an absolute tolerance. Returns false if an element is NaN.

Source

pub fn inv(&self) -> Result<Matrix3x3, MatrixError>

Inverse using the cofactor method (adjugate matrix / determinant).

§Errors

Trait Implementations§

Source§

impl Add for Matrix3x3

a + b: element-wise addition.

Source§

type Output = Matrix3x3

The resulting type after applying the + operator.
Source§

fn add(self, rhs: Matrix3x3) -> Matrix3x3

Performs the + operation. Read more
Source§

impl AddAssign for Matrix3x3

Source§

fn add_assign(&mut self, rhs: Matrix3x3)

Performs the += operation. Read more
Source§

impl Clone for Matrix3x3

Source§

fn clone(&self) -> Matrix3x3

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for Matrix3x3

Source§

impl Debug for Matrix3x3

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
Source§

impl Default for Matrix3x3

Source§

fn default() -> Matrix3x3

Returns the “default value” for a type. Read more
Source§

impl From<[[f32; 3]; 3]> for Matrix3x3

Source§

fn from(data: [[f32; 3]; 3]) -> Matrix3x3

Converts to this type from the input type.
Source§

impl Index<(usize, usize)> for Matrix3x3

m[(row, column)]: panics if out of bounds.

Source§

type Output = f32

The returned type after indexing.
Source§

fn index(&self, _: (usize, usize)) -> &f32

Performs the indexing (container[index]) operation. Read more
Source§

impl Mul for Matrix3x3

a * b: matrix multiplication.

Source§

type Output = Matrix3x3

The resulting type after applying the * operator.
Source§

fn mul(self, rhs: Matrix3x3) -> Matrix3x3

Performs the * operation. Read more
Source§

impl Mul<[f32; 3]> for Matrix3x3

a * v: matrix × column vector.

Source§

type Output = [f32; 3]

The resulting type after applying the * operator.
Source§

fn mul(self, v: [f32; 3]) -> [f32; 3]

Performs the * operation. Read more
Source§

impl Mul<f32> for Matrix3x3

a * s: multiplication by an f32 scalar.

Source§

type Output = Matrix3x3

The resulting type after applying the * operator.
Source§

fn mul(self, s: f32) -> Matrix3x3

Performs the * operation. Read more
Source§

impl MulAssign for Matrix3x3

Source§

fn mul_assign(&mut self, rhs: Matrix3x3)

Performs the *= operation. Read more
Source§

impl MulAssign<f32> for Matrix3x3

Source§

fn mul_assign(&mut self, s: f32)

Performs the *= operation. Read more
Source§

impl Neg for Matrix3x3

-a: element-wise negation.

Source§

type Output = Matrix3x3

The resulting type after applying the - operator.
Source§

fn neg(self) -> Matrix3x3

Performs the unary - operation. Read more
Source§

impl PartialEq for Matrix3x3

Source§

fn eq(&self, other: &Matrix3x3) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Matrix3x3

Source§

impl Sub for Matrix3x3

a - b: element-wise subtraction.

Source§

type Output = Matrix3x3

The resulting type after applying the - operator.
Source§

fn sub(self, rhs: Matrix3x3) -> Matrix3x3

Performs the - operation. Read more
Source§

impl SubAssign for Matrix3x3

Source§

fn sub_assign(&mut self, rhs: Matrix3x3)

Performs the -= operation. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.