removePoint
Remove point from list of analysis points in slLinearizer
or slTuner
interface
Syntax
Description
removePoint(
removes
the specified point, s
,pt
)pt
, from the list of analysis points for
the slLinearizer
or slTuner
interface, s
.
You can specify pt
to remove either a single
or multiple points.
removePoint
does not modify the model associated
with s
.
Examples
Remove Analysis Point Using Signal Name
Create an slLinearizer
interface for the scdcascade
model. Add analysis points for the r
, e1
, and y1m
signals.
sllin = slLinearizer('scdcascade',{'r','e1','y1m'});
Remove the y1m
point from the interface.
removePoint(sllin,'y1m');
Remove Multiple Analysis Points Using Signal Name
Create an slLinearizer
interface for the scdcascade
model. Add analysis points for the r
, e1
, and y1m
signals.
sllin = slLinearizer('scdcascade',{'r','e1','y1m'});
Remove the y1m
and e1
points from the interface.
removePoint(sllin,{'y1m','e1'});
Remove Analysis Point Using Index
Create an slLinearizer
interface for the scdcascade
model. Add analysis points for the r
, e1
, and y1m
signals.
sllin = slLinearizer('scdcascade',{'r','e1','y1m'});
Determine the index number of the point you want to remove. To do this, display the contents of the interface, which includes analysis point index numbers, in the Command Window.
For this example, remove the y1m
point from sllin
.
sllin
slLinearizer linearization interface for "scdcascade": 3 Analysis points: -------------------------- Point 1: - Block: scdcascade/setpoint - Port: 1 - Signal Name: r Point 2: - Block: scdcascade/Sum1 - Port: 1 - Signal Name: e1 Point 3: - Block: scdcascade/Sum - Port: 1 - Signal Name: y1m No permanent openings. Use the addOpening command to add new permanent openings. Properties with dot notation get/set access: Parameters : [] OperatingPoints : [] (model initial condition will be used.) BlockSubstitutions : [] Options : [1x1 linearize.LinearizeOptions]
The displays shows that y1m
is the third analysis point of sllin
.
Remove the point from the interface.
removePoint(sllin,3);
Remove Multiple Analysis Points Using Index
Create an slLinearizer
interface for the scdcascade
model. Add analysis points for the r
, e1
, and y1m
signals.
sllin = slLinearizer('scdcascade',{'r','e1','y1m'});
Determine the index numbers of the points you want to remove. To do this, display the contents of the interface, which includes analysis point index numbers, in the Command Window.
For this example, remove the e1
and y1m
points from sllin
.
sllin
slLinearizer linearization interface for "scdcascade": 3 Analysis points: -------------------------- Point 1: - Block: scdcascade/setpoint - Port: 1 - Signal Name: r Point 2: - Block: scdcascade/Sum1 - Port: 1 - Signal Name: e1 Point 3: - Block: scdcascade/Sum - Port: 1 - Signal Name: y1m No permanent openings. Use the addOpening command to add new permanent openings. Properties with dot notation get/set access: Parameters : [] OperatingPoints : [] (model initial condition will be used.) BlockSubstitutions : [] Options : [1x1 linearize.LinearizeOptions]
The displays shows that e1
and y1m
are the second and third analysis points of sllin
.
Remove the points from the interface.
removePoint(sllin,[2 3]);
Input Arguments
s
— Interface to Simulink® model
slLinearizer
interface | slTuner
interface
Interface to a Simulink model, specified as either an slLinearizer
interface or an slTuner
interface.
pt
— Analysis point
character vector | string | cell array of character vectors | string array | positive integer | vector of positive integers
Analysis point to
remove from the list of analysis points for s
,
specified as:
Character vector or string — Analysis point signal name.
To determine the signal name associated with an analysis point, type
s
. The software displays the contents ofs
in the MATLAB® command window, including the analysis point signal names, block names, and port numbers. Suppose an analysis point does not have a signal name, but only a block name and port number. You can specifypt
as the block name.You can specify
pt
as a uniquely matching portion of the full signal name or block name. Suppose the full signal name of an analysis point is'LoadTorque'
. You can specifypt
as'Torque'
as long as'Torque'
is not a portion of the signal name for any other analysis point ofs
.For example,
pt = 'y1m'
.Cell array of character vectors or string array — Specifies multiple analysis point names. For example,
pt = {'y1m','y2m'}
.Positive integer or — Analysis point index.
To determine the index of an analysis point, type
s
. The software displays the contents ofs
in the MATLAB command window, including the analysis points indices.For example,
pt = 1
.Vector of positive integers — Specifies multiple analysis point indices. For example,
pt = [1 2]
.
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:
s = slLinearizer('scdcascade',{'u1','y1'});
Alternatively, you can use the addPoint
command.
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
.
For more information about how you can use analysis points, see Mark Signals of Interest for Control System Analysis and Design and Mark Signals of Interest for Batch Linearization.
Version History
Introduced in R2013b
See Also
slTuner
| removeAllPoints
| addPoint
| slLinearizer
| removeOpening
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)