OptiVec: MF

MF_SVsort

MD_SVsort

ME_SVsort

Function

sort singular values obtained from MF_SVdecompose

Syntax C/C++	#include <MFstd.h> void MF_SVsort( fMatrix MUout, fMatrix MVout, fVector Wout, fMatrix MUraw, fMatrix MVraw, fVector Wraw, ui htU, ui lenU );
C++ MatObj	#include <OptiVec.h> void vector<T>::SVsort( matrix<T> MVout, vector<T> Wout, const matrix<T>& MUraw, const matrix<T>& MVraw, const vector<T>& Wraw );
Pascal/Delphi	uses MFstd; procedure MF_SVsort( MUraw, MVraw:fMatrix; Wraw:fVector; MUraw, MVraw:fMatrix; Wraw:fVector; htU, lenU:UIntSize );

Description

MF_SVsort brings the vector W, containing the unordered singular values, as obtained from MF_SVdecompose, into descending order. Simultaneously, columns of both matrices MV and MU are interchanged accordingly. The "raw" input data are MUraw, MVraw, and Wraw, while the ordered data on output are MUout, MVout, Wout. MUout may or may not overwrite MUraw; the same holds for the pairs MVout / MVraw and Wout / Wraw.

The parameters htU and lenU refer to the matrix MU. They relate to the dimensions of the original matrix MA, fed into MF_SVdecompose, as:
htU = max( lenA, htA );
lenU = lenA;