Menus

  1. File: Import
  2. File: Export
  3. File: Print
  4. File: Exit
  5. Edit: Add Pair
  6. Edit: Remove
  7. Edit: Add Repeatedly
  8. Edit: Add with Conjugate
  9. Options: Show Graph
  10. Options: Settings
  11. Options: Zoom
  12. Options: Line Width
  13. Options: Line Color
  14. Options: Click Enable
  15. Options: Unlink Pairs/Quad
  16. Help: Help menu

File: Import

This option helps to import Gain, Pole-Zero locations and few other settings into the GUI from a user provided MAT file. The structure of the data in the file needs to be as shown below,

Variable name: savedata

savedata{1} - Gain, as a constant
savedata{2} - Location of poles, as a Row matrix. Can be empty if no poles.e.g.,savedata{2} = [0.5-0.5i 0.5+.5i]
savedata{3} - Location of Zeros, as a Row matrix. Can be empty if no zeros.e.g.,savedata{3} = [-.5-.1i]
savedata{4} - String representing location of poles, enclosed in parenthesis. Empty string if no poles.e.g.,savedata{4}=['(.5,-.5)';'(.5,.5)']
savedata{5} - String representing location of zeros, enclosed in parenthesis. Empty string if no zeros.e.g.,savedata{5}=['(-.5,-.1)']
savedata{6} - Line width used in plots, as a constant.
savedata{7} - Line color used in plots, as a colormap. See 'help colormap' for format of colormap.
savedata{8} - Square Matrix of size N (number of non-zero Poles/Zeros). If a pair of Poles/Zeros are linked (i.e conjugates), then the corresponding columns have a 1 at two locations.(column and row).e.g.,
  If the 2 poles need to be linked, savedata{8}=[1 1 0;1 1 0;0 0 1];
  If the 2 poles need not to be linked, savedata{8}=[1 0 0;0 1 0;0 0 1];
savedata{9} - String representing markers for Poles/Zeros. Default 'x','o'.e.g.,savedata{9}=['x';'x';'o']

Back to Top
File: Export

This option exports details from the GUI into a MAT file. The variable being exported is 'savedata' and has the structure as explained in File: Import section.

Back to Top
File: Print

This option can be used to print the Pole-Zero GUI.

Back to Top
File: Exit

This option can be used to gracefully exit from the Pole-Zero GUI.

Back to Top
Edit: Add Pair

This option can be used to add one or pair of Poles/Zeros or both. After selecting one of the 3 choices,

  • Pole
  • Zero
  • Pole_Zero
    a mouse-click on the Pole-Zero plot will insert the corresponding pole/zero at that location. This option is linked to the 'Add with Conjugate' setting. If the 'Add with Conjugate' is set, pole/zeros are inserted as conjugate pairs.
    Note: While adding single pole/zero, additional zero/pole at Zero are automatically added to have a valid transfer function.

    Back to Top
    Edit: Remove

    Selecting this Option, removes poles/zeros or both from the pole-zero plot.

    Back to Top
    Edit: Add Repeatedly

    If this option is set, Poles/Zeros can be added continuously .i.e.,continuous mouse-clicks on the pole-zero plot will add appropriate poles/zeros. If its not set, the 'Add Pair' option has to be selected before each mouse-click to add poles/zeros

    Back to Top
    Edit: Add with Conjugate

    This option helps to add poles/zeros as conjugate pairs. If this is set, then poles/zeros added using the 'Add Pair' menu are added as conjugate pairs.

    Back to Top
    Options: Show Graph

    Select this option to display the plots in the GUI as a separate figure window. The new figure window has the Pole-Zero, Impulse response, Magnitude and Phase plots.

    Back to Top
    Options: Settings

    Selecting this option, brings up a dialog box, which helps you to enter the filter coefficients. The dialog box also has options to Import and Export filter coefficients in a MAT file.
    The file for Import/Export has a variable filter_co. This is a cell array with 2 string entries for the 'a' and 'b' coefficients.

    filter_co{1} - System denominator coefficients. 'a'
    filter_co{2} - System numerator coefficients. 'b'
    Back to Top
    Options: Zoom

    This option helps to 'Zoom in' within the Pole-Zero plot, to identify precise location of poles and zeros.

    Back to Top
    Options: Line Width

    This option lets you to set the width of the lines used in the plots within the GUI, including that of the markers for Poles/Zeros. It can be set to 1,2,3 or 4. Default width is 2.

    Back to Top
    Options: Line Color

    This option lets you to set the color of the lines used in the plots within the GUI, including that of the markers for Poles/Zeros. It can be set to Black, Blue, Red, Green or Yellow. Default color is Blue.

    Back to Top
    Options: Click Enable

    This option helps to select or move already exiting poles/zeros using the mouse, within the Pole-Zero plot. Select this option and then choose a pole/zero in the pole-zero plot. By holding the pole/zero using the mouse, you can move it to different locations. With the movement of poles/zeros, you should be able to see the corresponding variations in the system response.

    Back to Top
    Options: Unlink Pairs/Quad

    This option helps to Unlink already existing pole/zero pairs. Use 'Click Enable' to select a pole/zero pair. Then selecting 'Unlink Pairs/Quad' will unlink the pair and will be converted to separate poles/zeros.

    Back to Top
    Help: Help

    Selecting this option brings up the on-line help for the Pole-Zero GUI in an internet browser. i.e., this help document.

    Back to Top