connectByNames

Method of mdss.

Connect signals of an mdss model by matching signal names.

Source: src/model/@mdss/connectByNames.m

Syntax

sys = connectByNames(sys)

Description

connectByNames builds the connection matrices automatically from signal names and then calls connectByIndices. Submodels must already be combined with append before connecting.

The rules are:

Duplicate input names are merged into a single similar input. If several inputs share a name they are collapsed together, and an informational message is printed.
Each input name is then matched against the stateName, algebraicName and binaryName lists. A match creates a connection between that input and the correspondingly named state, algebraic variable or binary.

Names must be unique among outputs: if two states, two algebraics, two binaries, or two connected outputs share a name, an error is raised. If no input name matches any signal name, a warning is issued and the model is returned unchanged.

Input arguments

Argument	Description
`sys`	The appended `mdss` model whose connected signals share names (e.g. `sys.stateName(i) == sys.inputName(j)`).

Output arguments

Output	Description
`sys`	The model with all name-matched signals connected.

Example