control.matlab.connect

control.matlab.connect(sys, Q, inputv, outputv)

Index-based interconnection of an LTI system.

The system sys is a system typically constructed with append, with multiple inputs and outputs. The inputs and outputs are connected according to the interconnection matrix Q, and then the final inputs and outputs are trimmed according to the inputs and outputs listed in inputv and outputv.

NOTE: Inputs and outputs are indexed starting at 1 and negative values correspond to a negative feedback interconnection.

Parameters:

sysInputOutputSystem

System to be connected.

Q2D array

Interconnection matrix. First column gives the input to be connected. The second column gives the index of an output that is to be fed into that input. Each additional column gives the index of an additional input that may be optionally added to that input. Negative values mean the feedback is negative. A zero value is ignored. Inputs and outputs are indexed starting at 1 to communicate sign information.

inputv1D array

List of final external inputs, indexed starting at 1.

outputv1D array

List of final external outputs, indexed starting at 1.

Returns:

outInputOutputSystem

Connected and trimmed I/O system.

See also

append, feedback, connect, negate, parallel, series

Examples

>>> G = ct.rss(7, inputs=2, outputs=2)
>>> K = [[1, 2], [2, -1]]  # negative feedback interconnection
>>> T = ct.connect(G, K, [2], [1, 2])
>>> T.ninputs, T.noutputs, T.nstates
(1, 2, 7)