nalgebra::linalg::givens

Struct GivensRotation

Source
pub struct GivensRotation<T: ComplexField> { /* private fields */ }
Expand description

A Givens rotation.

Implementations§

Source§

impl<T: ComplexField> GivensRotation<T>

Source

pub fn identity() -> Self

The Givens rotation that does nothing.

Source

pub fn new_unchecked(c: T::RealField, s: T) -> 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.

Source

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

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

Source

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

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

Source

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

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.

Source

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

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.

Source

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

The cos part of this rotation.

Source

pub fn s(&self) -> T

The sin part of this rotation.

Source

pub fn inverse(&self) -> Self

The inverse of this givens rotation.

Source

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

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

Source

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

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

Trait Implementations§

Source§

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

Source§

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

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

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

Source§

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

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

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

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, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. 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> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

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

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

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

Source§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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.