X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=octave_packages%2Fm%2Fstatistics%2Fdistributions%2Fstdnormal_inv.m;fp=octave_packages%2Fm%2Fstatistics%2Fdistributions%2Fstdnormal_inv.m;h=d12818170a13db6de7f41a45988caf265e327e06;hb=1c0469ada9531828709108a4882a751d2816994a;hp=0000000000000000000000000000000000000000;hpb=63de9f36673d49121015e3695f2c336ea92bc278;p=CreaPhase.git diff --git a/octave_packages/m/statistics/distributions/stdnormal_inv.m b/octave_packages/m/statistics/distributions/stdnormal_inv.m new file mode 100644 index 0000000..d128181 --- /dev/null +++ b/octave_packages/m/statistics/distributions/stdnormal_inv.m @@ -0,0 +1,57 @@ +## Copyright (C) 2012 Rik Wehbring +## Copyright (C) 1995-2012 Kurt Hornik +## +## This file is part of Octave. +## +## Octave is free software; you can redistribute it and/or modify it +## under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 3 of the License, or (at +## your option) any later version. +## +## Octave is distributed in the hope that it will be useful, but +## WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +## General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with Octave; see the file COPYING. If not, see +## . + +## -*- texinfo -*- +## @deftypefn {Function File} {} stdnormal_inv (@var{x}) +## For each element of @var{x}, compute the quantile (the +## inverse of the CDF) at @var{x} of the standard normal distribution +## (mean = 0, standard deviation = 1). +## @end deftypefn + +## Author: KH +## Description: Quantile function of the standard normal distribution + +function inv = stdnormal_inv (x) + + if (nargin != 1) + print_usage (); + endif + + if (iscomplex (x)) + error ("stdnormal_inv: X must not be complex"); + endif + + inv = sqrt (2) * erfinv (2 * x - 1); + +endfunction + + +%!shared x +%! x = [-1 0 0.5 1 2]; +%!assert(stdnormal_inv (x), [NaN -Inf 0 Inf NaN]); + +%% Test class of input preserved +%!assert(stdnormal_inv ([x, NaN]), [NaN -Inf 0 Inf NaN NaN]); +%!assert(stdnormal_inv (single([x, NaN])), single([NaN -Inf 0 Inf NaN NaN])); + +%% Test input validation +%!error stdnormal_inv () +%!error stdnormal_inv (1,2) +%!error stdnormal_inv (i) +