sdo.requirements.FunctionMatching class
Package: sdo.requirements
Superclasses:
Impose function matching constraint on variable
Description
Use the sdo.requirements.FunctionMatching
object
to impose a function matching constraint on the values of a variable
in a Simulink® model. The variable can be a vector, matrix, or
a multidimensional array that is a parameter in your model, such as
the data of a lookup table in your model. You create the requirement
object, and specify the linear or quadratic function that you want
the variable to match. For example, for a two-dimensional variable,
you can specify that test data from dependent variable V
match
a linear function of independent variables X1
and X2
:
Where, a0
, a1
,
and a2
are the fit-coefficients,
and X1
and X2
are
vectors.
You use the evalRequirement
method to evaluate
whether your test data satisfies the specified requirement, and specify
the independent variable vectors as inputs to the method. The software
calculates the fit-coefficients using the independent variables and
test data and then calculates the error between the test data and
the specified function of the independent variables.
You can use the requirement object as an input to your cost function and
use the evalRequirement
command in the cost function
to evaluate the requirement. You can then use the cost function and sdo.optimize
to perform response optimization,
subject to satisfaction of the specified requirement. If you are performing
sensitivity analysis, after you generate parameter samples, you can
use the cost function and sdo.evaluate
to
evaluate the requirement for each generated sample.
Construction
creates an requirement
=
sdo.requirements.FunctionMatchingsdo.requirements.FunctionMatching
requirement object and
assigns default values to its properties. Use dot notation to customize the properties.
Use the evalRequirement
command to evaluate whether test data
satisfies the specified requirement.
creates the requirement object with additional options specified by one or more
requirement
= sdo.requirements.FunctionMatching(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 name-value
pair arguments in any order as Name1,Value1,...,NameN,ValueN
.
Input Arguments
Name-Value ArgumentsSpecify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Use Name,Value
arguments to specify properties of the
requirement object during object creation. For example, requirement
= sdo.requirements.FunctionMatching('Type','quadratic')
creates
an sdo.requirements.FunctionMatching
object
and specifies the function to be matched as quadratic.
Properties
Methods
evalRequirement | Evaluate satisfaction of function matching requirement |
Copy Semantics
Handle. To learn how handle classes affect copy operations, see Copying Objects.
Examples
Version History
Introduced in R2016b