home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / SCRIPTS.ZIP / scripts / statistics / distributions / t_inv.m < prev    next >
Encoding:
Text File  |  1997-02-19  |  2.4 KB  |  83 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:  t_inv (x, n)
  18. ##
  19. ## For each component of x, compute the quantile (the inverse of the
  20. ## CDF) at x of the t (Student) distribution with parameter n.
  21.  
  22. ## For very large n, the "correct" formula does not really work well,
  23. ## and the quantiles of the standard normal distribution are used
  24. ## directly.
  25.  
  26. ## Author:  KH <Kurt.Hornik@ci.tuwien.ac.at>
  27. ## Description:  Quantile function of the t distribution
  28.  
  29. function inv = t_inv (x, n)
  30.  
  31.   if (nargin != 2)
  32.     usage ("t_inv (x, n)");
  33.   endif
  34.  
  35.   [retval, x, n] = common_size (x, n);
  36.   if (retval > 0)
  37.     error ("t_inv:  x and n must be of common size or scalar");
  38.   endif
  39.   
  40.   [r, c] = size (x);
  41.   s = r * c;
  42.   x = reshape (x, 1, s);
  43.   n = reshape (n, 1, s);
  44.   inv = zeros (1, s);
  45.  
  46.   k = find ((x < 0) | (x > 1) | isnan (x) | !(n > 0));
  47.   if any (k)
  48.     inv(k) = NaN * ones (1, length (k));
  49.   endif
  50.  
  51.   k = find ((x == 0) & (n > 0));
  52.   if any (k)
  53.     inv(k) = (-Inf) * ones (1, length (k));
  54.   endif
  55.  
  56.   k = find ((x == 1) & (n > 0));
  57.   if any (k)
  58.     inv(k) = Inf * ones (1, length (k));
  59.   endif
  60.   
  61.   k = find ((x > 0) & (x < 1) & (n > 0) & (n < 10000));
  62.   if any (k)
  63.     inv(k) = sign (x(k) - 1/2) .* sqrt (n(k) .* (1 ...
  64.     ./ beta_inv (2 * min (x(k), 1 - x(k)), n(k) / 2, 1 / 2) - 1));
  65.   endif
  66.   
  67.   ## For large n, use the quantiles of the standard normal
  68.   k = find ((x > 0) & (x < 1) & (n >= 10000));
  69.   if any (k)
  70.     inv(k) = stdnormal_inv (x(k));
  71.   endif
  72.     
  73.   ## should we really only allow for positive integer n?
  74.   k = find (n != round (n));
  75.   if any (k)
  76.     fprintf (stderr, ...
  77.          "WARNING:  n should be positive integer\n");
  78.     inv(k) = NaN * ones (1, length (k));
  79.   endif
  80.   
  81.   inv = reshape (inv, r, c);
  82.   
  83. endfunction