Mercurial > octave
view etc/NEWS.8.md @ 31263:449ed6f427cb
ode45/23/23s: Implement Events, OutputFcn, & Refine options (bug #49408 and #63063)
* scripts/ode/ode23.m: Remove disabling of Refine option with struct output.
Modify solution struct to output two sets of solution variables: output_t,
output_x and ode_t and ode_x, and transpose struct output variables for
improved Matlab compatibility. Update BISTs and perform minor code formatting.
* scripts/ode/ode23s.m: Make same changes as ode23.m.
* scripts/ode/ode45.m: Make same changes as ode23.m. Remove comment indicating
that Refine is not implemented.
* scripts/ode/private/integrate_adaptive.m: Update internal handling of
variables t and x, separating them into ode_t & ode_x for internal integration
and output_t & output_x for function output or calls to OutputFcn. Replace
prior attempt at Refine option with new implementation. Specify time output or
Refine != 0 are both interpolated from internal variables (ode_t, ode_x) for
output of non-struct variables and/or for use with OutputFcn. Improve event
handling when multiple Events (including at least one terminal Event) are
detected in a single simulation step so that all Events up to and including the
first terminal one are reported, and final data point is set to that of
terminal Event. Send multiple data points in a single call to OutputFcn if they
are all interpolated from a single integration step. Remove warning for
termination when term signal is received from Events or OutputFcn. Return both
internal variables (ode_t, ode_x) and interpolated variables (output_t,
output_x) to allow calling function to correctly return either struct or
separate variables.
* scripts/ode/private/ode_event_handler.m: Sort multiple Events in ascending
time order when they are encountered in one integration step. Remove any events
after the time of a terminal Event.
* scripts/ode/odeset.m: Update docstring to remove indication that Refine is
not implemented
* scripts/ode/odeplot.m: Update docstring to indicate that input t can be a
scalar or vector. Add file test.
* etc/NEWS.8.md: Add descriptions of changes under General improvements and
Matlab compatibility.
author | Ken Marek <marek_ka@mercer.edu> |
---|---|
date | Wed, 05 Oct 2022 16:53:01 -0400 |
parents | a40c0b7aa376 |
children | ecfb41743fd2 |
line wrap: on
line source
Summary of important user-visible changes for version 8 (yyyy-mm-dd): --------------------------------------------------------------------- ### General improvements - Octave's libraries are now built using symbol visibility by default. That means that less symbols are exported from these libraries. Configure with `--disable-lib-visibility-flags` to export all symbols (as in previous versions). - `filter` is now 5X faster, which also speeds up `deconv`, `fftfilt` and `arma_rnd` by the same amount. - `integral` can now output a second argument passing the error measurement used by the underlying integrator. - `perms` now accepts a second argument "unique" to return only unique permutations for inputs with repeated elements. It is faster and takes less memory to call `perms ('aaaabbbbcccc', "unique")` than to call `unique (perms ('aaaabbbbcccc'), "rows")`. - `quadgk` can now accept the `ArrayValued` input parameter to handle array-valued input functions. - `delaunayn` now has consistent trivial simplex checking and removal for all input dimensions, simplex checking 3D inputs is now vectorized, and >3D simplex checking performance has been improved. Simplexes points are now ordered so they will all have positive outward normal vectors. Input type checking has also been added for improved error handling. - `Refine` option is now implemented in functions `ode45`, `ode23`, and `ode23s`. ### Graphical User Interface ### Graphics backend - Additional properties have been added to the `figure` graphics object: * `"innerposition"` (equivalent to `"position"`) * `"windowstate"` (not yet implemented) - Legend now features a new property `"itemhitfcn"`, allowing the execution of a callback function when a legend item is clicked. ### Matlab compatibility - `inline` functions now support all Matlab methods. The performance of `inline` functions has also been improved. - `sub2ind` now supports index values outside of the size specified by the subscripts. - `cylinder` now accepts a scalar for the radius argument. - `clock` now has an optional second output `ISDST` which indicates if Daylight Savings Time is in effect for the system's time zone. - `print` now accepts option `-image` to specify the "opengl" renderer and `-vector` to specify the "painters" renderer. - `format` now accepts the option "default", which is equivalent to calling `format` without any options to reset the default state. - `quadgk` now stops iterating when `error <= tolerance` while the previous condition was `error < tolerance`. - `var` and `std` now optionally output a second argument containing the mean or weighted mean. - `integral` can now accept the 'ArrayValued' option in combination with 'RelTol' and 'WayPoints'. - The default state for certain graphics properties has been made consistent with Matlab. Object | Property | Default State ------------|------------------|------------ `figure` | `"dockcontrols"` | `"on"` - `ode45`, `ode23`, and `ode23s` have improved results for options `Events`, `OutputFcn`, and `Refine`, along with corrected orientation of struct outputs. ### Alphabetical list of new functions added in Octave 8 * `clearAllMemoizedCaches` * `matlab.lang.MemoizedFunction` * `memoize` * `pagectranspose` * `pagetranspose` * `uifigure` ### Deprecated functions, properties, and operators The following functions and properties have been deprecated in Octave 8 and will be removed from Octave 10 (or whatever version is the second major release after 8): - Functions Function | Replacement -----------------------|------------------ `shift` | `circshift` `sparse_auto_mutate` | none (see below) - The `sparse_auto_mutate` function no longer has any effect on Octave's behavior. Previously, after calling `sparse_auto_mutate (true)`, Octave would automatically convert sparse matrices to full when a sparse matrix required more memory than simply using full matrix storage. This setting was `false` by default for compatibility with Matlab. Now you must manually convert to full storage when desired. - Properties The following property names are discouraged, but there is no fixed date for their removal. Object | Property | Replacement -----------------|-------------|------------ `uimenu` | `label` | `text` `uimenu` | `callback` | `menuselectedfcn` The following functions were deprecated in Octave 6 and have been removed from Octave 8. - Functions Function | Replacement -----------------------|------------------ `runtests` | `oruntests` - The environment variable used by `mkoctfile` for linker flags is now `LDFLAGS` rather than `LFLAGS`. `LFLAGS` was deprecated in Octave 6, and will be removed in a future version of Octave. ### Old release news - [Octave 7.x](etc/NEWS.7) - [Octave 6.x](etc/NEWS.6) - [Octave 5.x](etc/NEWS.5) - [Octave 4.x](etc/NEWS.4) - [Octave 3.x](etc/NEWS.3) - [Octave 2.x](etc/NEWS.2) - [Octave 1.x](etc/NEWS.1)