Documentation

operpoint

Create operating point for Simulink model

Syntax

op = operpoint('sys')

Alternatives

As an alternative to the operpoint function, create operating points in the Linear Analysis Tool. See Steady-State Operating Points (Trimming) from Specifications.

Description

op = operpoint('sys') returns an object, op, containing the operating point of a Simulink® model, sys. Use the object with the function linearize to create linearized models. The operating point object has the following properties:

  • Model — Simulink model name, specified as a string.

  • States — State operating point specification, specified as a structure array. Each structure in the array represents the supported states of one Simulink block. (For a list of supported states for operating point objects, see Simulink Model States Included in Operating Point Object.) Edit the properties of this object using dot notation or the set function.

    Each States structure has the following fields:

    Nx(read only)

    Number of states in the Simulink block.

    Block

    Simulink block name.

    StateName

    Name of state, specified as a string.

    x

    Simulink block state values, specified as a vector of states. This vector includes all supported states.

    When creating state value specifications for operating point searches using findop and you set the value of a state that you want fixed, also set the Known field of the States property for that state to 1.

    Ts

    (Only for discrete-time states) Sample time and offset of each Simulink block state, specified as a vector.

    SampleType

    State time rate, specified as one of the following values:

    • 'CSTATE' — Continuous-time state

    • 'DSTATE' — Discrete—time state.

    inReferencedModel

    Vector indicating whether each state is inside a reference model:

    • 1 — State is inside a reference model.

    • 0 — State is in the current model file.

    Description

    Block state description, specified as a string.

  • Inputs — Input level at the operating point, specified as a vector of input objects. Each input object represents the input levels of one root-level inport block in the Simulink block.

    Each entry in Inputs has the following fields:

    Block

    Inport block name.

    PortWidth

    Number of inport block signals.

    PortDimensions

    Dimension of signals accepted by the inport.

    u

    Inport block input levels at the operating point, specified as a vector of input levels.

    When creating input specifications for operating-point searches using findop, also set the Known field of the Inputs property for known input levels that remain fixed during operating point search.

    Description

    Inport block input description, specified as a string.

  • Time — Times at which any time-varying functions in the model are evaluated, specified as a vector.

  • Version — Object version number.

Examples

To create an operating point object for the Simulink model magball, type:

op = operpoint('magball')

which returns the following:

 Operating Point for the Model magball.
 (Time-Varying Components Evaluated at time t=0)

States: 
----------
(1.) magball/Controller/PID Controller/Filter
      x: 0            
(2.) magball/Controller/PID Controller/Integrator
      x: 14           
(3.) magball/Magnetic Ball Plant/Current
      x: 7            
(4.) magball/Magnetic Ball Plant/dhdt
      x: 0            
(5.) magball/Magnetic Ball Plant/height
      x: 0.05         
 
Inputs: None 
----------

MATLAB® software displays the name of the model, the time at which any time-varying functions in the model are evaluated, the names of blocks containing states, and the values of the states at the operating point. In this example there are four blocks that contain states in the model and four entries in the States object. The first entry contains two states. MATLAB also displays the Inputs although there are not any in this model. To view the properties of op in more detail, use the get function.

See Also

| | | |

Introduced before R2006a

Was this topic helpful?