In the Setup module, the FRF dataset is read into AFPoly, the polyreference model parameters are defined, the frequency range is selected, and the reference and responses sieve is selected. Information about the FRF dataset and current references and responses sieve is displayed in the Setup Info panel. Hovering the mouse pointer over AFU Name will show some additional information about the data file
Selecting a plotted line with the mouse pointer and holding down the middle button will highlight that line and its corresponding entry in the plot legend. Selecting a line in the plot legend with the mouse pointer and holding down the middle button will highlight that line and the corresponding line in the plot axes (this feature is not available in Matlab R2014b or later). The name from the legend will be displayed in the message line at the bottom of the window.
Poly Model : Min Order – Enter the minimum model order of the polyreference polynomial to be processed. Entry must be a positive integer greater than two.
Poly Model : Max Order – Enter the maximum model order of the polyreference polynomial to be processed. Entry must be a positive integer.
Poly Model : Step Order – Enter the step increment of the polyreference polynomial model orders to be processed. Entry must be a positive integer greater than zero. The model orders processed by the polyreference algorithm are from the Poly Model Min Order to the Poly Model Max Order, incremented by the Poly Model Step Order.
Poly Model : Poly Poles – Displays the number of poles to be computed for each model order. The values are derived from [Min Order : Step Order : Max Order] times the number of references. This box is for display purposes only and is not editable.
Freq Range : Lower & Upper Freq – Enter the lower and upper limits of the frequency range to be processed. These values can also be set using the two cursors in the plot axes. There is a context menu on the edit boxes from which to set the full frequency range.
Exclude Frequency Range Cursors – Segments of the frequency response functions can be excluded from the poles and residues processing with "exclude frequency range cursors." When exclude frequency range cursors are defined in the AFPoly Setup module, the corresponding spectral lines are not included in the pole estimation algorithm or the residue estimation algorithm. An exclude frequency range cursor is a patch cursor in a pale reddish hue that can have its width changed graphically. The patch has a context menu to remove the cursor or to stretch it left or right. To stretch the cursor to the right, select Stretch Right from the context menu and then click on the cursor patch. The left edge of the cursor is anchored and the right edge moves with the mouse pointer. The Stretch Left operation anchors the right edge of the cursor and the left edge moves with the mouse pointer. Adding and removing exclude frequency range cursors are available from the Display menu for the Setup module or from the context menu on the plot axes, and Ctrl+E is the hotkey for adding a cursor. A cursor added from the Display menu is created at the center of the plot axes and a cursor added from the axes context menu is centered at the mouse pointer. The default width of an added cursor is the smaller of 5% of the selected frequency range or 90% of the axes x-limits. In the Poles, Shapes, and Verify modules, the exclude frequency range cursors are displayed as light gray patches but cannot be removed or modified.
Plot Function – Select the mode indicator functions (MIF) to plot. The available MIFs are:
Mode Indicator Functions
PSMIF |
Power Spectra Mode Indicator Function |
CMIF |
Complex Mode Indicator Function |
QMIF |
Quadrature Mode Indicator Function, which is the CMIF of the imaginary part of the FRF |
MMIF |
Multivariate Mode Indicator Function |
NMIF |
Normal Mode Indicator Function |
Plot Function : CMIF Order – Select the ordering of the CMIF and QMIF functions. If the CMIF Order is 'sorted', the CMIF and QMIF functions are sorted by decreasing magnitude at each spectral line. When CMIF Order is 'tracked', the CMIF and QMIF functions are sorted based on the similarity of the left singular vectors between adjacent spectral lines. The left singular vectors are compared by determining the maximum inner product for the vectors from adjacent spectral lines. The singular values are sorted accordingly. Tracking can be used to evaluate CMIF crossovers that appear as peaks in the lower CMIF functions.
Plot Function : Max MIF Order – Select the maximum order of the mode indicator functions that are plotted.
References – Select the references to include in the sieve for polyreference processing. Use the context menu to select the list attributes, disable selected references, enable all references, or sieve by coordinate trace.
Responses – Select the responses to include in the sieve for polyreference processing. Use the context menu to select the list attributes, disable selected responses, enable all responses, sieve by coordinate trace, or open the Responses dialog.
Tools > Setup > Send MIFS to UIPLOT – Computes (if necessary) and sends all MIFs to UIPLOT.
Tools > Setup > Send MIFS to IMAT Plot – Computes (if necessary) and sends the selected MIF to an IMAT plot figure.
Tools > Setup > Send MIFS to spVIEW MIFs – Computes (if necessary) and sends the selected MIFs to the spVIEW MIFs module. A list dialog is presented from which to select the MIFs to send. If spVIEW is already running, the functions are sent to this instance of spVIEW, otherwise a new spVIEW is started.
Tools > Setup > Add Exclude Frequency – Adds exclude frequency range cursors at individual frequency lines. An input dialog GUI is presented to enter the frequencies to exclude. If the excluded frequency is at a spectral line, the excluded frequency range is half the frequency spacing to either side of the spectral line. If the excluded frequency is not at a spectral line, the excluded frequency range contains the adjacent spectral lines nearest the excluded frequency.
Tools > Setup > List Exclude Freq Ranges – This tool list the exclude frequency ranges in a table dialog, sorted by the range start frequency. Selecting one of the ranges sets the x-limits of the plot axes in the AFPoly Setup module to show that exclude frequency range cursor. The selected exclude frequency range can also be removed from the dialog.