3200
|
1 ## Copyright (C) 1995, 1996, 1997 Kurt Hornik |
3426
|
2 ## |
3922
|
3 ## This file is part of Octave. |
|
4 ## |
|
5 ## Octave is free software; you can redistribute it and/or modify it |
|
6 ## under the terms of the GNU General Public License as published by |
3200
|
7 ## the Free Software Foundation; either version 2, or (at your option) |
|
8 ## any later version. |
3426
|
9 ## |
3922
|
10 ## Octave is distributed in the hope that it will be useful, but |
3200
|
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of |
|
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
3426
|
13 ## General Public License for more details. |
|
14 ## |
3200
|
15 ## You should have received a copy of the GNU General Public License |
3922
|
16 ## along with Octave; see the file COPYING. If not, write to the Free |
|
17 ## Software Foundation, 59 Temple Place - Suite 330, Boston, MA |
|
18 ## 02111-1307, USA. |
3200
|
19 |
3453
|
20 ## -*- texinfo -*- |
|
21 ## @deftypefn {Function File} {} var (@var{x}) |
3200
|
22 ## For vector arguments, return the (real) variance of the values. |
|
23 ## For matrix arguments, return a row vector contaning the variance for |
|
24 ## each column. |
3453
|
25 ## @end deftypefn |
3426
|
26 |
3456
|
27 ## Author: KH <Kurt.Hornik@ci.tuwien.ac.at> |
|
28 ## Description: Compute variance |
3200
|
29 |
|
30 function y = var(x) |
3426
|
31 |
3200
|
32 if (nargin != 1) |
|
33 usage ("var (x)"); |
|
34 endif |
3426
|
35 |
3200
|
36 [nr, nc] = size (x); |
|
37 if (nr == 0 || nc == 0) |
3456
|
38 error ("var: x must not be empty"); |
3200
|
39 elseif ((nr == 1) && (nc == 1)) |
|
40 y = 0; |
|
41 elseif ((nr == 1) || (nc == 1)) |
|
42 n = length (x); |
|
43 y = (sumsq (x) - sum(x)^2 / n) / (n - 1); |
|
44 else |
|
45 y = (sumsq (x) - sum(x).^2 / nr) / (nr - 1); |
|
46 endif |
3426
|
47 |
3200
|
48 endfunction |