connectOptions

Options for the connect command

Syntax

opt = connectOptions

opt = connectOptions(Name,Value)

Description

opt = connectOptions returns the default options for connect.

opt = connectOptions(Name,Value) returns an options set with the options specified by one or more Name,Value pair arguments.

Examples

collapse all

Retain Unconnected States in Model Interconnection

Use connectOptions to cause the connect command to retain unconnected states in an interconnected model.

Suppose you have dynamic system models sys1, sys2, and sys3. Combine these dynamic system models to build an interconnected model with input 'r' and output 'y'. Set the option to retain states in the model that do not contribute to the dynamics in the path from 'r' to 'y'.

opt = connectOptions('Simplify',false);
sysc = connect(sys1,sys2,sys3,'r','y',opt);

Input Arguments

collapse all

Name-Value Arguments

Specify 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.

Example: 'Simplify',false

`Simplify` — Automatic elimination of unconnected states
`true` (default) | `false`

Automatic elimination of unconnected states, specified as either true or false.

true — connect eliminates all states that do not contribute to the I/O transfer function from the specified inputs to the specified outputs of the interconnected system.
false — connect retains unconnected states. This option can be useful, for example, when you want to compute the interconnected system response from known initial state values of the components.

Data Types: logical