home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / SCRIPTS.ZIP / scripts / statistics / distributions / f_inv.m < prev    next >
Text File  |  1997-02-19  |  2KB  |  69 lines
  1. ## Copyright (C) 1995, 1996, 1997  Kurt Hornik
  2. ## 
  3. ## This program is free software; you can redistribute it and/or modify
  4. ## it under the terms of the GNU General Public License as published by
  5. ## the Free Software Foundation; either version 2, or (at your option)
  6. ## any later version.
  7. ## 
  8. ## This program is distributed in the hope that it will be useful, but
  9. ## WITHOUT ANY WARRANTY; without even the implied warranty of
  10. ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11. ## General Public License for more details. 
  12. ## 
  13. ## You should have received a copy of the GNU General Public License
  14. ## along with this file.  If not, write to the Free Software Foundation,
  15. ## 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  16.  
  17. ## usage:  f_inv (x, m, n)
  18. ##
  19. ## For each component of x, compute the quantile (the inverse of the
  20. ## CDF) at x of the F distribution with parameters m and n.
  21.  
  22. ## Author:  KH <Kurt.Hornik@ci.tuwien.ac.at>
  23. ## Description:  Quantile function of the F distribution
  24.  
  25. function inv = f_inv (x, m, n)
  26.  
  27.   if (nargin != 3)
  28.     usage ("f_inv (x, m, n)");
  29.   endif
  30.  
  31.   [retval, x, m, n] = common_size (x, m, n);
  32.   if (retval > 0)
  33.     error ("f_inv:  x, m and n must be of common size or scalar");
  34.   endif
  35.   
  36.   [r, c] = size (x);
  37.   s = r * c;
  38.   x = reshape (x, 1, s);
  39.   m = reshape (m, 1, s);
  40.   n = reshape (n, 1, s);
  41.   inv = zeros (1, s);
  42.  
  43.   k = find ((x < 0) | (x > 1) | isnan (x) | !(m > 0) | !(n > 0));
  44.   if any (k)
  45.     inv(k) = NaN * ones (1, length (k));
  46.   endif
  47.   
  48.   k = find ((x == 1) & (m > 0) & (n > 0));
  49.   if any (k)
  50.     inv(k) = Inf * ones (1, length (k));
  51.   endif
  52.   
  53.   k = find ((x > 0) & (x < 1) & (m > 0) & (n > 0));
  54.   if any (k)
  55.     inv(k) = (1 ./ beta_inv (1 - x(k), n(k) / 2, m(k) / 2) - 1) ...
  56.     .* n(k) ./ m(k);
  57.   endif
  58.  
  59.   ## should we really only allow for positive integer m, n?
  60.   k = find ((m != round (m)) | (n != round (n)));
  61.   if any (k)
  62.     fprintf (stderr, ...
  63.          "WARNING:  m and n should be positive integers\n");
  64.     inv(k) = NaN * ones (1, length (k));
  65.   endif
  66.   
  67.   inv = reshape (inv, r, c);
  68.   
  69. endfunction