annotate src/pinv.cc @ 1192:b6360f2d4fa6

[project @ 1995-03-30 21:38:35 by jwe]
author jwe
date Thu, 30 Mar 1995 21:38:35 +0000
parents dfe01093f657
children 611d403c7f3d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
1 // f-pinv.cc -*- C++ -*-
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
2 /*
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
3
1009
dfe01093f657 [project @ 1995-01-04 04:05:12 by jwe]
jwe
parents: 718
diff changeset
4 Copyright (C) 1994, 1995 John W. Eaton
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
5
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
6 This file is part of Octave.
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
7
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
8 Octave is free software; you can redistribute it and/or modify it
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
9 under the terms of the GNU General Public License as published by the
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
10 Free Software Foundation; either version 2, or (at your option) any
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
11 later version.
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
12
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
13 Octave is distributed in the hope that it will be useful, but WITHOUT
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
16 for more details.
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
17
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
18 You should have received a copy of the GNU General Public License
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
19 along with Octave; see the file COPYING. If not, write to the Free
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
20 Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
21
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
22 */
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
23
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
24 #ifdef HAVE_CONFIG_H
1192
b6360f2d4fa6 [project @ 1995-03-30 21:38:35 by jwe]
jwe
parents: 1009
diff changeset
25 #include <config.h>
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
26 #endif
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
27
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
28 #include "dMatrix.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
29 #include "CMatrix.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
30
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
31 #include "tree-const.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
32 #include "user-prefs.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
33 #include "gripes.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
34 #include "error.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
35 #include "utils.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
36 #include "help.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
37 #include "defun-dld.h"
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
38
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
39 DEFUN_DLD_BUILTIN ("pinv", Fpinv, Spinv, 3, 1,
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
40 "pinv ( [, tol])\n\
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
41 Returns the pseudoinverse of X; singular values less than tol are ignored.")
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
42 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
43 Octave_object retval;
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
44
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
45 int nargin = args.length ();
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
46
712
36ba0576bd1b [project @ 1994-09-19 14:18:15 by jwe]
jwe
parents: 700
diff changeset
47 if (nargin < 1 || nargin > 2)
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
48 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
49 print_usage ("pinv");
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
50 return retval;
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
51 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
52
712
36ba0576bd1b [project @ 1994-09-19 14:18:15 by jwe]
jwe
parents: 700
diff changeset
53 tree_constant arg = args(0);
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
54
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
55 double tol = 0.0;
712
36ba0576bd1b [project @ 1994-09-19 14:18:15 by jwe]
jwe
parents: 700
diff changeset
56 if (nargin == 2)
36ba0576bd1b [project @ 1994-09-19 14:18:15 by jwe]
jwe
parents: 700
diff changeset
57 tol = args(1).double_value ();
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
58
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
59 if (error_state)
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
60 return retval;
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
61
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
62 if (tol < 0.0)
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
63 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
64 error ("pinv: tol must be greater than zero");
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
65 return retval;
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
66 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
67
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
68 int arg_is_empty = empty_arg ("pinv", arg.rows (), arg.columns ());
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
69
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
70 if (arg_is_empty < 0)
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
71 return retval;
718
e81d3a66725e [project @ 1994-09-21 14:58:18 by jwe]
jwe
parents: 712
diff changeset
72 else if (arg_is_empty > 0)
700
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
73 return Matrix ();
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
74
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
75 if (arg.is_real_type ())
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
76 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
77 Matrix m = arg.matrix_value ();
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
78
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
79 if (! error_state)
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
80 retval = m.pseudo_inverse (tol);
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
81 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
82 else if (arg.is_complex_type ())
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
83 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
84 ComplexMatrix m = arg.complex_matrix_value ();
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
85
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
86 if (! error_state)
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
87 retval = m.pseudo_inverse (tol);
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
88 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
89 else
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
90 {
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
91 gripe_wrong_type_arg ("pinv", arg);
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
92 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
93
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
94 return retval;
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
95 }
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
96
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
97 /*
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
98 ;;; Local Variables: ***
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
99 ;;; mode: C++ ***
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
100 ;;; page-delimiter: "^/\\*" ***
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
101 ;;; End: ***
5d852fb75139 [project @ 1994-09-15 02:23:24 by jwe]
jwe
parents:
diff changeset
102 */