BVTensorGetFactors#

Returns the two factors involved in the definition of the tensor basis vectors object, V = (I otimes U) S.

Synopsis#

#include "slepcbv.h" 
PetscErrorCode BVTensorGetFactors(BV V,BV *U,Mat *S)

Logically Collective

Input Parameter#

V - the basis vectors context

Output Parameters#

U - the BV factor
S - the Mat factor

Notes#

The returned factors are references (not copies) of the internal factors, so modifying them will change the tensor BV as well. Some operations of the tensor BV assume that U has orthonormal columns, so if the user modifies U this restriction must be taken into account.

The returned factors must not be destroyed. BVTensorRestoreFactors() must be called when they are no longer needed.

Pass a NULL vector for any of the arguments that is not needed.