**Package: **sdo.requirements

**Superclasses: **

Impose region bound on phase plane trajectory of two signals

Use the `sdo.requirements.PhasePlaneRegion`

object
to impose a region bound on the phase plane trajectory of two signals
in a Simulink^{®} model. The phase plane trajectory is a plot of
the two signals against each other. In the object, you can specify
the bounded region as a single edge, or multiple piecewise-linear
edges. You specify the starting and ending *x* and *y* coordinates
of the bound edges, where the X-Y plane is the phase plane defined
by the two signals. You also specify whether you require the trajectory
of the two signals to lie inside or outside the bounded region specified
by the edges.

You can use the object as an input to your cost function,
and use the `evalRequirement`

command in the cost
function to evaluate whether your test signals satisfy the specified
requirement. You can then use the cost function and `sdo.optimize`

to perform parameter estimation
or response optimization, subject to the 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.

creates an `requirement`

=
sdo.requirements.PhasePlaneRegion`sdo.requirements.PhasePlaneRegion`

requirement
object and assigns default values to its properties. Use dot notation
to customize the properties of the object, except bound edges. To
specify the bound edges simultaneously, use the `set`

command.
Use the `evalRequirement`

command to evaluate whether
test signals satisfy the specified requirement.

creates
the requirement object with additional options specified by one or
more `requirement`

= sdo.requirements.PhasePlaneRegion(`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`

.

Specify optional
comma-separated 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`

.

Use `Name,Value`

arguments to specify properties of the
requirement object during object creation. For example, ```
requirement
= sdo.requirements.PhasePlaneRegion('OpenEnd',[1 1])
```

creates
an `sdo.requirements.PhasePlaneRegion`

object
and specifies that the first and last edge of the bound extend to
infinity.

evalRequirement | Evaluate satisfaction of piecewise-linear bound on phase plane trajectory of two signals |

Handle. To learn how handle classes affect copy operations, see Copying Objects (MATLAB).

Was this topic helpful?