Mercurial > octave-antonio
annotate scripts/special-matrix/pascal.m @ 12639:4d777e05d47c stable
doc: Review and update documentation for "Matrix Manipulation" chapter.
* matrix.txi, arrayfun.m, blkdiag.m, fliplr.m, flipud.m, logspace.m,
postpad.m, prepad.m, randi.m, repmat.m, rot90.m, rotdim.m, shiftdim.m,
sortrows.m, vech.m, xor.m, hadamard.m, hankel.m, hilb.m, invhilb.m, magic.m,
pascal.m, rosser.m, sylvester_matrix.m, toeplitz.m, vander.m, wilkinson.m,
bsxfun.cc, find.cc, lookup.cc, rand.cc, tril.cc, data.cc, arrayfun.m,
blkdiag.m, fliplr.m, flipud.m, logspace.m, postpad.m, prepad.m, randi.m,
repmat.m, rot90.m, rotdim.m, shiftdim.m, sortrows.m, vech.m, xor.m, hadamard.m,
hankel.m, hilb.m, invhilb.m, magic.m, pascal.m, rosser.m, sylvester_matrix.m,
toeplitz.m, vander.m, wilkinson.m, bsxfun.cc (bsxfun), find.cc (find),
lookup.cc (lookup), rand.cc (rand, randn, rande, randg, randp),
tril.cc (triu), data.cc (all, any, horzcat, vertcat, cat, permute, ipermute,
ones, zeros, eye, linspace, resize, reshape, issorted, diff):
Improve docstrings
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Sun, 01 May 2011 08:55:15 -0700 |
parents | f5a5e5252b5a |
children | d4404589498c |
rev | line source |
---|---|
11523 | 1 ## Copyright (C) 1999-2011 Peter Ekberg |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
2 ## Copyright (C) 2009 VZLU Prague |
5827 | 3 ## |
4 ## This file is part of Octave. | |
5 ## | |
6 ## Octave is free software; you can redistribute it and/or modify it | |
7 ## under the terms of the GNU General Public License as published by | |
7016 | 8 ## the Free Software Foundation; either version 3 of the License, or (at |
9 ## your option) any later version. | |
5827 | 10 ## |
11 ## Octave is distributed in the hope that it will be useful, but | |
12 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 ## General Public License for more details. | |
15 ## | |
16 ## You should have received a copy of the GNU General Public License | |
7016 | 17 ## along with Octave; see the file COPYING. If not, see |
18 ## <http://www.gnu.org/licenses/>. | |
5827 | 19 |
20 ## -*- texinfo -*- | |
10791
3140cb7a05a1
Add spellchecker scripts for Octave and run spellcheck of documentation
Rik <octave@nomad.inbox5.com>
parents:
9209
diff
changeset
|
21 ## @deftypefn {Function File} {} pascal (@var{n}) |
3140cb7a05a1
Add spellchecker scripts for Octave and run spellcheck of documentation
Rik <octave@nomad.inbox5.com>
parents:
9209
diff
changeset
|
22 ## @deftypefnx {Function File} {} pascal (@var{n}, @var{t}) |
12639
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
23 ## Return the Pascal matrix of order @var{n} if @code{@var{t} = 0}. @var{t} |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
24 ## defaults to 0. Return the pseudo-lower triangular Cholesky@tie{}factor of |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
25 ## the Pascal matrix if @code{@var{t} = 1} (The sign of some columns may be |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
26 ## negative). This matrix is its own inverse, that is @code{pascal (@var{n}, |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
27 ## 1) ^ 2 == eye (@var{n})}. If @code{@var{t} = -1}, return the true |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
28 ## Cholesky@tie{}factor with strictly positive values on the diagonal. If |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
29 ## @code{@var{t} = 2}, return a transposed and permuted version of @code{pascal |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
30 ## (@var{n}, 1)}, which is the cube root of the identity matrix. That is, |
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
31 ## @code{pascal (@var{n}, 2) ^ 3 == eye (@var{n})}. |
5827 | 32 ## |
12639
4d777e05d47c
doc: Review and update documentation for "Matrix Manipulation" chapter.
Rik <octave@nomad.inbox5.com>
parents:
12485
diff
changeset
|
33 ## @seealso{chol} |
5827 | 34 ## @end deftypefn |
35 | |
36 ## Author: Peter Ekberg | |
37 ## (peda) | |
38 | |
39 function retval = pascal (n, t) | |
40 | |
41 if (nargin > 2) || (nargin == 0) | |
42 print_usage (); | |
43 endif | |
44 | |
45 if (nargin == 1) | |
46 t = 0; | |
47 endif | |
48 | |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
49 if (! isscalar (n) || ! isscalar (t)) |
5827 | 50 error ("pascal: expecting scalar arguments, found something else"); |
51 endif | |
52 | |
11098
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
53 if (t < -1 || t > 2) |
12480
139f993936af
Uppercase variables in script error strings.
Rik <octave@nomad.inbox5.com>
parents:
12448
diff
changeset
|
54 error ("pascal: expecting T to be -1, 0, 1, or 2, found %d", t); |
11098
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
55 endif |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
56 |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
57 retval = zeros (n); |
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
58 retval(:,1) = 1; |
5827 | 59 |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
60 if (t == -1) |
9096 | 61 for j = 2:n |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
62 retval(j:n,j) = cumsum (retval (j-1:n-1,j-1)); |
5827 | 63 endfor |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
64 else |
9096 | 65 for j = 2:n |
9094
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
66 retval(j:n,j) = -cumsum (retval (j-1:n-1,j-1)); |
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
67 endfor |
2e35cfcf6a6a
fix, optimize & extend pascal
Jaroslav Hajek <highegg@gmail.com>
parents:
9051
diff
changeset
|
68 endif |
5827 | 69 |
70 if (t == 0) | |
71 retval = retval*retval'; | |
72 elseif (t == 2) | |
73 retval = retval'; | |
74 retval = retval(n:-1:1,:); | |
75 retval(:,n) = -retval(:,n); | |
76 retval(n,:) = -retval(n,:); | |
77 if (rem(n,2) != 1) | |
78 retval = -retval; | |
79 endif | |
80 endif | |
81 | |
82 endfunction | |
11098
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
83 |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
84 %!assert (pascal(3,-1), [1,0,0;1,1,0;1,2,1]) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
85 %!assert (pascal(3,0), [1,1,1;1,2,3;1,3,6]) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
86 %!assert (pascal(3,0), pascal(3)) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
87 %!assert (pascal(3,1), [1,0,0;1,-1,0;1,-2,1]) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
88 %!assert (pascal(3,2), [0,0,-1;0,-1,2;-1,-1,1]) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
89 %!error (pascal(3,4)) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
90 %!error (pascal(3,-2)) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
91 %!error (pascal()) |
dcde7c5a1d29
new tests for special-matrix functions
John W. Eaton <jwe@octave.org>
parents:
10791
diff
changeset
|
92 %!error (pascal(1,2,3)) |