Mercurial > hg > octave-nkf
annotate NEWS @ 10406:0c8d2278c57f
update NEWS
| author | Jaroslav Hajek <highegg@gmail.com> |
|---|---|
| date | Tue, 09 Mar 2010 08:08:42 +0100 |
| parents | ee93dbfba45b |
| children | 0a210203481b |
| rev | line source |
|---|---|
| 9352 | 1 Summary of important user-visible changes for version 3.3: |
| 2 --------------------------------------------------------- | |
| 3 | |
|
9799
cfd0aa788ae1
remove reference blas and lapack sources
John W. Eaton <jwe@octave.org>
parents:
9745
diff
changeset
|
4 ** BLAS and LAPACK libraries are now required to build Octave. The |
|
cfd0aa788ae1
remove reference blas and lapack sources
John W. Eaton <jwe@octave.org>
parents:
9745
diff
changeset
|
5 subset of the reference BLAS and LAPACK libraries has been removed |
|
cfd0aa788ae1
remove reference blas and lapack sources
John W. Eaton <jwe@octave.org>
parents:
9745
diff
changeset
|
6 from the Octave sources. |
|
cfd0aa788ae1
remove reference blas and lapack sources
John W. Eaton <jwe@octave.org>
parents:
9745
diff
changeset
|
7 |
| 10118 | 8 ** The `lookup' function was extended to be more useful for |
| 9 general-purpose binary searching. Using this improvement, the | |
| 10 ismember function was rewritten for significantly better | |
| 11 performance. | |
| 9352 | 12 |
| 13 ** Real, integer and logical matrices, when used in indexing, will now | |
| 14 cache the internal index_vector value (zero-based indices) when | |
| 15 successfully used as indices, eliminating the conversion penalty for | |
| 10118 | 16 subsequent indexing by the same matrix. In particular, this means it |
| 17 is no longer needed to avoid repeated indexing by logical arrays | |
| 18 using find for performance reasons. | |
| 9888 | 19 |
| 10118 | 20 ** Logical matrices are now treated more efficiently when used as |
| 21 indices. Octave will keep the index as a logical mask unless the | |
| 22 ratio of true elements is small enough, using a specialized | |
| 23 code. Previously, all logical matrices were always first converted | |
| 24 to index vectors. This results in savings in both memory and | |
| 25 computing time. | |
| 9480 | 26 |
| 10118 | 27 ** The `sub2ind' and `ind2sub' functions were reimplemented as compiled |
| 28 functions for better performance. These functions are now faster, | |
| 29 can deliver more economized results for ranges, and can reuse the | |
| 30 index cache mechanism described in previous paragraph. | |
| 31 | |
| 32 ** The built-in function equivalents to associative operators (`plus', | |
| 33 `times', `mtimes', `and', and `or') have been extended to accept | |
| 34 multiple arguments. This is especially useful for summing | |
| 35 (multiplying, etc.) lists of objects (of possibly distinct types): | |
| 9408 | 36 |
| 9449 | 37 matrix_sum = plus (matrix_list{:}); |
| 38 | |
| 10118 | 39 ** An FTP object type based on libcurl has been implemented. These |
| 40 objects allow ftp connections, downloads and uploads to be | |
| 41 managed. For example, | |
| 9880 | 42 |
| 10118 | 43 fp = ftp ("ftp.octave.org); |
| 44 cd (fp, "gnu/octave"); | |
| 45 mget (fp, "octave-3.2.3.tar.bz2"); | |
| 46 close (fp); | |
| 9880 | 47 |
| 10118 | 48 ** The default behavior of `assert (observed, expected)' has been |
| 49 relaxed to employ less strict checking that does not require the | |
| 50 internals of the values to match. This avoids previously valid | |
| 51 tests from breaking due to new internal classes introduced in future | |
| 52 Octave versions. | |
| 9449 | 53 |
| 54 For instance, all of these assertions were true in Octave 3.0.x | |
| 55 but false in 3.2.x due to new optimizations and improvements: | |
| 56 | |
| 57 assert (2*linspace (1, 5, 5), 2*(1:5)) | |
| 58 assert (zeros (0, 0), []) | |
| 59 assert (2*ones (1, 5), (2) (ones (1,5))) | |
| 9462 | 60 |
| 10118 | 61 ** The behavior of library functions `ismatrix', `issquare', and |
| 62 `issymmetric' has been changed for better consistency. | |
| 9873 | 63 |
| 10292 | 64 * The `ismatrix' function now returns true for all numeric, |
| 65 logical and character 2d or Nd matrices. Previously, `ismatrix' | |
| 66 returned false if the first or second dimension was zero. | |
| 67 Hence, `ismatrix ([])' was false, | |
| 68 while `ismatrix (zeros (1,2,0))' was true. | |
| 9873 | 69 |
| 10118 | 70 * The `issquare' function now returns a logical scalar, and is |
| 71 equivalent to the expression | |
| 72 | |
| 73 ismatrix (x) && ndims (x) == 2 && rows (x) == columns (x) | |
| 74 | |
| 75 The dimension is no longer returned. As a result, `issquare ([])' | |
| 76 now yields true. | |
| 9873 | 77 |
| 10118 | 78 * The `issymmetric' function now checks for symmetry instead of |
| 79 hermitianness. For the latter, ishermitian was created. Also, | |
| 80 logical scalar is returned rather than the dimension, so | |
| 81 `issymmetric ([])' is now true. | |
| 9873 | 82 |
| 10118 | 83 ** Function handles are now aware of overloaded functions. If a |
| 84 function is overloaded, the handle determines at the time of its | |
| 85 reference which function to call. A non-overloaded version does not | |
| 86 need to exist. | |
| 9873 | 87 |
| 10118 | 88 ** Overloading functions for built-in classes (double, int8, cell, |
| 89 etc.) is now compatible with Matlab. | |
| 9408 | 90 |
| 10323 | 91 ** Function handles can now be compared with the == and != operators, |
| 92 as well as the `isequal' function. | |
| 93 | |
| 10118 | 94 ** Performance of concatenation (using []) and the functions `cat', |
| 95 `horzcat', and `vertcat' has been improved for multidimensional | |
| 96 arrays. | |
| 10117 | 97 |
| 9547 | 98 ** The operation-assignment operators +=, -=, *= and /= now behave more |
| 10118 | 99 efficiently in certain cases. For instance, if M is a matrix and S a |
| 100 scalar, then the statement | |
| 9547 | 101 |
| 10118 | 102 M += S; |
| 9547 | 103 |
| 10118 | 104 will operate on M's data in-place if it is not shared by another |
| 105 variable, usually increasing both time and memory efficiency. | |
| 9547 | 106 |
| 9558 | 107 Only selected common combinations are affected, namely: |
| 9547 | 108 |
| 109 matrix += matrix | |
| 110 matrix -= matrix | |
| 9558 | 111 matrix .*= matrix |
| 112 matrix ./= matrix | |
| 113 | |
| 9547 | 114 matrix += scalar |
| 115 matrix -= scalar | |
| 116 matrix *= scalar | |
| 117 matrix /= scalar | |
| 9558 | 118 |
| 9552 | 119 logical matrix |= logical matrix |
| 120 logical matrix &= logical matrix | |
| 9547 | 121 |
| 10118 | 122 where matrix and scalar belong to the same class. The left-hand |
| 123 side must be a simple variable reference. | |
| 9888 | 124 |
| 10118 | 125 Moreover, when unary operators occur in expressions, Octave will |
| 126 also try to do the operation in-place if it's argument is a | |
| 127 temporary expresssion. | |
| 9589 | 128 |
| 10118 | 129 ** The effect of comparison operators (<, >, <=, and >=) applied to |
| 130 complex numbers has changed to be consistent with the strict | |
| 131 ordering defined by the `max', `min', and `sort' functions. More | |
| 132 specifically, complex numbers are compared by lexicographical | |
| 133 comparison of the pairs `[abs(z), arg(z)]'. Previously, only real | |
| 134 parts were compared; this can be trivially achieved by wrapping the | |
| 135 operands in real(). | |
| 9547 | 136 |
| 10118 | 137 ** The automatic simplification of complex computation results has |
| 138 changed. Octave will now simplify any complex number with a zero | |
| 139 imaginary part or any complex matrix with all elements having zero | |
| 140 imaginary part to a real value. Previously, this was done only for | |
| 141 positive zeros. Note that the behavior of the complex function is | |
| 142 unchanged and it still produces a complex value even if the | |
| 143 imaginary part is zero. | |
| 9826 | 144 |
| 10118 | 145 ** As a side effect of code refactoring in liboctave, the binary |
| 146 logical operations are now more easily amenable to compiler | |
| 147 optimizations and are thus significantly faster. | |
| 9595 | 148 |
| 10118 | 149 ** Octave now allows user-defined `subsasgn' methods to optimize out |
| 150 redundant copies. For more information, see the manual. | |
| 9595 | 151 |
| 10118 | 152 ** More efficient matrix division handling. Octave is now able to |
| 153 handle the expressions | |
| 9664 | 154 |
| 10118 | 155 M' \ V |
| 156 M.' \ V | |
| 157 V / M | |
| 9664 | 158 |
| 10118 | 159 (M is a matrix and V is a vector) more efficiently in certain cases. |
| 160 In particular, if M is triangular, all three expressions will be | |
| 161 handled by a single call to xTRTRS (from LAPACK), with appropriate | |
| 162 flags. Previously, all three expressions required a physical | |
| 163 transpose of M. | |
| 9664 | 164 |
| 10118 | 165 ** More efficient handling of certain mixed real-complex matrix |
| 166 operations. For instance, if RM is a real matrix and CM a complex | |
| 167 matrix, | |
| 9664 | 168 |
| 10118 | 169 RM * CM |
| 9664 | 170 |
| 171 can now be evaluated either as | |
| 172 | |
| 173 complex (RM * real (CM), RM * imag (CM)) | |
| 174 | |
| 175 or as | |
| 176 | |
| 177 complex (RM) * CM, | |
| 178 | |
| 10118 | 179 depending on the dimensions. The first form requires more temporaries |
| 180 and copying, but halves the FLOP count, which normally brings better | |
| 181 performance if RM has enough rows. Previously, the second form was | |
| 182 always used. | |
| 9664 | 183 |
| 184 Matrix division is similarly affected. | |
| 185 | |
| 10118 | 186 ** More efficient handling of triangular matrix factors returned from |
| 187 factorizations. The functions for computing QR, LU and Cholesky | |
| 188 factorizations will now automatically return the triangular matrix | |
| 189 factors with proper internal matrix_type set, so that it won't need | |
| 190 to be computed when the matrix is used for division. | |
| 9717 | 191 |
| 10118 | 192 ** The built-in `sum' function now handles the non-native summation |
| 193 (i.e., double precision sum of single or integer inputs) more | |
| 194 efficiently, avoiding a temporary conversion of the whole input | |
| 195 array to doubles. Further, `sum' can now accept an extra option | |
| 196 argument, using a compensated summation algorithm rather than a | |
| 197 straightforward sum, which significantly improves precision if lots | |
| 198 of cancellation occurs in the summation. | |
| 9717 | 199 |
| 10118 | 200 ** The built-in `bsxfun' function now uses optimized code for certain |
| 201 cases where built-in operator handles are passed in. Namely, the | |
| 202 optimizations concern the operators `plus', `minus', `times', | |
| 203 `ldivide', `rdivide', `power', `and', `or' (for logical arrays), | |
| 204 the relational operators `eq', `ne', `lt', `le', `gt', `ge', and the | |
| 205 functions `min' and `max'. Optimizations only apply when both | |
| 206 operands are of the same built-in class. Mixed real/complex and | |
| 207 single/double operations will first convert both operands to a | |
| 208 common type. | |
| 9745 | 209 |
| 10118 | 210 ** The `strfind' and `strrep' functions now have compiled |
| 211 implementations, facilitating significantly more efficient searching | |
| 212 and replacing in strings, especially with longer patterns. The code | |
| 213 of `strcat' has been vectorized and is now much more efficient when | |
| 214 many strings are concatenated. The `strcmpi' and `strncmpi' | |
| 215 functions are now built-in functions, providing better performance. | |
| 10208 | 216 |
| 217 ** Matlab-style ignoring input and output function arguments using tilde (~) | |
| 218 is now supported. For more details, consult the manual. | |
| 10233 | 219 |
| 220 ** The list datatype, deprecated since the introduction of cells, has been removed. | |
| 10276 | 221 |
| 222 ** The accumarray function has been optimized and is now significantly faster | |
| 223 in certain important cases. | |
| 10054 | 224 |
| 10292 | 225 ** The behavior of isreal and isnumeric functions was changed to be more |
| 226 Matlab-compatible. | |
| 227 | |
| 10406 | 228 ** The integer math & conversion warnings (Octave:int-convert-nan, |
| 229 Octave:int-convert-non-int-val, Octave:int-convert-overflow, | |
| 230 Octave:int-math-overflow) have been removed. | |
| 231 | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
232 Summary of important user-visible changes for version 3.2: |
| 5913 | 233 --------------------------------------------------------- |
| 2452 | 234 |
| 8737 | 235 ** Compatibility with Matlab graphics has been improved. |
| 6329 | 236 |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
237 The hggroup object and associated listener callback functions have |
| 8737 | 238 been added allowing the inclusion of group objects. Data sources |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
239 have been added to these group objects such that |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
240 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
241 x = 0:0.1:10; |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
242 y = sin (x); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
243 plot (x, y, "ydatasource", "y"); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
244 for i = 1 : 100 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
245 pause(0.1) |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
246 y = sin (x + 0.1 * i); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
247 refreshdata(); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
248 endfor |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
249 |
| 8737 | 250 works as expected. This capability has be used to introduce |
|
9031
1052a66078cf
Documentation cleanup of top-level Octave directory (READMEs, INSTALL)
Rik <rdrider0-list@yahoo.com>
parents:
8932
diff
changeset
|
251 stem-series, bar-series, etc., objects for better Matlab |
| 8737 | 252 compatibility. |
| 253 | |
| 254 ** New graphics functions: | |
| 255 | |
|
9110
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
256 addlistener ezcontour gcbo refresh |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
257 addproperty ezcontourf ginput refreshdata |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
258 allchild ezmesh gtext specular |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
259 available_backends ezmeshc intwarning surfl |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
260 backend ezplot ishghandle trisurf |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
261 cla ezplot3 isocolors waitforbuttonpress |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
262 clabel ezpolar isonormals |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
263 comet ezsurf isosurface |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
264 dellistener findall linkprop |
|
22ae6b3411a7
Add isocolor, isonormals and isosurface functions (For Martin Helm). Add 3D filled triangular patches and the trisurf function
David Bateman <dbateman@free.fr>
parents:
9042
diff
changeset
|
265 diffuse gcbf plotmatrix |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
266 |
| 8737 | 267 ** New experimental OpenGL/FLTK based plotting system. |
| 268 | |
| 269 An experimental plotting system based on OpenGL and the FLTK | |
| 270 toolkit is now part of Octave. This backend is disabled by | |
| 271 default. You can switch to using it with the command | |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
272 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
273 backend ("fltk") |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
274 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
275 for all future figures or for a particular figure with the command |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
276 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
277 backend (h, "fltk") |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
278 |
| 8737 | 279 where "h" is a valid figure handle. Please note that this backend |
| 280 does not yet support text objects. Obviously, this is a necessary | |
| 281 feature before it can be considered usable. We are looking for | |
| 282 volunteers to help implement this missing feature. | |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
283 |
| 8737 | 284 ** Functions providing direct access to gnuplot have been removed. |
| 285 | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
286 The functions __gnuplot_plot__, __gnuplot_set__, __gnuplot_raw__, |
|
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
287 __gnuplot_show__, __gnuplot_replot__, __gnuplot_splot__, |
| 8737 | 288 __gnuplot_save_data__ and __gnuplot_send_inline_data__ have been |
| 289 removed from Octave. These function were incompatible with the | |
| 290 high level graphics handle code. | |
| 6329 | 291 |
| 8885 | 292 ** The Control, Finance and Quaternion functions have been removed. |
| 293 | |
| 294 These functions are now available as separate packages from | |
| 295 | |
| 296 http://octave.sourceforge.net/packages.html | |
| 297 | |
| 298 and can be reinstalled using the Octave package manager (see | |
| 299 the pkg function). | |
| 300 | |
| 301 ** Specific sparse matrix functions removed. | |
| 302 | |
| 303 The following functions, which handled only sparse matrices have | |
| 304 been removed. Instead of calling these functions directly, you | |
| 305 should use the corresponding function without the "sp" prefix. | |
| 8737 | 306 |
| 8885 | 307 spatan2 spcumsum spkron spprod |
| 308 spchol spdet splchol spqr | |
| 309 spchol2inv spdiag splu spsum | |
| 310 spcholinv spfind spmax spsumsqk | |
| 311 spcumprod spinv spmin | |
| 312 | |
| 313 ** Improvements to the debugger. | |
| 314 | |
| 315 The interactive debugging features have been improved. Stopping | |
| 316 on statements with dbstop should work correctly now. Stepping | |
| 317 into and over functions, and stepping one statement at a time | |
| 318 (with dbstep) now works. Moving up and down the call stack with | |
| 319 dbup and dbdown now works. The dbstack function is now available | |
| 320 to print the current function call stack. The new dbquit function | |
| 321 is available to exit the debugging mode. | |
| 322 | |
| 323 ** Improved traceback error messages. | |
| 324 | |
| 325 Traceback error messages are much more concise and easier to | |
| 326 understand. They now display information about the function call | |
| 327 stack instead of the stack of all statements that were active at | |
| 328 the point of the error. | |
|
8014
44d206ae68c9
improve fsolve compatibility
John W. Eaton <jwe@octave.org>
parents:
7990
diff
changeset
|
329 |
| 8737 | 330 ** Object Oriented Programming. |
|
8405
d79dfbff2f9d
document new norm features in NEWS
Jaroslav Hajek <highegg@gmail.com>
parents:
8396
diff
changeset
|
331 |
| 8737 | 332 Octave now includes OOP features and the user can create their own |
| 333 class objects and overloaded functions and operators. For | |
| 334 example, all methods of a class called "myclass" will be found in | |
| 335 a directory "@myclass" on the users path. The class specific | |
| 336 versions of functions and operators take precedence over the | |
| 337 generic versions of these functions. | |
| 338 | |
| 339 New functions related to OOP include | |
| 7189 | 340 |
| 8737 | 341 class inferiorto isobject loadobj methods superiorto |
| 342 | |
| 343 See the Octave manual for more details. | |
| 7038 | 344 |
| 8747 | 345 ** Parsing of Command-style Functions. |
| 346 | |
| 347 Octave now parses command-style functions without needing to first | |
| 348 declare them with "mark_as_command". The rules for recognizing a | |
| 349 command-style function calls are | |
| 350 | |
| 351 * A command must appear as the first word in a statement, | |
| 352 followed by a space. | |
| 353 | |
| 354 * The first character after the space must not be '=' or '(' | |
| 355 | |
| 356 * The next token after the space must not look like a binary | |
| 357 operator. | |
| 358 | |
| 359 These rules should be mostly compatible with the way Matlab parses | |
| 360 command-style function calls and allow users to define commands in | |
| 361 .m files without having to mark them as commands. | |
| 362 | |
| 363 Note that previous versions of Octave allowed expressions like | |
| 364 | |
| 365 x = load -text foo.dat | |
| 366 | |
| 367 but an expression like this will now generate a parse error. In | |
| 368 order to assign the value returned by a function to a variable, | |
| 369 you must use the normal function call syntax: | |
| 370 | |
| 371 x = load ("-text", "foo.dat"); | |
| 372 | |
| 8737 | 373 ** Block comments. |
| 374 | |
| 8747 | 375 Commented code can be between matching "#{" and "#}" or "%{" and |
| 376 "%}" markers, even if the commented code spans several line. This | |
| 377 allows blocks code to be commented, without needing to comment | |
| 378 each line. For example, | |
| 5814 | 379 |
| 8747 | 380 function [s, t] = func (x, y) |
| 381 s = 2 * x; | |
| 382 #{ | |
| 383 s *= y; | |
| 384 t = y + x; | |
| 385 #} | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
386 endfunction |
| 5814 | 387 |
| 8747 | 388 the lines "s *= y;" and "t = y + x" will not be executed. |
| 8737 | 389 |
| 390 ** Special treatment in the parser of expressions like "a' * b". | |
| 2452 | 391 |
| 8737 | 392 In these cases the transpose is no longer explicitly formed and |
| 393 BLAS libraries are called with the transpose flagged, | |
| 394 significantly improving performance for these kinds of | |
| 395 operations. | |
|
8417
654bcfb937bf
Add the eigs and svds functions
David Bateman <dbateman@free.fr>
parents:
8405
diff
changeset
|
396 |
| 8737 | 397 ** Single Precision data type. |
| 2452 | 398 |
| 8737 | 399 Octave now includes a single precision data type. Single |
| 400 precision variables can be created with the "single" command, or | |
|
9034
52515efc50c0
Documentation cleanup on NEWS file
Rik <rdrider0-list@yahoo.com>
parents:
9031
diff
changeset
|
401 from functions like ones, eye, etc. For example, |
| 5995 | 402 |
| 8737 | 403 single (1) |
| 404 ones (2, 2, "single") | |
| 405 zeros (2, 2, "single") | |
| 406 eye (2, 2, "single") | |
| 407 Inf (2, 2, "single") | |
| 408 NaN (2, 2, "single") | |
| 409 NA (2, 2, "single") | |
| 7279 | 410 |
| 8737 | 411 all create single precision variables. For compatibility with |
| 412 Matlab, mixed double/single precision operators and functions | |
| 413 return single precision types. | |
| 414 | |
| 415 As a consequence of this addition to Octave the internal | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
416 representation of the double precision NA value has changed, and |
|
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
417 so users that make use of data generated by Octave with R or |
|
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
418 visa-versa are warned that compatibility might not be assured. |
| 7279 | 419 |
| 8737 | 420 ** Improved array indexing. |
| 421 | |
| 422 The underlying code used for indexing of arrays has been | |
|
9034
52515efc50c0
Documentation cleanup on NEWS file
Rik <rdrider0-list@yahoo.com>
parents:
9031
diff
changeset
|
423 completely rewritten and indexing is now significantly faster. |
| 8737 | 424 |
| 8755 | 425 ** Improved memory management. |
| 426 | |
| 427 Octave will now attempt to share data in some cases where previously | |
| 428 a copy would be made, such as certain array slicing operations or | |
|
9031
1052a66078cf
Documentation cleanup of top-level Octave directory (READMEs, INSTALL)
Rik <rdrider0-list@yahoo.com>
parents:
8932
diff
changeset
|
429 conversions between cells, structs and cs-lists. This usually reduces |
| 8755 | 430 both time and memory consumption. |
| 9128 | 431 Also, Octave will now attempt to detect and optimize usage of a vector |
| 432 as a stack, when elements are being repeatedly inserted at/removed from | |
| 433 the end of the vector. | |
| 8755 | 434 |
| 8738 | 435 ** Improved performance for reduction operations. |
| 436 | |
| 8755 | 437 The performance of the sum, prod, sumsq, cumsum, cumprod, any, all, |
| 438 max and min functions has been significantly improved. | |
| 8738 | 439 |
| 9006 | 440 ** Sorting and searching. |
| 441 | |
| 442 The performance of sort has been improved, especially when sorting | |
| 443 indices are requested. An efficient built-in issorted implementation | |
| 444 was added. sortrows now uses a more efficient algorithm, especially | |
| 445 in the homegeneous case. lookup is now a built-in function performing | |
| 446 a binary search, optimized for long runs of close elements. Lookup | |
| 447 also works with cell arrays of strings. | |
| 448 | |
| 449 ** Range arithmetics | |
| 450 | |
| 451 For some operations on ranges, Octave will attempt to keep the result as a | |
| 452 range. These include negation, adding a scalar, subtracting a scalar, and | |
| 453 multiplying by a scalar. Ranges with zero increment are allowed and can be | |
| 454 constructed using the built-in function `ones'. | |
| 455 | |
| 456 ** Various performance improvements. | |
| 457 | |
| 458 Performance of a number of other built-in operations and functions was | |
| 459 improved, including: | |
| 460 | |
| 461 * logical operations | |
| 462 * comparison operators | |
| 463 * element-wise power | |
| 464 * accumarray | |
| 465 * cellfun | |
| 466 * isnan | |
| 467 * isinf | |
| 468 * isfinite | |
| 469 * nchoosek | |
| 470 * repmat | |
| 471 * strcmp | |
| 472 | |
| 8737 | 473 ** 64-bit integer arithmetic. |
| 474 | |
| 475 Arithmetic with 64-bit integers (int64 and uint64 types) is fully | |
| 476 supported, with saturation semantics like the other integer types. | |
| 477 Performance of most integer arithmetic operations has been | |
| 478 improved by using integer arithmetic directly. Previously, Octave | |
| 479 performed integer math with saturation semantics by converting the | |
| 480 operands to double precision, performing the operation, and then | |
| 481 converting the result back to an integer value, truncating if | |
| 482 necessary. | |
| 483 | |
| 8885 | 484 ** Diagonal and permutation matrices. |
| 485 | |
| 486 The interpreter can now treat diagonal and permutation matrices as | |
| 487 special objects that store only the non-zero elements, rather than | |
| 488 general full matrices. Therefore, it is now possible to construct | |
| 489 and use these matrices in linear algebra without suffering a | |
| 490 performance penalty due to storing large numbers of zero elements. | |
| 491 | |
| 492 ** Improvements to fsolve. | |
| 493 | |
| 494 The fsolve function now accepts an option structure argument (see | |
| 495 also the optimset function). The INFO values returned from fsolve | |
| 496 have changed to be compatible with Matlab's fsolve function. | |
| 497 Additionally, fsolve is now able to solve overdetermined systems, | |
| 498 complex-differentiable complex systems, systems with a sparse | |
| 499 jacobian and can work in single precision if given single precision | |
|
9031
1052a66078cf
Documentation cleanup of top-level Octave directory (READMEs, INSTALL)
Rik <rdrider0-list@yahoo.com>
parents:
8932
diff
changeset
|
500 inputs. It can also be called recursively. |
| 8885 | 501 |
| 8737 | 502 ** Improvements to the norm function. |
| 503 | |
| 504 The norm function is now able to compute row or column norms of a | |
| 505 matrix in a single call, as well as general matrix p-norms. | |
| 506 | |
| 507 ** New functions for computing some eigenvalues or singular values. | |
| 508 | |
| 509 The eigs and svds functions have been included in Octave. These | |
| 510 functions require the ARPACK library (now distributed under a | |
| 511 GPL-compatible license). | |
| 512 | |
| 513 ** New QR and Cholesky factorization updating functions. | |
|
8370
34960ba08a81
document more new features in the NEWS file
Jaroslav Hajek <highegg@gmail.com>
parents:
8292
diff
changeset
|
514 |
| 8737 | 515 choldelete cholshift qrdelete qrshift |
| 516 cholinsert cholupdate qrinsert qrupdate | |
| 517 | |
| 518 ** New quadrature functions. | |
| 519 | |
| 520 dblquad quadgk quadv triplequad | |
| 521 | |
| 8885 | 522 ** New functions for reading and writing images. |
| 523 | |
| 524 The imwrite and imread functions have been included in Octave. | |
| 525 These functions require the GraphicsMagick library. The new | |
| 526 function imfinfo provides information about an image file (size, | |
| 527 type, colors, etc.) | |
| 528 | |
|
9215
1500d0197484
allow multiple input event hook functions to be installed simultaneously
John W. Eaton <jwe@octave.org>
parents:
9128
diff
changeset
|
529 ** The input_event_hook function has been replaced by the pair of |
|
1500d0197484
allow multiple input event hook functions to be installed simultaneously
John W. Eaton <jwe@octave.org>
parents:
9128
diff
changeset
|
530 functions add_input_event_hook and remove_input_event_hook so that |
|
1500d0197484
allow multiple input event hook functions to be installed simultaneously
John W. Eaton <jwe@octave.org>
parents:
9128
diff
changeset
|
531 more than one hook function may be installed at a time. |
|
1500d0197484
allow multiple input event hook functions to be installed simultaneously
John W. Eaton <jwe@octave.org>
parents:
9128
diff
changeset
|
532 |
| 8737 | 533 ** Other miscellaneous new functions. |
|
8370
34960ba08a81
document more new features in the NEWS file
Jaroslav Hajek <highegg@gmail.com>
parents:
8292
diff
changeset
|
534 |
|
8932
2d0f8692a82e
Add the 'histc' function
Soren Hauberg <hauberg@gmail.com>
parents:
8888
diff
changeset
|
535 addtodate hypot reallog |
|
2d0f8692a82e
Add the 'histc' function
Soren Hauberg <hauberg@gmail.com>
parents:
8888
diff
changeset
|
536 bicgstab idivide realpow |
| 9006 | 537 cellslices info realsqrt |
| 538 cgs interp1q rectint | |
| 539 command_line_path isdebugmode regexptranslate | |
| 540 contrast isfloat restoredefaultpath | |
| 541 convn isstrprop roundb | |
| 542 cummin log1p rundemos | |
| 543 cummax lsqnonneg runlength | |
| 544 datetick matlabroot saveobj | |
| 545 display namelengthmax spaugment | |
| 546 expm1 nargoutchk strchr | |
| 547 filemarker pathdef strvcat | |
| 548 fstat perl subspace | |
| 549 full prctile symvar | |
| 550 fzero quantile treelayout | |
| 551 genvarname re_read_readline_init_file validatestring | |
| 552 histc | |
|
8370
34960ba08a81
document more new features in the NEWS file
Jaroslav Hajek <highegg@gmail.com>
parents:
8292
diff
changeset
|
553 |
| 8885 | 554 ** Changes to strcat. |
| 555 | |
| 556 The strcat function is now compatible with Matlab's strcat | |
| 557 function, which removes trailing whitespace when concatenating | |
| 558 character strings. For example | |
| 559 | |
| 560 strcat ('foo ', 'bar') | |
| 561 ==> 'foobar' | |
| 562 | |
| 563 The new function cstrcat provides the previous behavior of | |
| 564 Octave's strcat. | |
| 565 | |
| 566 ** Improvements to the help functions. | |
| 567 | |
|
9034
52515efc50c0
Documentation cleanup on NEWS file
Rik <rdrider0-list@yahoo.com>
parents:
9031
diff
changeset
|
568 The help system has been mostly re-implemented in .m files to make |
| 8885 | 569 it easier to modify. Performance of the lookfor function has been |
| 570 greatly improved by caching the help text from all functions that | |
| 571 are distributed with Octave. The pkg function has been modified | |
| 572 to generate cache files for external packages when they are | |
| 573 installed. | |
| 574 | |
|
8888
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
575 ** Deprecated functions. |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
576 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
577 The following functions were deprecated in Octave 3.0 and will be |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
578 removed in Octave 3.4 (or whatever version is the second major |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
579 release after 3.0): |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
580 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
581 beta_cdf geometric_pdf pascal_pdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
582 beta_inv geometric_rnd pascal_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
583 beta_pdf hypergeometric_cdf poisson_cdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
584 beta_rnd hypergeometric_inv poisson_inv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
585 binomial_cdf hypergeometric_pdf poisson_pdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
586 binomial_inv hypergeometric_rnd poisson_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
587 binomial_pdf intersection polyinteg |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
588 binomial_rnd is_bool setstr |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
589 chisquare_cdf is_complex struct_contains |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
590 chisquare_inv is_list struct_elements |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
591 chisquare_pdf is_matrix t_cdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
592 chisquare_rnd is_scalar t_inv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
593 clearplot is_square t_pdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
594 clg is_stream t_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
595 com2str is_struct uniform_cdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
596 exponential_cdf is_symmetric uniform_inv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
597 exponential_inv is_vector uniform_pdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
598 exponential_pdf isstr uniform_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
599 exponential_rnd lognormal_cdf weibcdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
600 f_cdf lognormal_inv weibinv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
601 f_inv lognormal_pdf weibpdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
602 f_pdf lognormal_rnd weibrnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
603 f_rnd meshdom weibull_cdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
604 gamma_cdf normal_cdf weibull_inv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
605 gamma_inv normal_inv weibull_pdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
606 gamma_pdf normal_pdf weibull_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
607 gamma_rnd normal_rnd wiener_rnd |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
608 geometric_cdf pascal_cdf |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
609 geometric_inv pascal_inv |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
610 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
611 The following functions are now deprecated in Octave 3.2 and will |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
612 be removed in Octave 3.6 (or whatever version is the second major |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
613 release after 3.2): |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
614 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
615 create_set spcholinv spmax |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
616 dmult spcumprod spmin |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
617 iscommand spcumsum spprod |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
618 israwcommand spdet spqr |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
619 lchol spdiag spsum |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
620 loadimage spfind spsumsq |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
621 mark_as_command spinv str2mat |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
622 mark_as_rawcommand spkron unmark_command |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
623 spatan2 splchol unmark_rawcommand |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
624 spchol split |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
625 spchol2inv splu |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
626 |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
627 See NEWS.3 for old news. |