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 constantsavedata{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., savedata{8}=[1 1 0;1 1 0;0 0 1];
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']
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.
This option can be used to print the Pole-Zero GUI.
This option can be used to gracefully exit from the Pole-Zero GUI.
This option can be used to add one or pair of Poles/Zeros or both. After selecting one of the 3 choices,
Selecting this Option, removes poles/zeros or both from the pole-zero plot.
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
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.
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.
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'
This option helps to 'Zoom in' within the Pole-Zero plot, to identify precise location of poles and zeros.
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.
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.
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.
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.
Selecting this option brings up the on-line help for the Pole-Zero GUI in an internet browser. i.e., this help document.