Mercurial > octave-nkf
annotate scripts/statistics/base/center.m @ 11436:e151e23f73bc
Overhaul base statistics functions and documentation of same.
Add or improve input validation.
Add input validation tests.
Add functional tests.
Improve or re-write documentation strings.
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Mon, 03 Jan 2011 21:23:08 -0800 |
parents | be55736a0783 |
children | fd0a3ac60b0e |
rev | line source |
---|---|
7017 | 1 ## Copyright (C) 1995, 1996, 1997, 1998, 2000, 2002, 2004, 2005, 2006, |
8920 | 2 ## 2007, 2009 Kurt Hornik |
9744
fb3543975ed9
optimize center using bsxfun
Jaroslav Hajek <highegg@gmail.com>
parents:
8977
diff
changeset
|
3 ## Copyright (C) 2009 VZLU Prague |
3426 | 4 ## |
3922 | 5 ## This file is part of Octave. |
6 ## | |
7 ## Octave is free software; you can redistribute it and/or modify it | |
8 ## under the terms of the GNU General Public License as published by | |
7016 | 9 ## the Free Software Foundation; either version 3 of the License, or (at |
10 ## your option) any later version. | |
3426 | 11 ## |
3922 | 12 ## Octave is distributed in the hope that it will be useful, but |
3200 | 13 ## WITHOUT ANY WARRANTY; without even the implied warranty of |
14 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
3426 | 15 ## General Public License for more details. |
16 ## | |
3200 | 17 ## You should have received a copy of the GNU General Public License |
7016 | 18 ## along with Octave; see the file COPYING. If not, see |
19 ## <http://www.gnu.org/licenses/>. | |
3200 | 20 |
3453 | 21 ## -*- texinfo -*- |
10793
be55736a0783
Grammarcheck the documentation from m-files.
Rik <octave@nomad.inbox5.com>
parents:
10330
diff
changeset
|
22 ## @deftypefn {Function File} {} center (@var{x}) |
4844 | 23 ## @deftypefnx {Function File} {} center (@var{x}, @var{dim}) |
3453 | 24 ## If @var{x} is a vector, subtract its mean. |
25 ## If @var{x} is a matrix, do the above for each column. | |
11436
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
26 ## If the optional argument @var{dim} is given, operate along this dimension. |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
27 ## @seealso{studentize} |
3453 | 28 ## @end deftypefn |
3200 | 29 |
5428 | 30 ## Author: KH <Kurt.Hornik@wu-wien.ac.at> |
3456 | 31 ## Description: Center by subtracting means |
3426 | 32 |
8977
f464119ec165
further simplify some stats funcs
Jaroslav Hajek <highegg@gmail.com>
parents:
8920
diff
changeset
|
33 function retval = center (x, dim) |
3426 | 34 |
4844 | 35 if (nargin != 1 && nargin != 2) |
6046 | 36 print_usage (); |
3200 | 37 endif |
38 | |
11436
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
39 if (!isnumeric (x)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
40 error ("center: X must be a numeric vector or matrix"); |
8977
f464119ec165
further simplify some stats funcs
Jaroslav Hajek <highegg@gmail.com>
parents:
8920
diff
changeset
|
41 endif |
f464119ec165
further simplify some stats funcs
Jaroslav Hajek <highegg@gmail.com>
parents:
8920
diff
changeset
|
42 |
10330
e0767a0965f1
fix some stat functions with integers
Jaroslav Hajek <highegg@gmail.com>
parents:
9744
diff
changeset
|
43 if (isinteger (x)) |
e0767a0965f1
fix some stat functions with integers
Jaroslav Hajek <highegg@gmail.com>
parents:
9744
diff
changeset
|
44 x = double (x); |
e0767a0965f1
fix some stat functions with integers
Jaroslav Hajek <highegg@gmail.com>
parents:
9744
diff
changeset
|
45 endif |
e0767a0965f1
fix some stat functions with integers
Jaroslav Hajek <highegg@gmail.com>
parents:
9744
diff
changeset
|
46 |
11436
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
47 nd = ndims (x); |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
48 sz = size (x); |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
49 if (nargin != 2) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
50 ## Find the first non-singleton dimension. |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
51 dim = find (sz > 1, 1); |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
52 if (isempty (dim)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
53 dim = 1; |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
54 endif |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
55 else |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
56 if (!(isscalar (dim) && dim == fix (dim)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
57 || !(1 <= dim && dim <= nd)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
58 error ("center: DIM must be an integer and a valid dimension"); |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
59 endif |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
60 endif |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
61 |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
62 n = size (x, dim); |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
63 |
9744
fb3543975ed9
optimize center using bsxfun
Jaroslav Hajek <highegg@gmail.com>
parents:
8977
diff
changeset
|
64 if (n == 0) |
fb3543975ed9
optimize center using bsxfun
Jaroslav Hajek <highegg@gmail.com>
parents:
8977
diff
changeset
|
65 retval = x; |
8977
f464119ec165
further simplify some stats funcs
Jaroslav Hajek <highegg@gmail.com>
parents:
8920
diff
changeset
|
66 else |
9744
fb3543975ed9
optimize center using bsxfun
Jaroslav Hajek <highegg@gmail.com>
parents:
8977
diff
changeset
|
67 retval = bsxfun (@minus, x, sum (x, dim) / n); |
3200 | 68 endif |
11436
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
69 |
4844 | 70 endfunction |
11436
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
71 |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
72 %!assert(center ([1,2,3]), [-1,0,1]) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
73 %!assert(center (int8 ([1,2,3])), [-1,0,1]) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
74 %!assert(center (ones (3,2,0,2)), zeros (3,2,0,2)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
75 %!assert(center (magic (3)), [3,-4,1;-2,0,2;-1,4,-3]) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
76 |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
77 %% Test input validation |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
78 %!error center () |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
79 %!error center (1, 2, 3) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
80 %!error center ([true true]) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
81 %!error center (1, ones(2,2)) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
82 %!error center (1, 1.5) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
83 %!error center (1, 0) |
e151e23f73bc
Overhaul base statistics functions and documentation of same.
Rik <octave@nomad.inbox5.com>
parents:
10793
diff
changeset
|
84 %!error center (1, 3) |