Mercurial > hg > octave-nkf
annotate scripts/strings/mat2str.m @ 14138:72c96de7a403 stable
maint: update copyright notices for 2012
author | John W. Eaton <jwe@octave.org> |
---|---|
date | Mon, 02 Jan 2012 14:25:41 -0500 |
parents | da56d27164fe |
children | f3d52523cde1 |
rev | line source |
---|---|
14138
72c96de7a403
maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents:
13314
diff
changeset
|
1 ## Copyright (C) 2002-2012 Rolf Fabian |
5837 | 2 ## |
3 ## This file is part of Octave. | |
4 ## | |
5 ## Octave is free software; you can redistribute it and/or modify it | |
6 ## under the terms of the GNU General Public License as published by | |
7016 | 7 ## the Free Software Foundation; either version 3 of the License, or (at |
8 ## your option) any later version. | |
5837 | 9 ## |
10 ## Octave is distributed in the hope that it will be useful, but | |
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 ## General Public License for more details. | |
14 ## | |
15 ## You should have received a copy of the GNU General Public License | |
7016 | 16 ## along with Octave; see the file COPYING. If not, see |
17 ## <http://www.gnu.org/licenses/>. | |
5837 | 18 |
19 ## -*- texinfo -*- | |
10793
be55736a0783
Grammarcheck the documentation from m-files.
Rik <octave@nomad.inbox5.com>
parents:
9036
diff
changeset
|
20 ## @deftypefn {Function File} {@var{s} =} mat2str (@var{x}, @var{n}) |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
21 ## @deftypefnx {Function File} {@var{s} =} mat2str (@var{x}, @var{n}, "class") |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
22 ## Format real, complex, and logical matrices as strings. The |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
23 ## returned string may be used to reconstruct the original matrix by using |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
24 ## the @code{eval} function. |
5837 | 25 ## |
9036
58604c45ca74
Cleanup of data types related documentation
Rik <rdrider0-list@yahoo.com>
parents:
8920
diff
changeset
|
26 ## The precision of the values is given by @var{n}. If @var{n} is a |
5837 | 27 ## scalar then both real and imaginary parts of the matrix are printed |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
28 ## to the same precision. Otherwise @code{@var{n}(1)} defines the |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
29 ## precision of the real part and @code{@var{n}(2)} defines the |
12611
708186085e0d
mat2str.m: Limit the number of digits to one less than available for double.
Patrick Häcker <magicmuscleman>
parents:
11587
diff
changeset
|
30 ## precision of the imaginary part. The default for @var{n} is 15. |
5837 | 31 ## |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
32 ## If the argument "class" is given then the class of @var{x} is |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
33 ## included in the string in such a way that @code{eval} will result in the |
5837 | 34 ## construction of a matrix of the same class. |
35 ## | |
36 ## @example | |
37 ## @group | |
8507 | 38 ## mat2str ([ -1/3 + i/7; 1/3 - i/7 ], [4 2]) |
8442
502e58a0d44f
Fix docstrings, add examples, references and tests to string functions
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
7812
diff
changeset
|
39 ## @result{} "[-0.3333+0.14i;0.3333-0.14i]" |
502e58a0d44f
Fix docstrings, add examples, references and tests to string functions
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
7812
diff
changeset
|
40 ## |
8507 | 41 ## mat2str ([ -1/3 +i/7; 1/3 -i/7 ], [4 2]) |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
42 ## @result{} "[-0.3333+0i 0+0.14i;0.3333+0i -0-0.14i]" |
8442
502e58a0d44f
Fix docstrings, add examples, references and tests to string functions
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
7812
diff
changeset
|
43 ## |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
44 ## mat2str (int16([1 -1]), "class") |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
45 ## @result{} "int16([1 -1])" |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
46 ## |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
47 ## mat2str (logical (eye (2))) |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
48 ## @result{} "[true false;false true]" |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
49 ## |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
50 ## isequal (x, eval (mat2str (x))) |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
51 ## @result{} 1 |
5837 | 52 ## @end group |
53 ## @end example | |
54 ## | |
8442
502e58a0d44f
Fix docstrings, add examples, references and tests to string functions
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
7812
diff
changeset
|
55 ## @seealso{sprintf, num2str, int2str} |
5837 | 56 ## @end deftypefn |
57 | |
7016 | 58 ## Author: Rolf Fabian <fabian@tu-cottbus.de> |
59 | |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
60 function s = mat2str (x, n = 15, cls = "") |
5837 | 61 |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
62 if (nargin < 1 || nargin > 3 || ! (isnumeric (x) || islogical (x))) |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
63 print_usage (); |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
64 elseif (ndims (x) > 2) |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
65 error ("mat2str: X must be two dimensional"); |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
66 endif |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
67 |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
68 if (nargin == 2 && ischar (n)) |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
69 cls = n; |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
70 n = 15; |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
71 elseif (isempty (n)) |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
72 n = 15; # Default precision |
5837 | 73 endif |
74 | |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
75 x_islogical = islogical (x); |
7812
c25094267486
strings/mat2str.m: Change is_complex to iscomplex, add tests, add missing ;
kimhanse@gmail.com
parents:
7017
diff
changeset
|
76 x_iscomplex = iscomplex (x); |
5838 | 77 |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
78 if (x_iscomplex) |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
79 if (isscalar (n)) |
5837 | 80 n = [n, n]; |
81 endif | |
5838 | 82 fmt = sprintf ("%%.%dg%%+.%dgi", n(1), n(2)); |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
83 elseif (x_islogical) |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
84 v = {"false", "true"}; |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
85 fmt = "%s"; |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
86 else |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
87 fmt = sprintf ("%%.%dg", n(1)); |
5837 | 88 endif |
89 | |
5838 | 90 nel = numel (x); |
5837 | 91 |
5838 | 92 if (nel == 0) |
93 ## Empty, only print brackets | |
5837 | 94 s = "[]"; |
5838 | 95 elseif (nel == 1) |
96 ## Scalar X, don't print brackets | |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
97 if (x_iscomplex) |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
98 s = sprintf (fmt, real (x), imag (x)); |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
99 elseif (x_islogical) |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
100 s = v{x+1}; |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
101 else |
5838 | 102 s = sprintf (fmt, x); |
5837 | 103 endif |
5838 | 104 else |
105 ## Non-scalar X, print brackets | |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
106 fmt = cstrcat (fmt, " "); |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
107 if (x_iscomplex) |
7812
c25094267486
strings/mat2str.m: Change is_complex to iscomplex, add tests, add missing ;
kimhanse@gmail.com
parents:
7017
diff
changeset
|
108 t = x.'; |
c25094267486
strings/mat2str.m: Change is_complex to iscomplex, add tests, add missing ;
kimhanse@gmail.com
parents:
7017
diff
changeset
|
109 s = sprintf (fmt, [real(t(:))'; imag(t(:))']); |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
110 elseif (x_islogical) |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
111 t = v(x+1); |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
112 s = cstrcat (sprintf (fmt, t{:})); |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
113 else |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
114 s = sprintf (fmt, x.'); |
5837 | 115 endif |
116 | |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
117 s = cstrcat ("[", s); |
5838 | 118 s(end) = "]"; |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
119 idx = strfind (s, " "); |
5946 | 120 nc = columns (x); |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
121 s(idx(nc:nc:end)) = ";"; |
5837 | 122 endif |
123 | |
124 if (strcmp ("class", cls)) | |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
125 s = cstrcat (class (x), "(", s, ")"); |
5837 | 126 endif |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
127 |
5837 | 128 endfunction |
7812
c25094267486
strings/mat2str.m: Change is_complex to iscomplex, add tests, add missing ;
kimhanse@gmail.com
parents:
7017
diff
changeset
|
129 |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
130 |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
131 %!assert (mat2str (0.7), "0.7"); |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
132 %!assert (mat2str (pi), "3.14159265358979"); |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
133 %!assert (mat2str (pi, 5), "3.1416"); |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
134 %!assert (mat2str (single (pi), 5, "class"), "single(3.1416)"); |
7812
c25094267486
strings/mat2str.m: Change is_complex to iscomplex, add tests, add missing ;
kimhanse@gmail.com
parents:
7017
diff
changeset
|
135 %!assert (mat2str ([-1/3 + i/7; 1/3 - i/7], [4 2]), "[-0.3333+0.14i;0.3333-0.14i]") |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
136 %!assert (mat2str ([-1/3 +i/7; 1/3 -i/7], [4 2]), "[-0.3333+0i 0+0.14i;0.3333+0i -0-0.14i]") |
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
137 %!assert (mat2str (int16 ([1 -1]), 'class'), "int16([1 -1])") |
11485
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
138 %!assert (mat2str (true), "true"); |
571bfa4fc295
mat2str: handle logical arguments
John W. Eaton <jwe@octave.org>
parents:
10793
diff
changeset
|
139 %!assert (mat2str (false), "false"); |
13314
da56d27164fe
mat2str.m: Tune function for Matlab compatability and speed.
Rik <octave@nomad.inbox5.com>
parents:
13180
diff
changeset
|
140 %!assert (mat2str (logical (eye (2))), "[true false;false true]"); |
13180
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
141 |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
142 %% Test input validation |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
143 %!error mat2str () |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
144 %!error mat2str (1,2,3,4) |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
145 %!error mat2str (["Hello"]) |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
146 %!error mat2str (ones(3,3,2)) |
c215352ddb4f
mat2str.m: Use more modern code syntax for function
Rik <octave@nomad.inbox5.com>
parents:
12611
diff
changeset
|
147 |