Specify frequencydependent piecewiselinear upper and lower
bounds on the singular values of a linear system. You can then optimize
the model response to meet these bounds using sdo.optimize
to
.
You can specify upper or lower bounds, include multiple edges, and extend them to + or –infinity.
You must have Simulink^{®} Control Design™ software to specify singular value requirements.
creates
a singval_req
= sdo.requirements.SingularValuesdo.requirements.SingularValue
object and assigns
default values to its properties.
uses
additional options specified by one or more singval_req
=
sdo.requirements.SingularValue(Name,Value
)Name,Value
pair arguments. Name
is a property name and Value
is the corresponding value. Name
must appear inside single quotes (''
). You can specify several namevalue
pair arguments in any order as Name1,Value1,...,NameN,ValueN
.
Specify optional commaseparated pairs of Name,Value
arguments.
Name
is the argument
name and Value
is the corresponding
value. Name
must appear
inside single quotes (' '
).
You can specify several name and value pair
arguments in any order as Name1,Value1,...,NameN,ValueN
.

Frequency values for the gain bound. Specify the start and end frequencies for all the edges in the
piecewiselinear bound. The property must be a Use Use the Default: [1 10] 

Magnitude values for the gain bound. Specify the start and end gain values for all the edges in the
piecewiselinear bound. The property must be a nx2 array of finite
doubles where each row specifies the start and end gains of an edge
in the piecewiselinear bound. The number of rows must match the number
of rows of the Use Use the Default: [0 0] 

Requirement description. Must be a string. Default: 

Frequencyaxis scaling. Use this property to determine the value of the bound between edge start and end points. Must be one of the following strings:
For example, if bound edges are at frequencies Default: 

Frequency units of the requirement. Must be one of the following strings:
Default: 

Magnitude units of the requirement. Must be:
Default: 

Requirement name. Must be a string. Default: 

Extend bound in a negative or positive frequency direction. Specify whether the first and last edge of the bound extends
to Must be a 1x2 logical array of Default: 

Magnitude bound type. Must be:
Use to specify whether the piecewiselinear bound is an upper or lower bound. Use for upper bound and for lower bound. 

Frequency values for the gain bound. Specify the start and end frequencies for all the edges in the
piecewiselinear bound. The property must be a Use Use the Default: [1 10] 

Magnitude values for the gain bound. Specify the start and end gain values for all the edges in the
piecewiselinear bound. The property must be a nx2 array of finite
doubles where each row specifies the start and end gains of an edge
in the piecewiselinear bound. The number of rows must match the number
of rows of the Use Use the Default: [0 0] 

Requirement description. Must be a string. Default: 

Frequencyaxis scaling. Use this property to determine the value of the bound between edge start and end points. Must be one of the following strings:
For example, if bound edges are at frequencies Default: 

Frequency units of the requirement. Must be one of the following strings:
Default: 

Magnitude units of the requirement. Must be:
Default: 

Requirement name. Must be a string. Default: 

Extend bound in a negative or positive frequency direction. Specify whether the first and last edge of the bound extends
to Must be a 1x2 logical array of Default: 

Magnitude bound type. Must be:
Use to specify whether the piecewiselinear bound is an upper or lower bound. Use for upper bound and for lower bound. 
evalRequirement  Evaluate singular value bound on linear system 
Handle. To learn how handle classes affect copy operations, see Copying Objects in the MATLAB^{®} documentation.
Construct a singular value object and specify bound frequencies and magnitudes.
r = sdo.requirements.SingularValue; set(r,'BoundFrequencies',[1 10; 10 100],... 'BoundMagnitudes',[1 1; 1 0]);
Alternatively, you can specify the frequency and magnitude during construction.
r = sdo.requirements.SingularValue(... 'BoundFrequencies', [1 10; 10 100], ... 'BoundMagnitudes', [1 1; 1 0]);
Use getbounds
to get the
bounds specified in a Check Singular Value
Characteristics block.