X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?p=CreaPhase.git;a=blobdiff_plain;f=octave_packages%2Fgeneral-1.3.1%2Fsafeprod.m;fp=octave_packages%2Fgeneral-1.3.1%2Fsafeprod.m;h=e7e3ce1e8d7f2487444b8aacd886e62d1117e126;hp=0000000000000000000000000000000000000000;hb=f5f7a74bd8a4900f0b797da6783be80e11a68d86;hpb=1705066eceaaea976f010f669ce8e972f3734b05 diff --git a/octave_packages/general-1.3.1/safeprod.m b/octave_packages/general-1.3.1/safeprod.m new file mode 100644 index 0000000..e7e3ce1 --- /dev/null +++ b/octave_packages/general-1.3.1/safeprod.m @@ -0,0 +1,62 @@ +## Copyright (C) 2008 VZLU Prague, a.s., Czech Republic +## +## 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{p} =} safeprod (@var{x}, @var{dim}) +## @deftypefnx{Function File} {[@var{p}, @var{e}] =} safeprod (@var{x}, @var{dim}) +## This function forms product(s) of elements of the array @var{x} along the dimension +## specified by @var{dim}, analogically to @code{prod}, but avoids overflows and underflows +## if possible. If called with 2 output arguments, @var{p} and @var{e} are computed +## so that the product is @code{@var{p} * 2^@var{e}}. +## @seealso{prod,log2} +## @end deftypefn + +## Author: Jaroslav Hajek + +function [p, e] = safeprod (x, dim) + if (nargin < 1 || nargin > 2) + print_usage (); + endif + + if (nargin < 2) + if (rows(x) == 1) + dim = 2; + else + dim = 1; + endif + endif + + % try the normal algorithm first + if (nargout < 2) + p = prod (x, dim); + else + p = 0; + endif + + % 0, Inf and NaN are possibly problematic results. If detected, use the safe + % formula. + + flag = (p == 0 | ! isfinite (p)); + + if (any (flag(:))) + [f, e] = log2 (x); + p = prod (f, dim); + e = sum (e, dim); + if (nargout < 2) + p = p .* 2.^e; + endif + endif + +endfunction