File: mbl_mod_gram_schmidt.h

package info (click to toggle)
vxl 1.17.0.dfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 153,280 kB
  • ctags: 105,123
  • sloc: cpp: 747,420; ansic: 209,130; fortran: 34,230; lisp: 14,915; sh: 6,187; python: 5,856; makefile: 340; perl: 294; xml: 160
file content (42 lines) | stat: -rw-r--r-- 1,641 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
// This is mul/mbl/mbl_mod_gram_schmidt.h
#ifndef mbl_mod_gram_schmidt_h_
#define mbl_mod_gram_schmidt_h_
//:
// \file
// \brief Orthogonalise a basis using modified Gram-Schmidt (and normalise)
// \author Martin Roberts
//
// Note: Modified Gram-Schmidt is more numerically stable than the classical version
// The partially constructed transformed jth vector is used in the successive projections rather than the untransformed
// \verbatim
// Modifications
// Mar. 2011 - Patrick Sauer - added variant that returns normalisation multipliers
// \endverbatim

#include <vnl/vnl_matrix.h>

//=======================================================================
//: Orthogonalise a basis using modified Gram-Schmidt
// Transform basis {vk} to orthonormal basis {ek} with k in range 1..N
// \code
// for j = 1 to N
//     ej = vj
//     for k = 1 to j-1
//         ej = ej - <ej,ek>ek   //NB Classical GS has vj in inner product
//     end
//     ej = ej/|ej|
//  end
// \endcode

//: Convert input basis {v} to orthonormal basis {e}
// Each basis vector is a column of v, and likewise the orthonormal bases are returned as columns of e
void mbl_mod_gram_schmidt(const vnl_matrix<double>& v,
                          vnl_matrix<double>& e);

//: Convert input basis {v} to orthonormal basis {e}
// Each basis vector is a column of v, and likewise the orthonormal bases are returned as columns of e
// The multipliers used to normalise each vector in {e} are returned in n.
void mbl_mod_gram_schmidt( const vnl_matrix<double>& v, 
                           vnl_matrix<double>& e, vnl_vector<double>& n );

#endif // mbl_mod_gram_schmidt_h_