addPoint

Syntax

Description

addPoint(s,pt) adds
the specified point to the list of analysis points for the slLinearizer or slTuner interface, s.

Analysis points are model signals that can be used as input,
output, or loop-opening locations for analysis and tuning purposes.
You use analysis points as inputs to the linearization commands of s: getIOTransfer, getLoopTransfer, getSensitivity,
and getCompSensitivity. As inputs to the linearization
commands, analysis points can specify any open- or closed-loop transfer
function in a model. You can also use analysis points to specify tuning
goals for systune.

Add Analysis Points Using Block Path and Port Number

Suppose you want to linearize the magball model and obtain a transfer function from the reference input to the plant output. Add the signals originating at the Desired Height and Magnetic Ball Plant blocks as analysis points to an slLinearizer interface.

Open the magball model.

mdl = 'magball';
open_system(mdl);

Create an slLinearizer interface for the model.

sllin = slLinearizer(mdl);

Add the signals originating at the Design Height and Magnetic Ball Plant blocks as analysis points of sllin. Both signals originate at the first (and only) port of the respective blocks.

Add Bus Elements as Analysis Points

The COUNTERBUS signal of scdbusselection contains multiple bus elements. Add the upper_saturation_limit and data bus elements as analysis points to sllin. When adding elements within a nested bus structure, use dot notation to access the elements of the nested bus, for example limits.upper_saturation_limit.

Here, pt(1) specifies an input, and pt(2) specifies
an output. The interface adds all the signals specified by pt and
ignores the I/O types. The interface also adds all 'loopbreak' type
signals as permanent openings.

More About

Analysis Points

Analysis points, used
by the slLinearizer and slTuner interfaces,
identify locations within a model that are relevant for linear analysis
and control system tuning. You use analysis points as inputs to the
linearization commands, such as getIOTransfer, getLoopTransfer, getSensitivity, and getCompSensitivity. As inputs to the
linearization commands, analysis points can specify any open-loop
or closed-loop transfer function in a model. You can also use analysis
points to specify design requirements when tuning control systems
using commands such as systune.

Location refers to a specific block output
port within a model or to a bus element in such an output port. For
convenience, you can use the name of the signal that originates from
this port to refer to an analysis point.

You can add analysis points to an slLinearizer or slTuner interface, s,
when you create the interface. For example:

To view all the analysis points of s, type s at
the command prompt to display the interface contents. For each analysis
point of s, the display includes the block name
and port number and the name of the signal that originates at this
point. You can also programmatically obtain a list of all the analysis
points using getPoints.

Permanent Openings

Permanent openings,
used by the slLinearizer and slTuner interfaces,
identify locations within a model where the software breaks the signal
flow. The software enforces these openings for linearization and tuning.
Use permanent openings to isolate a specific model component. Suppose
that you have a large-scale model capturing aircraft dynamics and
you want to perform linear analysis on the airframe only. You can
use permanent openings to exclude all other components of the model.
Another example is when you have cascaded loops within your model
and you want to analyze a specific loop.

Location refers to a specific block output
port within a model. For convenience, you can use the name of the
signal that originates from this port to refer to an opening.

You can add permanent openings to an slLinearizer or slTuner interface, s,
when you create the interface or by using the addOpening command. To remove a location
from the list of permanent openings, use the removeOpening command.

To view all the openings of s, type s at
the command prompt to display the interface contents. For each permanent
opening of s, the display includes the block name
and port number and the name of the signal that originates at this
location. You can also programmatically obtain a list of all the permanent
loop openings using getOpenings.

This website uses cookies to improve your user experience, personalize content and ads, and analyze website traffic. By continuing to use this website, you consent to our use of cookies. Please see our Privacy Policy to learn more about cookies and how to change your settings.