DynamicSystems - Maple Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Science and Engineering : Dynamic Systems : Plotting and Graphical Tools : DynamicSystems/ZeroPolePlot

DynamicSystems

  

ZeroPolePlot

  

plot zeros and poles of a linear system

 

Calling Sequence

Parameters

Options

Description

Examples

Calling Sequence

ZeroPolePlot (sys, opts)

Parameters

sys

-

System; system object to plot

opts

-

(optional) equation(s) of the form option = value; specify options for the ZeroPolePlot command

Options

• 

color = name or string or list of same

  

Specify the colors of the zeros and poles of each subsystem. If one color is specified, all subsystems use that color. If a list of colors is specified, the colors of the subsystems are selected cyclically from the list. The default is to use the value of the colors variable of the DynamicSystems[SystemOptions] command. The keyword colour may be used as a synonym for color.

• 

legend = list or element

  

Specifies the legend for the plot. A list specifies a legend entry for each subsystem. The elements in the list correspond to the Matrix of subsystems taken in Fortran order. An element can be used for a one-by-one Matrix of subsystems. The default is no legend.

• 

output = plot, data, or list of same

  

Specifies the output of ZeroPolePlot. The name plot returns the plot structure. The name data returns the data. A list of those names returns a corresponding list of plots and data. The default is plot.

  

The data is returned as a Matrix for a single selected subsystem and as a list of Matrices for multiple selected subsystems. Each Matrix has two columns: the first is the horizontal component and the second is the vertical component.

• 

subsystem = [ posint, posint ] or list of same

  

Selects subsystems of a multi-input/multi-output system. Each selected subsystem is specified as a list of two indices: the first specifies the output and the second specifies the input. For example, 1,2 specifies the subsystem from the second input to the first output. A list of lists selects multiple subsystems. The default setting is to select all subsystems, using Fortran ordering. That is, for an m x n system, the default list of subsystems is [ [1,1], ..., [m,1], ..., [1,n], ..., [m,n] ].

• 

unitcircle = truefalse

  

Specifies whether the unit circle (a circle with radius one and center at the origin) is plotted. This is the default when the system is discrete. The interior of the unit circle is the region of stability for a discrete system.

Description

• 

The ZeroPolePlot command plots the zeros and poles of a subsystem of sys, a System object. The zeros correspond to the roots of the numerator of the transfer-function of sys, the poles to the roots of the denominator.

• 

The roots are plotted on the complex plane. The horizontal axis corresponds to the real part of the roots, the vertical axis to the imaginary part.

• 

Zeros are plotted as circles, poles are plotted as crosses.

• 

The default plot-option axes is set to boxed; this permits viewing a pole (cross) that would otherwise lie on an axis.

• 

For a multi-input/multi-output system, some or all of the subsystems can be selected. The option subsystem selects the subsystems.

• 

The ZeroPolePlot command takes all standard plot,options. For the special syntax that ZeroPolePlot uses with the color option, see below.

Examples

withDynamicSystems:

Create a system with two inputs and two outputs:

sysTransferFunctionss+1+I10s+1I10|1s+1,1s+3I7s+3+I7|1s+3s+5:

sys:-tf

ss2+2s+1011s+11s2+6s+581s2+8s+15

(1)

ZeroPolePlotsys,color=red,green,blue,brown,title=Zeros and Poles

ZeroPolePlotsys,subsystem=1,1,color=red,title=System [1,1]

ZeroPolePlotsys,subsystem=1,2,2,1,color=red,blue,title=Systems [1,2] and [2,1]

dxZeroPolePlotsys,output=data

dx:=0.,1.00000000010.00000000I,1.+10.00I,,3.0000000007.000000000I,3.+7.000000000I,,1.,,5.,3.000000000

(2)

The commands to create the plot from the Plotting Guide are

sys_zTransferFunction403z4200z3420z2+300z70,discrete,sampletime=0.1:

ZeroPolePlotsys_z,color=red,title=Discrete System

See Also

DynamicSystems

DynamicSystems[RootLocusPlot]

DynamicSystems[SystemObject]

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam