|
Calling Sequence
|
|
SeriesConnect(systems, indexes, opts)
|
|
Parameters
|
|
systems
|
-
|
list(System); list of system objects
|
indexes
|
-
|
(optional) list(list); list of lists specifying the indexes of the outputs and inputs to be connected in two consecutive systems in series, i.e. [[outputs sys 1], [inputs sys 2], [outputs sys 2],..., [inputs sys n]].
|
opts
|
-
|
(optional) equation(s) of the form option = value; specify options for the SeriesConnect command
|
|
|
|
|
Options
|
|
•
|
outputtype = tf, coeff, zpk, ss, or de
|
|
Specifies the subtype of the returned system object. The default return type is based on the type of the system objects specified in the systems parameter. See the Description section for more details on the return type.
|
•
|
merge = keep, evaluate, or replace
|
|
Specifies how parameters from different systems are merged. The default is keep.
|
–
|
keep: keep the original parameters. The value for a parameter is the value assigned by the first system that defines it.
|
–
|
evaluate: replace all parameters in the systems with their assigned values.
|
–
|
replace: replace each parameter in a system with a distinct parameter created by appending an index from the param_indices options. For example, the parameter of the first system becomes .
|
|
Used when merge is replace. The k-th element of the list is appended, as an index, to each parameter name of the k-th system. The number of elements must match the number of systems. The default is the positive integers, with 1 corresponding to the first subsystem.
|
|
|
Description
|
|
•
|
The SeriesConnect command creates the equivalent system representation of two or more system objects connected in series.
|
•
|
The systems are connected in series in the order specified, matching the outputs of the previous system to the inputs of the next system unless index lists are specified.
|
•
|
If indexes is provided, specific outputs of the previous system are connected to specific inputs of the next system in the order given by the indexes in the lists.
|
•
|
When two systems are specified, the first list contains the indexes of the outputs of the first system, and the second list contains the indexes of the inputs of the second system. For subsequent series connections, the same rule applies. For n systems, the necessary number of index lists is (2n - 2).
|
•
|
The returned system has the same number of inputs as the first system specified, and the same number of outputs as the last system specified.
|
•
|
The systems must be either all continuous or all discrete with the same sampling times.
|
•
|
The returned system type is determined by the type of the input systems, unless the outputtype option is used. If different types of system objects are passed, the returned system type is determined based on a precedence list defined as tf < coeff < zpk < ss < de. For example, if a ss and tf system are supplied, the output will be an ss system.
|
|
|
Examples
|
|
>
|
|
Example 1: SISO series connection
>
|
|
>
|
|
>
|
|
>
|
|
| (1) |
Connect three transfer functions in series
>
|
|
| (2) |
Example 2: MIMO series connection
>
|
|
>
|
|
>
|
|
| (3) |
Example 3: Series connection of two systems with 2nd output of 1st system to 1st input of 2nd system
>
|
|
>
|
|
| (4) |
Example 4: Series connection of two systems with 1st output of 1st system to 2nd input of 2nd system and 2nd output of 1st system to 1st input of 2nd system
>
|
|
| (5) |
Example 5: Series connection of three systems as shown in the figure.
>
|
|
| (6) |
Alternately, using the series4 result:
>
|
|
| (7) |
|
|
Compatibility
|
|
•
|
The DynamicSystems[SeriesConnect] command was introduced in Maple 18.
|
|
|
|