Struct ggez::graphics::na::SVD
[−]
[src]
pub struct SVD<N, R, C> where
C: Dim,
N: Real,
R: DimMin<C>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>, { pub u: Option<Matrix<N, R, <R as DimMin<C>>::Output, <DefaultAllocator as Allocator<N, R, <R as DimMin<C>>::Output>>::Buffer>>, pub v_t: Option<Matrix<N, <R as DimMin<C>>::Output, C, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, C>>::Buffer>>, pub singular_values: Matrix<N, <R as DimMin<C>>::Output, U1, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, U1>>::Buffer>, }
Singular Value Decomposition of a general matrix.
Fields
u: Option<Matrix<N, R, <R as DimMin<C>>::Output, <DefaultAllocator as Allocator<N, R, <R as DimMin<C>>::Output>>::Buffer>>
The left-singular vectors U
of this SVD.
v_t: Option<Matrix<N, <R as DimMin<C>>::Output, C, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, C>>::Buffer>>
The right-singular vectors V^t
of this SVD.
singular_values: Matrix<N, <R as DimMin<C>>::Output, U1, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, U1>>::Buffer>
The singular values of this SVD.
Methods
impl<N, R, C> SVD<N, R, C> where
C: Dim,
N: Real,
R: DimMin<C>,
<R as DimMin<C>>::Output: DimSub<U1>,
DefaultAllocator: Allocator<N, R, C>,
DefaultAllocator: Allocator<N, C, U1>,
DefaultAllocator: Allocator<N, R, U1>,
DefaultAllocator: Allocator<N, <<R as DimMin<C>>::Output as DimSub<U1>>::Output, U1>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
[src]
C: Dim,
N: Real,
R: DimMin<C>,
<R as DimMin<C>>::Output: DimSub<U1>,
DefaultAllocator: Allocator<N, R, C>,
DefaultAllocator: Allocator<N, C, U1>,
DefaultAllocator: Allocator<N, R, U1>,
DefaultAllocator: Allocator<N, <<R as DimMin<C>>::Output as DimSub<U1>>::Output, U1>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
fn new(
matrix: Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>,
compute_u: bool,
compute_v: bool
) -> SVD<N, R, C>
[src]
matrix: Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>,
compute_u: bool,
compute_v: bool
) -> SVD<N, R, C>
Computes the Singular Value Decomposition of matrix
using implicit shift.
fn try_new(
matrix: Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>,
compute_u: bool,
compute_v: bool,
eps: N,
max_niter: usize
) -> Option<SVD<N, R, C>>
[src]
matrix: Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>,
compute_u: bool,
compute_v: bool,
eps: N,
max_niter: usize
) -> Option<SVD<N, R, C>>
Attempts to compute the Singular Value Decomposition of matrix
using implicit shift.
Arguments
compute_u
− set this totrue
to enable the computation of left-singular vectors.compute_v
− set this totrue
to enable the computation of left-singular vectors.eps
− tolerence used to determine when a value converged to 0.max_niter
− maximum total number of iterations performed by the algorithm. If this number of iteration is exceeded,None
is returned. Ifniter == 0
, then the algorithm continues indefinitely until convergence.
fn rank(&self, eps: N) -> usize
[src]
Computes the rank of the decomposed matrix, i.e., the number of singular values greater
than eps
.
fn recompose(
self
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>
[src]
self
) -> Matrix<N, R, C, <DefaultAllocator as Allocator<N, R, C>>::Buffer>
Rebuild the original matrix.
This is useful if some of the singular values have been manually modified. Panics if the right- and left- singular vectors have not been computed at construction-time.
fn pseudo_inverse(
self,
eps: N
) -> Matrix<N, C, R, <DefaultAllocator as Allocator<N, C, R>>::Buffer> where
DefaultAllocator: Allocator<N, C, R>,
[src]
self,
eps: N
) -> Matrix<N, C, R, <DefaultAllocator as Allocator<N, C, R>>::Buffer> where
DefaultAllocator: Allocator<N, C, R>,
Computes the pseudo-inverse of the decomposed matrix.
Any singular value smaller than eps
is assumed to be zero.
Panics if the right- and left- singular vectors have not been computed at
construction-time.
fn solve<R2, C2, S2>(
&self,
b: &Matrix<N, R2, C2, S2>,
eps: N
) -> Matrix<N, C, C2, <DefaultAllocator as Allocator<N, C, C2>>::Buffer> where
C2: Dim,
R2: Dim,
S2: Storage<N, R2, C2>,
DefaultAllocator: Allocator<N, C, C2>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C2>,
ShapeConstraint: SameNumberOfRows<R, R2>,
[src]
&self,
b: &Matrix<N, R2, C2, S2>,
eps: N
) -> Matrix<N, C, C2, <DefaultAllocator as Allocator<N, C, C2>>::Buffer> where
C2: Dim,
R2: Dim,
S2: Storage<N, R2, C2>,
DefaultAllocator: Allocator<N, C, C2>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C2>,
ShapeConstraint: SameNumberOfRows<R, R2>,
Solves the system self * x = b
where self
is the decomposed matrix and x
the unknown.
Any singular value smaller than eps
is assumed to be zero.
Returns None
if the singular vectors U
and V
have not been computed.
Trait Implementations
impl<N, R, C> Copy for SVD<N, R, C> where
C: Dim,
N: Real,
R: DimMin<C>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
Matrix<N, R, <R as DimMin<C>>::Output, <DefaultAllocator as Allocator<N, R, <R as DimMin<C>>::Output>>::Buffer>: Copy,
Matrix<N, <R as DimMin<C>>::Output, C, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, C>>::Buffer>: Copy,
Matrix<N, <R as DimMin<C>>::Output, U1, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, U1>>::Buffer>: Copy,
[src]
C: Dim,
N: Real,
R: DimMin<C>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
Matrix<N, R, <R as DimMin<C>>::Output, <DefaultAllocator as Allocator<N, R, <R as DimMin<C>>::Output>>::Buffer>: Copy,
Matrix<N, <R as DimMin<C>>::Output, C, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, C>>::Buffer>: Copy,
Matrix<N, <R as DimMin<C>>::Output, U1, <DefaultAllocator as Allocator<N, <R as DimMin<C>>::Output, U1>>::Buffer>: Copy,
impl<N, R, C> Clone for SVD<N, R, C> where
C: Dim + Clone,
N: Clone + Real,
R: DimMin<C> + Clone,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
[src]
C: Dim + Clone,
N: Clone + Real,
R: DimMin<C> + Clone,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
fn clone(&self) -> SVD<N, R, C>
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl<N, R, C> Debug for SVD<N, R, C> where
C: Dim + Debug,
N: Debug + Real,
R: DimMin<C> + Debug,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,
[src]
C: Dim + Debug,
N: Debug + Real,
R: DimMin<C> + Debug,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, C>,
DefaultAllocator: Allocator<N, R, <R as DimMin<C>>::Output>,
DefaultAllocator: Allocator<N, <R as DimMin<C>>::Output, U1>,