X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?p=CreaPhase.git;a=blobdiff_plain;f=octave_packages%2Fstatistics-1.1.3%2Fpoisstat.m;fp=octave_packages%2Fstatistics-1.1.3%2Fpoisstat.m;h=707e4056ae946f1c15b016cfa3318cf01717248c;hp=0000000000000000000000000000000000000000;hb=c880e8788dfc484bf23ce13fa2787f2c6bca4863;hpb=1705066eceaaea976f010f669ce8e972f3734b05 diff --git a/octave_packages/statistics-1.1.3/poisstat.m b/octave_packages/statistics-1.1.3/poisstat.m new file mode 100644 index 0000000..707e405 --- /dev/null +++ b/octave_packages/statistics-1.1.3/poisstat.m @@ -0,0 +1,92 @@ +## Copyright (C) 2006, 2007 Arno Onken +## +## This program 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. +## +## This program 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 +## this program; if not, see . + +## -*- texinfo -*- +## @deftypefn {Function File} {[@var{m}, @var{v}] =} poisstat (@var{lambda}) +## Compute mean and variance of the Poisson distribution. +## +## @subheading Arguments +## +## @itemize @bullet +## @item +## @var{lambda} is the parameter of the Poisson distribution. The +## elements of @var{lambda} must be positive +## @end itemize +## +## @subheading Return values +## +## @itemize @bullet +## @item +## @var{m} is the mean of the Poisson distribution +## +## @item +## @var{v} is the variance of the Poisson distribution +## @end itemize +## +## @subheading Example +## +## @example +## @group +## lambda = 1 ./ (1:6); +## [m, v] = poisstat (lambda) +## @end group +## @end example +## +## @subheading References +## +## @enumerate +## @item +## Wendy L. Martinez and Angel R. Martinez. @cite{Computational Statistics +## Handbook with MATLAB}. Appendix E, pages 547-557, Chapman & Hall/CRC, +## 2001. +## +## @item +## Athanasios Papoulis. @cite{Probability, Random Variables, and Stochastic +## Processes}. McGraw-Hill, New York, second edition, 1984. +## @end enumerate +## @end deftypefn + +## Author: Arno Onken +## Description: Moments of the Poisson distribution + +function [m, v] = poisstat (lambda) + + # Check arguments + if (nargin != 1) + print_usage (); + endif + + if (! isempty (lambda) && ! ismatrix (lambda)) + error ("poisstat: lambda must be a numeric matrix"); + endif + + # Set moments + m = lambda; + v = lambda; + + # Continue argument check + k = find (! (lambda > 0) | ! (lambda < Inf)); + if (any (k)) + m(k) = NaN; + v(k) = NaN; + endif + +endfunction + +%!test +%! lambda = 1 ./ (1:6); +%! [m, v] = poisstat (lambda); +%! assert (m, lambda); +%! assert (v, lambda);