Function Repository Resource:

SystemsModelConnect

Source Notebook

Connect systems together using any inputs and outputs

Contributed by: Bob Sandheinrich

ResourceFunction["SystemsModelConnect"][{sys₁,sys₂,…}]

merges the systems without creating any interconnections.

ResourceFunction["SystemsModelConnect"][{sys₁,sys₂,…},connections]

gives a single systems model including the specified connections.

ResourceFunction["SystemsModelConnect"][{sys₁,sys₂,…},connections,inputs,output]

includes only the specified inputs and outputs in the resulting systems model.

Details and Options

Each systems model sys₁ can be a StateSpaceModel, TransferFunctionModel, AffineStateSpaceModel or NonlinearStateSpaceModel.

All systems models must share a common SamplingPeriod.

The result is a single systems model.

The resulting systems model will be the simplest type compatible with all the connected systems.

The connections are specified in a list {con₁,con₂,…}, where each con_i is given as {s_oi, out_i}→{s_ii,in_i} where all the s, in and out values are integer indices based on the following table:

s_oi

source system of the connection

out_i

output of s_oi to connect

s_ii

target system of the connection

in_i

input of s_ii to connect

The inputs are each specified as a list {{s₁,in₁},…}.

The outputs are each specified as a list {{s₁,out₁},…}.

All can be used for inputs or outputs to include all inputs or outputs in the resulting system.

Examples

Basic Examples (2)

A merged system connect like SystemsModelMerge:

In[1]:=

$ResourceFunction[ "SystemsModelConnect"][{TransferFunctionModel[{{{1}}, s \[Alpha]}, s], TransferFunctionModel[{{{b + s}}, a + s}, s]}]$

Out[1]=

A series connection like SystemsModelSeriesConnect:

In[2]:=

$ResourceFunction[ "SystemsModelConnect"][{TransferFunctionModel[{{{1}}, s \[Alpha]}, s], TransferFunctionModel[{{{b + s}}, a + s}, s]}, {{1, 1} -> {2, 1}}, {{1, 1}}, {{2, 1}}]$