|
2537
|
1 ## Copyright (C) 1995, 1996 Kurt Hornik |
|
3426
|
2 ## |
|
2537
|
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. |
|
3426
|
7 ## |
|
2537
|
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 |
|
3426
|
11 ## General Public License for more details. |
|
|
12 ## |
|
2537
|
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 |
|
3321
|
17 ## -*- texinfo -*- |
|
3500
|
18 ## @deftypefn {Mapping Function} {} log2 (@var{x}) |
|
3321
|
19 ## @deftypefnx {Mapping Function} {[@var{f}, @var{e}]} log2 (@var{x}) |
|
|
20 ## Compute the base-2 logarithm of @var{x}. With two outputs, returns |
|
|
21 ## @var{f} and @var{e} such that |
|
|
22 ## @iftex |
|
|
23 ## @tex |
|
|
24 ## $1/2 <= |f| < 1$ and $x = f \cdot 2^e$. |
|
|
25 ## @end tex |
|
|
26 ## @end iftex |
|
|
27 ## @ifinfo |
|
|
28 ## 1/2 <= abs(f) < 1 and x = f * 2^e. |
|
|
29 ## @end ifinfo |
|
|
30 ## @end deftypefn |
|
3408
|
31 ## @seealso{log, log10, logspace, and exp} |
|
2537
|
32 |
|
|
33 ## Author: AW <Andreas.Weingessel@ci.tuwien.ac.at> |
|
|
34 ## Created: 17 October 1994 |
|
|
35 ## Adapted-By: jwe |
|
|
36 |
|
|
37 function [f, e] = log2 (x) |
|
|
38 |
|
|
39 if (nargin != 1) |
|
|
40 usage ("y = log2 (x) or [f, e] = log2 (x)"); |
|
|
41 endif |
|
|
42 |
|
|
43 if (nargout < 2) |
|
|
44 f = log (x) / log (2); |
|
|
45 elseif (nargout == 2) |
|
|
46 ## Only deal with the real parts ... |
|
|
47 x = real (x); |
|
3426
|
48 ## Since log (0) gives problems, 0 entries are replaced by 1. |
|
2537
|
49 ## This is corrected later by multiplication with the sign. |
|
|
50 f = abs (x) + (x == 0); |
|
|
51 e = (floor (log (f) / log (2)) + 1) .* (x != 0); |
|
|
52 f = sign (x) .* f ./ (2 .^ e); |
|
|
53 else |
|
|
54 error ("log2 takes at most 2 output arguments"); |
|
|
55 endif |
|
|
56 |
|
|
57 endfunction |
|
|
58 |
