|
Calling Sequence
|
|
FeedbackConnect(systems, opts)
FeedbackConnect(systems, feedbacktype, opts)
FeedbackConnect(systems, loopconnections, opts)
|
|
Parameters
|
|
systems
|
-
|
list(System); list of system objects
|
feedbacktype
|
-
|
(optional) negative or positive; type of feedback loops, negative by default
|
loopconnections
|
-
|
(optional) listlist; list of lists of indexes specifying loop connections [loop 1,...,loop k], where the indexes in loop k must be ordered as follows: [input sys1, output sys1] for one system, and [input sys1, output sys1, input sys2, output sys2] for two systems. The sign of the last index in the above lists determines the type of feedback (positive or negative).
|
opts
|
-
|
(optional) equation(s) of the form option = value; specify options for the FeedbackConnect 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 FeedbackConnect command creates the equivalent system representation of the feedback connection of one or two system objects. When two system objects are given, the first system is placed in the forward path and the second system is placed in the reverse (or feedback path). When a single system is given, the system object is placed in the forward path and unity feedback is assumed.
|
•
|
Unless loop connection lists are specified, all inputs and outputs of the systems are used to form negative feedback loops by default. The number of forward path system's outputs must match the number of feedback path system's inputs. Likewise, the number of forward path system's inputs must match the number of feedback path system's outputs. The returned system has the same number of inputs/outputs as the forward path system.
|
•
|
If loop connection lists are provided, the number of loops connection lists must not exceed the minimum number of inputs or outputs of the individual systems. If a single system is specified, the loop connection lists must contain 2 indexes each, as in [input sys1, output sys1]. If two systems are specified, the loop connection lists must contain 4 indexes each, as in [input sys1, output sys1, input sys2, output sys2].
|
•
|
The system objects must be either both continuous or both discrete with the same sampling times.
|
•
|
The returned system type is the same as the input system type, unless the outputtype option is used, or the input is an ae system type.
|
•
|
In the specific case when the system parameter is an algebraic equation (ae) and no option is specified, the FeedbackConnect command returns a system object in state space form by default. If the algebraic equation system does not have a state space representation, an error is returned. For details on algebraic equation object support by the DynamicSystems package, see DynamicSystems[AlgEquation].
|
|
|
Examples
|
|
>
|
|
Example 1: Connect a SISO system with negative unity feedback
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
>
|
|
>
|
|
| (3) |
Example 2: Connect two MIMO systems in positive feedback
>
|
|
>
|
|
>
|
|
| (4) |
Example 3: Connect a MIMO system with two negative unity feedback loops, connecting input u11 and output y14 and input u13 and output y12, respectively.
>
|
|
>
|
|
| (5) |
Example 4: Connect two MIMO systems with two negative feedback loops, as shown in the figure.
>
|
|
>
|
|
>
|
|
| (6) |
|
|
Compatibility
|
|
•
|
The DynamicSystems[FeedbackConnect] command was introduced in Maple 18.
|
|
|
|