Mercurial > hg > octave-lyh
annotate NEWS @ 10453:7d23c19249d6
NEWS: style fixes
| author | John W. Eaton <jwe@octave.org> |
|---|---|
| date | Wed, 24 Mar 2010 16:26:33 -0400 |
| parents | 0a210203481b |
| children | 6538ff562949 |
| 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 |
| 10453 | 152 ** More efficient matrix division handling. Octave is now able to |
| 10118 | 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 | |
| 10453 | 162 flags. Previously, all three expressions required a physical |
| 10118 | 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 | |
| 10453 | 179 depending on the dimensions. The first form requires more |
| 180 temporaries and copying, but halves the FLOP count, which normally | |
| 181 brings better performance if RM has enough rows. Previously, the | |
| 182 second form was 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 |
| 10453 | 217 ** Matlab-style ignoring input and output function arguments using |
| 218 tilde (~) is now supported. For more details, consult the manual. | |
| 10233 | 219 |
| 10453 | 220 ** The list datatype, deprecated since the introduction of cells, has |
| 221 been removed. | |
| 10276 | 222 |
| 10453 | 223 ** The accumarray function has been optimized and is now significantly |
| 224 faster in certain important cases. | |
| 10054 | 225 |
| 10292 | 226 ** The behavior of isreal and isnumeric functions was changed to be more |
| 227 Matlab-compatible. | |
| 228 | |
| 10406 | 229 ** The integer math & conversion warnings (Octave:int-convert-nan, |
| 230 Octave:int-convert-non-int-val, Octave:int-convert-overflow, | |
| 231 Octave:int-math-overflow) have been removed. | |
| 232 | |
| 10453 | 233 ** rem and mod are now built-in functions. They also handle integer |
| 234 types efficiently using integer arithmetic. | |
| 10437 | 235 |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
236 Summary of important user-visible changes for version 3.2: |
| 5913 | 237 --------------------------------------------------------- |
| 2452 | 238 |
| 8737 | 239 ** Compatibility with Matlab graphics has been improved. |
| 6329 | 240 |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
241 The hggroup object and associated listener callback functions have |
| 8737 | 242 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
|
243 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
|
244 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
245 x = 0:0.1:10; |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
246 y = sin (x); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
247 plot (x, y, "ydatasource", "y"); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
248 for i = 1 : 100 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
249 pause(0.1) |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
250 y = sin (x + 0.1 * i); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
251 refreshdata(); |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
252 endfor |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
253 |
| 8737 | 254 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
|
255 stem-series, bar-series, etc., objects for better Matlab |
| 8737 | 256 compatibility. |
| 257 | |
| 258 ** New graphics functions: | |
| 259 | |
|
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
|
260 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
|
261 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
|
262 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
|
263 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
|
264 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
|
265 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
|
266 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
|
267 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
|
268 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
|
269 diffuse gcbf plotmatrix |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
270 |
| 8737 | 271 ** New experimental OpenGL/FLTK based plotting system. |
| 272 | |
| 273 An experimental plotting system based on OpenGL and the FLTK | |
| 274 toolkit is now part of Octave. This backend is disabled by | |
| 275 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
|
276 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
277 backend ("fltk") |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
278 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
279 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
|
280 |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
281 backend (h, "fltk") |
|
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
282 |
| 8737 | 283 where "h" is a valid figure handle. Please note that this backend |
| 284 does not yet support text objects. Obviously, this is a necessary | |
| 285 feature before it can be considered usable. We are looking for | |
| 286 volunteers to help implement this missing feature. | |
|
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8014
diff
changeset
|
287 |
| 8737 | 288 ** Functions providing direct access to gnuplot have been removed. |
| 289 | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
290 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
|
291 __gnuplot_show__, __gnuplot_replot__, __gnuplot_splot__, |
| 8737 | 292 __gnuplot_save_data__ and __gnuplot_send_inline_data__ have been |
| 293 removed from Octave. These function were incompatible with the | |
| 294 high level graphics handle code. | |
| 6329 | 295 |
| 8885 | 296 ** The Control, Finance and Quaternion functions have been removed. |
| 297 | |
| 298 These functions are now available as separate packages from | |
| 299 | |
| 300 http://octave.sourceforge.net/packages.html | |
| 301 | |
| 302 and can be reinstalled using the Octave package manager (see | |
| 303 the pkg function). | |
| 304 | |
| 305 ** Specific sparse matrix functions removed. | |
| 306 | |
| 307 The following functions, which handled only sparse matrices have | |
| 308 been removed. Instead of calling these functions directly, you | |
| 309 should use the corresponding function without the "sp" prefix. | |
| 8737 | 310 |
| 8885 | 311 spatan2 spcumsum spkron spprod |
| 312 spchol spdet splchol spqr | |
| 313 spchol2inv spdiag splu spsum | |
| 314 spcholinv spfind spmax spsumsqk | |
| 315 spcumprod spinv spmin | |
| 316 | |
| 317 ** Improvements to the debugger. | |
| 318 | |
| 319 The interactive debugging features have been improved. Stopping | |
| 320 on statements with dbstop should work correctly now. Stepping | |
| 321 into and over functions, and stepping one statement at a time | |
| 322 (with dbstep) now works. Moving up and down the call stack with | |
| 323 dbup and dbdown now works. The dbstack function is now available | |
| 324 to print the current function call stack. The new dbquit function | |
| 325 is available to exit the debugging mode. | |
| 326 | |
| 327 ** Improved traceback error messages. | |
| 328 | |
| 329 Traceback error messages are much more concise and easier to | |
| 330 understand. They now display information about the function call | |
| 331 stack instead of the stack of all statements that were active at | |
| 332 the point of the error. | |
|
8014
44d206ae68c9
improve fsolve compatibility
John W. Eaton <jwe@octave.org>
parents:
7990
diff
changeset
|
333 |
| 8737 | 334 ** Object Oriented Programming. |
|
8405
d79dfbff2f9d
document new norm features in NEWS
Jaroslav Hajek <highegg@gmail.com>
parents:
8396
diff
changeset
|
335 |
| 8737 | 336 Octave now includes OOP features and the user can create their own |
| 337 class objects and overloaded functions and operators. For | |
| 338 example, all methods of a class called "myclass" will be found in | |
| 339 a directory "@myclass" on the users path. The class specific | |
| 340 versions of functions and operators take precedence over the | |
| 341 generic versions of these functions. | |
| 342 | |
| 343 New functions related to OOP include | |
| 7189 | 344 |
| 8737 | 345 class inferiorto isobject loadobj methods superiorto |
| 346 | |
| 347 See the Octave manual for more details. | |
| 7038 | 348 |
| 8747 | 349 ** Parsing of Command-style Functions. |
| 350 | |
| 351 Octave now parses command-style functions without needing to first | |
| 352 declare them with "mark_as_command". The rules for recognizing a | |
| 353 command-style function calls are | |
| 354 | |
| 355 * A command must appear as the first word in a statement, | |
| 356 followed by a space. | |
| 357 | |
| 358 * The first character after the space must not be '=' or '(' | |
| 359 | |
| 360 * The next token after the space must not look like a binary | |
| 361 operator. | |
| 362 | |
| 363 These rules should be mostly compatible with the way Matlab parses | |
| 364 command-style function calls and allow users to define commands in | |
| 365 .m files without having to mark them as commands. | |
| 366 | |
| 367 Note that previous versions of Octave allowed expressions like | |
| 368 | |
| 369 x = load -text foo.dat | |
| 370 | |
| 371 but an expression like this will now generate a parse error. In | |
| 372 order to assign the value returned by a function to a variable, | |
| 373 you must use the normal function call syntax: | |
| 374 | |
| 375 x = load ("-text", "foo.dat"); | |
| 376 | |
| 8737 | 377 ** Block comments. |
| 378 | |
| 8747 | 379 Commented code can be between matching "#{" and "#}" or "%{" and |
| 380 "%}" markers, even if the commented code spans several line. This | |
| 381 allows blocks code to be commented, without needing to comment | |
| 382 each line. For example, | |
| 5814 | 383 |
| 8747 | 384 function [s, t] = func (x, y) |
| 385 s = 2 * x; | |
| 386 #{ | |
| 387 s *= y; | |
| 388 t = y + x; | |
| 389 #} | |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
390 endfunction |
| 5814 | 391 |
| 8747 | 392 the lines "s *= y;" and "t = y + x" will not be executed. |
| 8737 | 393 |
| 394 ** Special treatment in the parser of expressions like "a' * b". | |
| 2452 | 395 |
| 8737 | 396 In these cases the transpose is no longer explicitly formed and |
| 397 BLAS libraries are called with the transpose flagged, | |
| 398 significantly improving performance for these kinds of | |
| 399 operations. | |
|
8417
654bcfb937bf
Add the eigs and svds functions
David Bateman <dbateman@free.fr>
parents:
8405
diff
changeset
|
400 |
| 8737 | 401 ** Single Precision data type. |
| 2452 | 402 |
| 8737 | 403 Octave now includes a single precision data type. Single |
| 404 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
|
405 from functions like ones, eye, etc. For example, |
| 5995 | 406 |
| 8737 | 407 single (1) |
| 408 ones (2, 2, "single") | |
| 409 zeros (2, 2, "single") | |
| 410 eye (2, 2, "single") | |
| 411 Inf (2, 2, "single") | |
| 412 NaN (2, 2, "single") | |
| 413 NA (2, 2, "single") | |
| 7279 | 414 |
| 8737 | 415 all create single precision variables. For compatibility with |
| 416 Matlab, mixed double/single precision operators and functions | |
| 417 return single precision types. | |
| 418 | |
| 419 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
|
420 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
|
421 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
|
422 visa-versa are warned that compatibility might not be assured. |
| 7279 | 423 |
| 8737 | 424 ** Improved array indexing. |
| 425 | |
| 426 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
|
427 completely rewritten and indexing is now significantly faster. |
| 8737 | 428 |
| 8755 | 429 ** Improved memory management. |
| 430 | |
| 431 Octave will now attempt to share data in some cases where previously | |
| 432 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
|
433 conversions between cells, structs and cs-lists. This usually reduces |
| 8755 | 434 both time and memory consumption. |
| 9128 | 435 Also, Octave will now attempt to detect and optimize usage of a vector |
| 436 as a stack, when elements are being repeatedly inserted at/removed from | |
| 437 the end of the vector. | |
| 8755 | 438 |
| 8738 | 439 ** Improved performance for reduction operations. |
| 440 | |
| 8755 | 441 The performance of the sum, prod, sumsq, cumsum, cumprod, any, all, |
| 442 max and min functions has been significantly improved. | |
| 8738 | 443 |
| 9006 | 444 ** Sorting and searching. |
| 445 | |
| 446 The performance of sort has been improved, especially when sorting | |
| 10453 | 447 indices are requested. An efficient built-in issorted |
| 448 implementation was added. The sortrows function now uses a more | |
| 449 efficient algorithm, especially in the homegeneous case. The lookup | |
| 450 function is now a built-in function performing a binary search, | |
| 451 optimized for long runs of close elements. Lookup also works with | |
| 452 cell arrays of strings. | |
| 9006 | 453 |
| 454 ** Range arithmetics | |
| 455 | |
| 10453 | 456 For some operations on ranges, Octave will attempt to keep the |
| 457 result as a range. These include negation, adding a scalar, | |
| 458 subtracting a scalar, and multiplying by a scalar. Ranges with zero | |
| 459 increment are allowed and can be constructed using the built-in | |
| 460 function `ones'. | |
| 9006 | 461 |
| 462 ** Various performance improvements. | |
| 463 | |
| 10453 | 464 Performance of a number of other built-in operations and functions |
| 465 was improved, including: | |
| 9006 | 466 |
| 467 * logical operations | |
| 468 * comparison operators | |
| 469 * element-wise power | |
| 470 * accumarray | |
| 471 * cellfun | |
| 472 * isnan | |
| 473 * isinf | |
| 474 * isfinite | |
| 475 * nchoosek | |
| 476 * repmat | |
| 477 * strcmp | |
| 478 | |
| 8737 | 479 ** 64-bit integer arithmetic. |
| 480 | |
| 481 Arithmetic with 64-bit integers (int64 and uint64 types) is fully | |
| 482 supported, with saturation semantics like the other integer types. | |
| 483 Performance of most integer arithmetic operations has been | |
| 484 improved by using integer arithmetic directly. Previously, Octave | |
| 485 performed integer math with saturation semantics by converting the | |
| 486 operands to double precision, performing the operation, and then | |
| 487 converting the result back to an integer value, truncating if | |
| 488 necessary. | |
| 489 | |
| 8885 | 490 ** Diagonal and permutation matrices. |
| 491 | |
| 492 The interpreter can now treat diagonal and permutation matrices as | |
| 493 special objects that store only the non-zero elements, rather than | |
| 494 general full matrices. Therefore, it is now possible to construct | |
| 495 and use these matrices in linear algebra without suffering a | |
| 496 performance penalty due to storing large numbers of zero elements. | |
| 497 | |
| 498 ** Improvements to fsolve. | |
| 499 | |
| 500 The fsolve function now accepts an option structure argument (see | |
| 501 also the optimset function). The INFO values returned from fsolve | |
| 502 have changed to be compatible with Matlab's fsolve function. | |
| 503 Additionally, fsolve is now able to solve overdetermined systems, | |
| 504 complex-differentiable complex systems, systems with a sparse | |
| 505 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
|
506 inputs. It can also be called recursively. |
| 8885 | 507 |
| 8737 | 508 ** Improvements to the norm function. |
| 509 | |
| 510 The norm function is now able to compute row or column norms of a | |
| 511 matrix in a single call, as well as general matrix p-norms. | |
| 512 | |
| 513 ** New functions for computing some eigenvalues or singular values. | |
| 514 | |
| 515 The eigs and svds functions have been included in Octave. These | |
| 516 functions require the ARPACK library (now distributed under a | |
| 517 GPL-compatible license). | |
| 518 | |
| 519 ** 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
|
520 |
| 8737 | 521 choldelete cholshift qrdelete qrshift |
| 522 cholinsert cholupdate qrinsert qrupdate | |
| 523 | |
| 524 ** New quadrature functions. | |
| 525 | |
| 526 dblquad quadgk quadv triplequad | |
| 527 | |
| 8885 | 528 ** New functions for reading and writing images. |
| 529 | |
| 530 The imwrite and imread functions have been included in Octave. | |
| 531 These functions require the GraphicsMagick library. The new | |
| 532 function imfinfo provides information about an image file (size, | |
| 533 type, colors, etc.) | |
| 534 | |
|
9215
1500d0197484
allow multiple input event hook functions to be installed simultaneously
John W. Eaton <jwe@octave.org>
parents:
9128
diff
changeset
|
535 ** 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
|
536 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
|
537 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
|
538 |
| 8737 | 539 ** Other miscellaneous new functions. |
|
8370
34960ba08a81
document more new features in the NEWS file
Jaroslav Hajek <highegg@gmail.com>
parents:
8292
diff
changeset
|
540 |
|
8932
2d0f8692a82e
Add the 'histc' function
Soren Hauberg <hauberg@gmail.com>
parents:
8888
diff
changeset
|
541 addtodate hypot reallog |
|
2d0f8692a82e
Add the 'histc' function
Soren Hauberg <hauberg@gmail.com>
parents:
8888
diff
changeset
|
542 bicgstab idivide realpow |
| 9006 | 543 cellslices info realsqrt |
| 544 cgs interp1q rectint | |
| 545 command_line_path isdebugmode regexptranslate | |
| 546 contrast isfloat restoredefaultpath | |
| 547 convn isstrprop roundb | |
| 548 cummin log1p rundemos | |
| 549 cummax lsqnonneg runlength | |
| 550 datetick matlabroot saveobj | |
| 551 display namelengthmax spaugment | |
| 552 expm1 nargoutchk strchr | |
| 553 filemarker pathdef strvcat | |
| 554 fstat perl subspace | |
| 555 full prctile symvar | |
| 556 fzero quantile treelayout | |
| 557 genvarname re_read_readline_init_file validatestring | |
| 558 histc | |
|
8370
34960ba08a81
document more new features in the NEWS file
Jaroslav Hajek <highegg@gmail.com>
parents:
8292
diff
changeset
|
559 |
| 8885 | 560 ** Changes to strcat. |
| 561 | |
| 562 The strcat function is now compatible with Matlab's strcat | |
| 563 function, which removes trailing whitespace when concatenating | |
| 564 character strings. For example | |
| 565 | |
| 566 strcat ('foo ', 'bar') | |
| 567 ==> 'foobar' | |
| 568 | |
| 569 The new function cstrcat provides the previous behavior of | |
| 570 Octave's strcat. | |
| 571 | |
| 572 ** Improvements to the help functions. | |
| 573 | |
|
9034
52515efc50c0
Documentation cleanup on NEWS file
Rik <rdrider0-list@yahoo.com>
parents:
9031
diff
changeset
|
574 The help system has been mostly re-implemented in .m files to make |
| 8885 | 575 it easier to modify. Performance of the lookfor function has been |
| 576 greatly improved by caching the help text from all functions that | |
| 577 are distributed with Octave. The pkg function has been modified | |
| 578 to generate cache files for external packages when they are | |
| 579 installed. | |
| 580 | |
|
8888
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
581 ** Deprecated functions. |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
582 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
583 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
|
584 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
|
585 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
|
586 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
587 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
|
588 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
|
589 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
|
590 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
|
591 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
|
592 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
|
593 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
|
594 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
|
595 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
|
596 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
|
597 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
|
598 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
|
599 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
|
600 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
|
601 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
|
602 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
|
603 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
|
604 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
|
605 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
|
606 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
|
607 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
|
608 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
|
609 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
|
610 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
|
611 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
|
612 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
|
613 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
|
614 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
|
615 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
|
616 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
617 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
|
618 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
|
619 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
|
620 |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
621 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
|
622 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
|
623 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
|
624 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
|
625 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
|
626 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
|
627 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
|
628 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
|
629 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
|
630 spchol split |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
631 spchol2inv splu |
|
0c7b0049c023
mark create_set as deprecated in 3.2, not 3.0
John W. Eaton <jwe@octave.org>
parents:
8885
diff
changeset
|
632 |
|
7990
86dae6e5b83c
Initial update of NEWS for 3.2 release
David Bateman <dbateman@free.fr>
parents:
7279
diff
changeset
|
633 See NEWS.3 for old news. |