Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

odeget

Extract ODE option values

Syntax

  • v = odeget(options,'Name')
    example
  • v = odeget(options,'Name',default)
    example

Description

example

v = odeget(options,'Name') extracts the value of the named option from options, which is a structure containing option values. Use odeset to create or update the options structure.

example

v = odeget(options,'Name',default) returns the value v = default if the named option does not have a value specified in options.

Examples

collapse all

Create an options structure using odeset that contains several values for different options.

M = @(t) [t 0; 0 -t];
options = odeset('RelTol',1e-4,'AbsTol',1e-5,'OutputFcn',@odephas2,...
    'Mass',M,'MassSingular','no','MStateDependence','none')
options = 

  struct with fields:

              AbsTol: 1.0000e-05
                 BDF: []
              Events: []
         InitialStep: []
            Jacobian: []
           JConstant: []
            JPattern: []
                Mass: @(t)[t,0;0,-t]
        MassSingular: 'no'
            MaxOrder: []
             MaxStep: []
         NonNegative: []
         NormControl: []
           OutputFcn: @odephas2
           OutputSel: []
              Refine: []
              RelTol: 1.0000e-04
               Stats: []
          Vectorized: []
    MStateDependence: 'none'
           MvPattern: []
        InitialSlope: []

Use odeget to extract the value of the OutputFcn field from the options structure.

v = odeget(options,'OutputFcn')
v =

  function_handle with value:

    @odephas2

Now extract the value of the Refine field. Since this field is not set, odeget returns an empty matrix [].

v = odeget(options,'Refine')
v =

     []

You can specify a third input to odeget to change the default return value. This ensures that v is never empty.

v = odeget(options,'Refine',1)
v =

     1

Input Arguments

collapse all

Options structure. Use odeset to create or modify the options structure.

Example: options = odeset('RelTol',1e-4,'AbsTol',1e-5) returns an options structure with values specified for the relative and absolute error tolerances.

Data Types: struct

Option name, specified as any valid option accepted by odeset:

  • Error control — 'AbsTol', 'RelTol', 'NormControl'

  • Output control — 'NonNegative', 'OutputFcn', 'OutputSel', 'Refine', 'Stats'

  • Solver steps — 'InitialStep', 'MaxStep'

  • Event functions — 'Events'

  • Jacobian matrix — 'Jacobian', 'JPattern', 'Vectorized'

  • Mass matrix — 'Mass', 'MStateDependence', 'MvPattern', 'MassSingular', 'InitialSlope'

  • Algorithm options for ode15s and ode15i'MaxOrder', 'BDF'

Example: v = odeget(options,'AbsTol')

Default return value, specified as any valid MATLAB object.

Example: v = odeget(options,'AbsTol',1e-6) returns 1e-6 if options does not have a value set for AbsTol.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | struct | table | cell | function_handle | categorical

See Also

| |

Introduced before R2006a

Was this topic helpful?