Struct Vector4 

pub struct Vector4 { /* private fields */ }

Represents a 4-dimensional vector with f32 components.

Implementations

impl Vector4

pub fn new(data: [f32; 4]) -> Self

Creates a new 4-vector from the provided array data.

Example

let v = Vector4::new([1.0, 2.0, 3.0, 4.0]);
assert_eq!(v.get(0), 1.0);

pub fn zero() -> Self

Creates a zero vector (all components are 0.0).

Example

use crate::bb_geometry::linear_algebra::vector4::*;
let zero = Vector4::zero();
assert_eq!(zero.get(2), 0.0);

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

Gets the value at the specified index using a method call.

Prefer using the index operator vector[index] for more idiomatic access.

Panics

Panics if index is out of bounds (>= 4).

Example

use crate::bb_geometry::linear_algebra::vector4::*;
let v = Vector4::new([1.0, 2.0, 3.0, 4.0]);
assert_eq!(v.get(1), 2.0);

pub fn set(&mut self, index: usize, value: f32)

Sets the value at the specified index using a method call.

Prefer using the mutable index operator vector[index] = value for more idiomatic modification.

Panics

Panics if index is out of bounds (>= 4).

Example

use crate::bb_geometry::linear_algebra::vector4::*;
let mut v = Vector4::zero();
v.set(3, 5.0);
assert_eq!(v.get(3), 5.0);

pub fn dot(&self, other: &Self) -> f32

Calculates the dot (inner) product of this vector with another vector.

result = self[0]*other[0] + self[1]*other[1] + self[2]*other[2] + self[3]*other[3]

Example

use crate::bb_geometry::linear_algebra::vector4::*;
let v1 = Vector4::new([1.0, 2.0, 3.0, 4.0]);
let v2 = Vector4::new([5.0, 6.0, 7.0, 8.0]);
// 1*5 + 2*6 + 3*7 + 4*8 = 5 + 12 + 21 + 32 = 70
assert_eq!(v1.dot(&v2), 70.0);

pub fn l2_norm(&self) -> f32

pub fn l1_norm(&self) -> f32

pub fn is_almost_zero(&self) -> bool

pub fn wedge_product(&self, other: &Self) -> Matrix4x4

Calculates the wedge product (antisymmetric outer product) of two vectors.

Returns a 4x4 antisymmetric linear_algebra M where M[i][j] = self[i]*other[j] - self[j]*other[i]. This represents the bivector formed by the two vectors.

Example

use crate::bb_geometry::linear_algebra::vector4::*;
use crate::bb_geometry::linear_algebra::matrix4x4::*;
let u = Vector4::new([1.0, 2.0, 0.0, 0.0]);
let v = Vector4::new([0.0, 3.0, 4.0, 0.0]);
let wedge_matrix = u.wedge_product(&v);

// M[0][1] = u[0]*v[1] - u[1]*v[0] = 1*3 - 2*0 = 3.0
assert_eq!(wedge_matrix[(0, 1)], 3.0);
// M[1][0] = u[1]*v[0] - u[0]*v[1] = 2*0 - 1*3 = -3.0
assert_eq!(wedge_matrix[(1, 0)], -3.0);
// M[0][2] = u[0]*v[2] - u[2]*v[0] = 1*4 - 0*0 = 4.0
assert_eq!(wedge_matrix[(0, 2)], 4.0);
// M[1][2] = u[1]*v[2] - u[2]*v[1] = 2*4 - 0*3 = 8.0
assert_eq!(wedge_matrix[(1, 2)], 8.0);
// M[0][0] should be 0
assert_eq!(wedge_matrix[(0, 0)], 0.0);
// M[3][x] should be 0 as u[3] and v[3] are 0
assert_eq!(wedge_matrix[(3, 0)], 0.0);
assert_eq!(wedge_matrix[(0, 3)], 0.0);

Trait Implementations

impl Add<&Vector4> for &Vector4

Implements vector addition using the + operator (&Vector4 + &Vector4).

type Output = Vector4

The resulting type after applying the + operator.

fn add(self, rhs: &Vector4) -> Self::Output

Performs the + operation.

impl Add<&Vector4> for Vector4

type Output = Vector4

The resulting type after applying the + operator.

fn add(self, rhs: &Vector4) -> Self::Output

Performs the + operation.

impl Add<Vector4> for &Vector4

type Output = Vector4

The resulting type after applying the + operator.

fn add(self, rhs: Vector4) -> Self::Output

Performs the + operation.

impl Add for Vector4

type Output = Vector4

The resulting type after applying the + operator.

fn add(self, rhs: Vector4) -> Self::Output

Performs the + operation.

impl Clone for Vector4

fn clone(&self) -> Vector4

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vector4

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

Formats the value using the given formatter.

impl Index<usize> for Vector4

Allows accessing vector components using index vector[index].

Panics

Panics if index is out of bounds (>= 4).

type Output = f32

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Vector4

Allows mutating vector components using index vector[index] = value.

Panics

Panics if index is out of bounds (>= 4).

fn index_mut(&mut self, index: usize) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl Mul<&Vector4> for &Matrix4x4

Implements Matrix * Vector multiplication (&Matrix4x4 * &Vector4). Treats the vector as a column vector.

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: &Vector4) -> Self::Output

Performs the * operation.

impl Mul<&Vector4> for Matrix4x4

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: &Vector4) -> Self::Output

Performs the * operation.

impl Mul<&Vector4> for f32

Implements scalar multiplication (f32 * &Vector4).

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: &Vector4) -> Self::Output

Performs the * operation.

impl Mul<Vector4> for &Matrix4x4

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: Vector4) -> Self::Output

Performs the * operation.

impl Mul<Vector4> for Matrix4x4

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: Vector4) -> Self::Output

Performs the * operation.

impl Mul<Vector4> for f32

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: Vector4) -> Self::Output

Performs the * operation.

impl Mul<f32> for &Vector4

Implements scalar multiplication (&Vector4 * f32).

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Self::Output

Performs the * operation.

impl Mul<f32> for Vector4

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Self::Output

Performs the * operation.

impl Neg for &Vector4

type Output = Vector4

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Neg for Vector4

Implements vector negation using the unary - operator (-vector).

type Output = Vector4

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq for Vector4

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Sub<&Vector4> for &Vector4

Implements vector subtraction using the - operator (&Vector4 - &Vector4).

type Output = Vector4

The resulting type after applying the - operator.

fn sub(self, rhs: &Vector4) -> Self::Output

Performs the - operation.

impl Sub<&Vector4> for Vector4

type Output = Vector4

The resulting type after applying the - operator.

fn sub(self, rhs: &Vector4) -> Self::Output

Performs the - operation.

impl Sub<Vector4> for &Vector4

type Output = Vector4

The resulting type after applying the - operator.

fn sub(self, rhs: Vector4) -> Self::Output

Performs the - operation.

impl Sub for Vector4

type Output = Vector4

The resulting type after applying the - operator.

fn sub(self, rhs: Vector4) -> Self::Output

Performs the - operation.

impl Copy for Vector4

impl StructuralPartialEq for Vector4