generate a root-locus plot - Maple Help

Online Help

All Products    Maple    MapleSim

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

DynamicSystems[RootLocusPlot] - generate a root-locus plot

Calling Sequence

RootLocusPlot(sys, Krange, opts)




System; system object



(optional) realcons .. realcons; range over which K is swept



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



The RootLocusPlot command plots the root-locus of a subsystem of sys, a System object. The subsystem must be numeric.


The root-locus consists of the roots of 1+KGs, where Gs is the transfer function of the selected subsystem of sys, s is the frequency variable (z for discrete systems), and K is a parameter.


The optional parameter Krange assigns the range over which K is swept. It is a range of type realcons; the left hand side must be less than the right hand side. The default is 0..10.


The zeros and poles of G are plotted as the circles and crosses, respectively. At K=0 the poles of G lie on the root-locus. At K= the zeros of G lie on the root-locus.


The option info can be used to get information about the root-locus.

Info Record Details

If the value of the keyword parameter info is a name, then that name is assigned a record containing information about the root-locus. The following paragraphs describe each of the fields of the record.


charpoly = polynom

The characteristic polynomial of the system, with parameter K. This is the polynomial whose roots make up the root-locus as K varies.


deq = equation

The differential equation passed to dsolve. If algorithm = fsolve, the value is NULL.


G = ratpoly

The transfer-function of the selected subsystem of sys.


Kbranches = list( realcons )

A list of the values of K at which the root-locus branches.


Kcrit = realcons

The critical value of K, that is, the value at which charpoly acquires a degree less than its maximum (there can be at most one such value). If no critical value exists, the value is NULL.


poles = list( complexcons )

A list of the roots of the denominator of G.


zeros = list( complexcons )

A list of the roots of the numerator of G.


The RootLocusPlot command takes all standard plot,options.





Using fsolve is considerably faster than dsolve on the following system (this is not always the case).  These are the commands to create the plot from the Plotting Guide.



Inspect the values of K at which the locus branches.







See Also

DynamicSystems, DynamicSystems[RootContourPlot], DynamicSystems[SystemObject], DynamicSystems[ZeroPolePlot]

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