| Simulink® Control Design™ | |
io = getlinio('sys')
As an alternative to the getlinio function, view linearization I/Os in the Analysis I/Os pane of the Linearization Task node within the Simulink® Control Design™ GUI. See Inspecting Analysis I/Os.
io = getlinio('sys') finds all linearization annotations in the Simulink model, sys, and returns a vector of objects, io. Each object represents a linearization annotation in the model and is associated with an output port of a Simulink block. Before running getlinio, use the right-click menu to insert the linearization annotations, or I/Os, on the signal lines of the model diagram.
Each object within the vector, io, has the following properties:
Active | Set this value to 'on', when the I/O is used for linearization, and 'off' otherwise |
Block | Name of the block the with which I/O is associated |
OpenLoop | Set this value to 'on', when the feedback loop at the I/O is open, and 'off', when it is closed |
PortNumber | Integer referring to the output port with which the I/O is associated |
Type | Choose one of the following linearization I/O types:
|
Description | String description of the I/O object |
You can edit this I/O object to change its properties. Alternatively, you can change the properties of io using the set function. To upload an edited I/O object to the Simulink model diagram, use the setlinio function. Use I/O objects with the function linearize to create linear models.
Before creating a vector of I/O objects using getlinio, you must add linearization annotations representing the I/Os, such as input points or output points, to a Simulink model.
Open the Simulink model magball by typing
magball
at the MATLAB® prompt. Right-click the signal line between the Magnetic Ball Plant and the Controller. Select Linearization Points > Input Point from the menu to place an input point on this signal line. A small arrow pointing toward a small circle just above the signal line represents the input point. Right-click the signal line after the Magnetic Ball Plant. Select Linearization Points > Output Point from the menu to place an output point on this signal line. A small arrow pointing away from a small circle just above the signal line represents the output point.
To create a vector of I/O objects for this model, type:
io=getlinio('magball')
This syntax returns a formatted display of the linearization I/Os.
Linearization IOs: -------------------------- Block magball/Controller, Port 1 is marked with the following properties: - No Loop Opening - An Input Perturbation Block magball/Magnetic Ball Plant, Port 1 is marked with the following properties: - An Output Measurement - No Loop Opening
There are two entries in the vector, io, representing the two linearization annotations previously set in the model diagram. MATLAB displays:
the name of the block associated with the I/O
the port number associated with the I/O
the type of IO (input perturbation or output measurement referring to an input point or output point respectively)
whether the IO is also a loop opening
By default, the I/Os have no loop openings. Display the properties of each I/O object in more detail using the get function.
get, linearize, linio, set, setlinio
| getinputstruct | getlinplant | |
| © 1984-2008- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |