SVDSolve#

Solves the singular value problem.

Synopsis#

#include "slepcsvd.h" 
PetscErrorCode SVDSolve(SVD svd)

Collective

Input Parameter#

svd - the singular value solver context

Options Database Keys#

-svd_view - print information about the solver used
-svd_view_mat0 - view the first matrix (\(A\))
-svd_view_mat1 - view the second matrix (\(B\))
-svd_view_signature - view the signature matrix (\(\Omega\))
-svd_view_vectors - view the computed singular vectors
-svd_view_values - view the computed singular values
-svd_converged_reason - print reason for convergence/divergence, and number of iterations
-svd_error_absolute - print absolute errors of each singular triplet
-svd_error_relative - print relative errors of each singular triplet
-svd_error_norm - print errors relative to the matrix norms of each singular triplet

Notes#

The problem matrices are specified with SVDSetOperators().

SVDSolve() will return without generating an error regardless of whether all requested solutions were computed or not. Call SVDGetConverged() to get the actual number of computed solutions, and SVDGetConvergedReason() to determine if the solver converged or failed and why.

All the command-line options listed above admit an optional argument specifying the viewer type and options. For instance, use -svd_view_mat0 binary:amatrix.bin to save the \(A\) matrix to a binary file, -svd_view_values draw to draw the computed singular values graphically, or -svd_error_relative :myerr.m:ascii_matlab to save the errors in a file that can be executed in Matlab.