Struct nalgebra::linalg::givens::GivensRotation

pub struct GivensRotation<N: ComplexField> { /* fields omitted */ }

A Givens rotation.

Methods

impl<N: ComplexField> GivensRotation<N>

pub fn identity() -> Self

The Givents rotation that does nothing.

pub fn new_unchecked(c: N::RealField, s: N) -> Self

Initializes a Givens rotation from its components.

The components are copies as-is. It is not checked whether they describe an actually valid Givens rotation.

pub fn new(c: N, s: N) -> (Self, N)

Initializes a Givens rotation from its non-normalized cosine an sine components.

pub fn try_new(c: N, s: N, eps: N::RealField) -> Option<(Self, N)>

Initializes a Givens rotation form its non-normalized cosine an sine components.

pub fn cancel_y<S: Storage<N, U2>>(v: &Vector<N, U2, S>) -> Option<(Self, N)>

Computes the rotation R required such that the y component of R * v is zero.

Returns None if no rotation is needed (i.e. if v.y == 0). Otherwise, this returns the norm of v and the rotation r such that R * v = [ |v|, 0.0 ]^t where |v| is the norm of v.

pub fn cancel_x<S: Storage<N, U2>>(v: &Vector<N, U2, S>) -> Option<(Self, N)>

Computes the rotation R required such that the x component of R * v is zero.

Returns None if no rotation is needed (i.e. if v.x == 0). Otherwise, this returns the norm of v and the rotation r such that R * v = [ 0.0, |v| ]^t where |v| is the norm of v.

pub fn c(&self) -> N::RealField

The cos part of this roration.

pub fn s(&self) -> N

The sin part of this roration.

pub fn inverse(&self) -> Self

The inverse of this givens rotation.

pub fn rotate<R2: Dim, C2: Dim, S2: StorageMut<N, R2, C2>>(
    &self,
    rhs: &mut Matrix<N, R2, C2, S2>
) where
    ShapeConstraint: DimEq<R2, U2>, 

Performs the multiplication rhs = self * rhs in-place.

pub fn rotate_rows<R2: Dim, C2: Dim, S2: StorageMut<N, R2, C2>>(
    &self,
    lhs: &mut Matrix<N, R2, C2, S2>
) where
    ShapeConstraint: DimEq<C2, U2>, 

Performs the multiplication lhs = lhs * self in-place.

Trait Implementations

impl<N: Copy + ComplexField> Copy for GivensRotation<N> where
    N::RealField: Copy, 

impl<N: Clone + ComplexField> Clone for GivensRotation<N> where
    N::RealField: Clone, 

fn clone(&self) -> GivensRotation<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: Debug + ComplexField> Debug for GivensRotation<N> where
    N::RealField: Debug, 

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

Formats the value using the given formatter.