Previous UpNext


Chapter 2  Detailed Help on usage

2.1  Starting RLTOOL

Load the rltool library as per instructions in the README file. If the library loads properly the following message is displayed on Scilab prompt:

mode(-1);
rltool is loaded. Type "rlt()" to start rltool-1.6

Type ``rlt()'' to start this programme.

2.2  Rootlocus

On typing ``rlt()'', the you will see the following menu













  1. Open- to open an already saved rltool session

  2. New – to start a new rltool session

  3. Credits – Information about developers

  4. Help – This help manual

  5. Cancel – Close rltool and return to the Scilab prompt



If a new session is selected, the you will be prompted to enter the transfer function as numerator / denominator in the variable 's'.













Rltool will automatically load the plant you were working with in the previous session of rltool. Click ``Ok'' to confirm this plant. You may wish to edit the plant, in that case type in the new plant and click ``Ok''. You now see two windows as shown below

























Various components are maried in red. The Grey window to the right is the Control Center. Editing of the control loop can be done in the following ways

  1. Changing plant/ controller or sensor by clicking on the respective buttons and entering the desired transfer functions

  2. setting maximum gain of the root locus plot

The closed loop poles are highlighted by circles.
This window is shown in Figure (2.1). The various menus in the window are:

  1. ``File'': Load, save or print the rootlocus.

  2. ``Zoom'': Select a part of the rootlocus using the mouse and zoom onto it.

  3. ``UnZoom'': See the entire rootlocus (remove Zoom, if any).

  4. ``Grid'' : Menus under this head control the apperance of grids on all plots. These are:

  1. ``On'': Put a cartesian grid on all plots in the current session.

  2. ``Off'': Remove (if already present) a cartesian grid from all plots in the current session.

  3. ``Zeta/Wn'': Plot a constant z and wn curve on the rootlocus for a given value of z and wn.

  4. ``sgrid'': Plot a constant z and wn grid on the rootlocus.

  1. ``Response'': Various plots and responses can be viewed.

  1. ``Closed loop'': Closed loop responses for a given gain. More details are given in Section 2.6.

  2. ``Nyquist'': Nyquist plot.

  3. ``Nichols'': Nichols chart.

  4. ``Details'': Numerical values of poles and zeros, gain etc.

  5. ``Popov'': The Popov-plot of the system.

  1. ``Design'': There are two modes available in Rltool, namely Rootlocus and Frequency.

  1. ``Root Locus'': This is the default mode. Most options here are with a view towards time-domain design.

  2. ``Frequency'': This mode is still under development. Currently very limited options are available, like bode plots, sensitivity plots etc.

  1. ``Plant'': This menu provides utilities for editing the system. More details are given in Section 2.5.

  2. ``Save'': Save the current session and/or load previous sessions.

  3. ``Settings'': This menu provides all settings available to the user. More details are given in Section 2.9.

  4. ``Help'': A short online help is included on most topics. Click the sub-menu under this head to see the help. For example, help on rootlocus is included in ``Help®Root Locus''.

  5. ``Measure'': This feature allows a user to ``measure'' the gain at a point on the rootlocus. The user is first prompted to select a point. If this point is on the rootlocus, relevant information is displayed/updated.

2.3  The control center



 gui  gain in feedback control mode  

           Gain in forward path                 Gain in feedback                            Design mode
 (Settings-->Gain config-->Forward path) (Settings-->Gain config-->Feedback path) (Settings-->Gain config-->Design mode)
Immediately after starting rltool, a user will see the control center GUI. A user can use and configure most features using this simple GUI. Following is a brief description of features:

  1. Menus: Menus are mostly similar to the ones described in Section 2.2.

  2. ``Plant'' button: Click on this button to edit the current transfer function.

  3. ``Gain'' button: This displays the current gain selected by the user.

  4. Gain set (text mode): This field displays a message ``Type Gain Here'' by default. A user can type in a positive real valued gain in this field. Click on ``Ok'' to load this gain into Rltool.

  5. Slider: A user can select gain with a slider. The value of the gain selected is shown immediately above the slider.

  6. Max. Gain: This popup menu lets a user select the maximum allowed gain for the rootlocus. Options are 10, 50, 100, 500,...100,000. A user may also set the maximum allowed gain to a different value using the Settings menu.

  7. Exit button: Click on this button to quit rltool.

The most convenient way to use Rltool is to set a gain using the slider. The current gain is displayed above the slider bar and also in the ``gain'' button on the control center. Also, a window containing the following closed loop plots is continuously updated:

  1. Closed loop pole(s) and zero(s)

  2. Closed loop unit step response.

  3. Closed loop bode plot.

  4. Sensitivity plot

Note that ``closed loop plant'' may include either ``gain in feedback'' or ``gain in forward path''. Please see the ``Settings'' section for how to do this. A user can also set the units (hz or rad/sec) for bode and sensitivity plots. Please see the section on "Settings".
There is a Design mode (Settings-->Gain Configuration-->Design mode) is most useful for control system design

In the design mode, any changes made with the mouse will only affect the controller. The user can edit the plant by clicking on the Plant button, and edit the sensor by clicking on the Sensor button. This feature makes it very convenient to design controllers rapidly.


2.4  Frequency design

Rltool comes with two design modes... time domain (rootlocus) and frequency domain. You can select the frequency domain mode by clicking on ``Design ®Frequency''. You will see the frequency magnitude plot of the open loop transfer function. The magnitude is shown in decibel and frequency in rad/sec. Click on the plot to determine the magnitude and frequency. The frequency domain part is still under development. It will be a great idea to take up this aspect and design it further! You can ofcourse return to the rootlocus mode by clicking on ``Design ®Root Locus''.

2.5  Editing of Plants

These utilities are provided under the ``Plant'' tab on the main window. In the Root Locus mode, you can edit your plant at the click of a mouse. The following options are provided. The function of most of these should be obvious:

  1. Undo: Undo one change in the (open loop) plant.

  2. Add pole: Select the pole to be added by clicking on the graphics window. If you select a point with nonzero real part, both the point and its complex conjugate are added. That is, if G(s) is the current open loop transfer function and you select a complex point z, the new open loop plant will be

G(s

1

------------

(s-z)(s-z*)

    where z* denotes the complex conjugate of z.

  1. Remove pole: Click on the open loop pole that you want to remove. If you click on a pole with nonzero real part, both the pole and its complex conjugate are removed.

  2. Add zero: Similar to Add pole. Zero(s) are added to open loop transfer function.

  3. Remove zero: Similar to Remove pole. Zero(s) are removed from the open loop transfer function.

  4. Add cascade: You will be prompted to enter a transfer function H(s)=a(s)/b(s). If G(s) is the current transfer function, it is modified to

    G(sH(s)

    You will be prompted to ``accept'' this product. You can edit it if you wish (to truncate some spurious decimal places etc). This command is like a simultaneous addition of pole(s) and zero(s). However, in this case you are required to enter these through the keyboard, instead of using the mouse for the selection.

  5. Remove cascade: is like dividing G(s) by H(s), i.e. the open loop plant is modified to

G(s)

 ---------

H(s)

  1. Edit plant: The current plant is displayed in a dialogue box. You can modify it directly by typing in the appropriate value.

When in the design mode, the changes made using the "EDIT" menu will only affect the controller transfer function. The plant remains unchanged until you change it by clicking on the plant button. However, the loop transfer function will be modified appropriately.

2.6  Closed loop responses

There is a great deal of flexibility in rltool to see various closed loop responses. First you will have to select one ``gain configuration'' out of the possible two. Click on ``Settings ®Gain Configuration''. You will see a selection dialogue box with two choices:

closedloop

You can choose the gain to be in the forward path as shown in the figure.

This corresponds to the option ``K in forward path''. You can choose to put ``K in the feedback path''. However, ``K in forward path'' is the default.

To see closed loop responses, click on ``Response ®Closed Loop''. You will be prompted to click on a point of the rootlocus to select the ``operating point'' at which you want to see the closed loop response. Once you select the operating point, you are done!

Rltool calculates the closed loop transfer function for the configuration you have selected, i.e. the closed loop transfer function for ``K in forward path'' is


G K

------------

1+G K

and the closed loop transfer function for ``K in feedback path'' is


G

----------

1+GK

You will see a selection menu that shows the following:

  1. The gain corresponding to operating point you selected.

  2. Whether the closed loop system is stable or unstable.

  3. Impulse response: Click here to see the impulse response!

  4. Step response selection: Unit step response is displayed. A ``details'' button in the step response also displays parameters such as percent overshoot, rise time, settling time, z corresponding to second order approximation etc.

  5. Ramp response: Unit ramp response.

  6. Arbitrary input: You can enter piece-wise linear, single valued inputs through a graphics window. Use the mouse (press left button and drag) to ``draw'' this input. There are a host of features like ``undo'', ``abort'' etc which can be used. You can also resize your window to suit the range of your input. Click ``Edit ®Ok'' when you are done. If your input is single-valued, you will see the response of the closed loop system to this input.

  7. Sinusoidal input: The input is of the form

    A sin (w t)

    Output is simulated, by default for one of the input and is plotted. The default settings are A=1 and w=1   rad/sec. These can be changed by clicking on ``Settings'' button in the sinusoidal response window. You must close this window to return to the response selection menu.

  8. Frequency response (bode plot) of closed loop system. There is a choice in the units (Rad/sec) or (Hz). These are available in ``Options'' menu in the frequency response window.

  9. Sensitivity plot: Sensitivity is defined as the transfer function between the input u(t) and the error e(t). For the system shown in the above figure, the sensitivity can be found to be

1

-------------

1+kG(s)

    This transfer function is evaluated on the imaginary axis (by substituting s=iw) and the resulting (magnitude) plot is shown for various values of w. Options are similar to above.

Click on ``cancel'' to close the response selection menu and return to the main window of rltool.

2.7  Other responses

2.7.1  Nyquist plot

Nyquist plot of the open loop plant G(s) can be seen by clicking on ``Response ®Nyquist''. The gain and phase margin is displayed on the plot. If you find that your plot is too coarse or cluttered, you can change the minimum and maximum frequency in ``Settings ®Nyquist-Nichols plot''. The frequency units can be changed in ``Settings ®Frequency units''.

2.7.2  Nichols plot

Nichols plot for G(s) is obtained by selecting ``Response ®Nichols''. If the grid (in the main menu) is set to ``on'' you will see the logarithmic grid superimposed on the Nichols plot. Here too, you can select the desired frequency units.

2.7.3  Popov plot

The Popov plot can be used to predict the stability of the closed loop system with a sector bound nonlinearity in loop. We plot real part of G(iw) on the real axis and w Imaginary   G(iw) on the imaginary axis. A simple construction then gives the range of the ``Popov sector'' and the ``multiplier''. Please see any standard text on nonlinear systems for more details on the Popov plot.

2.8  Saving and loading plants

To save your current plant, click on ``Save ®Save''. You will be prompted to enter the filename to which the plant should be written.

To load an existing plant from a file, click on "Save ®Load". You will be prompted to enter the filename.

You must have the appropriate read/write permissions to do this operation.

2.9  Settings

We now look at the various settings that a user can access:

  1. Rootlocus: Set the maximum allowed gain, Kmax in rootlocus. The rootlocus is plotted for the gain range (0,Kmax).

  2. Magnitude plot: Set the minimum frequency, maximum frequency and the frequency step for the (open loop frequency) Magnitude plot. The unit for the frequency is rad/sec.

  3. Nyquist-Nichols plot: Frequency settings similar to above, for Nyquist plot and Nichols plot.

  4. Bode plot: Frequency settings for the (closed loop) Bode plot.

  5. Dynamic response: Set the maximum simulation time and the timestep for all dynamic responses (impulse, step, ramp, arbitrary input, sinusoidal input).

  6. Sensitivity plot: Frequency settings for the sensitivity plot.

  7. Graphics attributes: Graphics attributes like font, colour etc can be set from here.

  8. Gain configuration: Two options are possible for using rltool
    (a) Gain, K, is in the forward path.
    (b) Gain is in the feedback path.
    The default is (a). Selecting a particular gain configuration also results in that being displayed in the control center. For example, figure 2.2 shows that the current mode is ``Gain in forward path''.

  9. Browser path: Applicable only for *nix systems. You can set a default browser path for viewing this HTML manual while running rltool. The default browser is mozilla (only because this browser happens to be bundled into most *nix systems that I have seen). You can, for instance, type the full path to konqueror, or Opera, or any other web browser. This browser will be used to open the HTML manual while running rltool. Also see ``Help ®HTML manual''


In addition, the default configuration variables will be saved in a file called Rltool_Config-1.6.sci. This file is machine generated, however you can edit it if you so wish.

2.10  Help

A short online help is provided on some topics.


Previous UpNext