Verify Module

In the Verify module, synthesized results are compared to the measurements to evaluate the accuracy and completeness of the modal parameter estimation process. Information about the FRF dataset and references and responses sieve, polyreference model orders, frequency range, and shapes model is displayed in the Verify Info panel. Hovering the mouse pointer over AFU Name will show some additional information about the data file or workspace imat_fn. Hovering the mouse pointer over References will show the references coordinate information.

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 associated line in the other FRF axes will also be highlighted, if applicable, and the name from the legend will be displayed in the message line at the bottom of the window.

A warning dialog will be shown when entering the Verify module if the Shapes Model Method is 'refit', the Shapes Model Type is 'real', and any of the shapes have a positive imaginary driving point residue, which will result in a negative modal mass when the mode shapes are scaled for unity modal mass. The poles for which this condition exists are listed on the dialog and can be marked with x-cursors on the plot axes.

 

Poles List – The frequency and damping of the poles selected from the Stability Diagram in the Poles module are listed in the Poles List, which is the table in the lower left side of the module. The poles that are gray and not checkable were not included in the residue processing. The check boxes in the Poles List determine if a pole is enabled. Only the enabled (checked) poles are included in FRF synthesis, written to a file or the MATLAB workspace, or sent to the animator using the Send to Animation Tool. The Poles List has a context menu to check all or check none of the poles, or to reset edited poles to the as-computed values. The rows of the Poles List can be selected with the mouse. Clicking in the Poles List and pressing Ctrl+A will select the entire list. The Remove button will remove the selected poles from the Poles List. The Animate button will send the shapes of the selected poles to the animator, whether or not the pole is checked. If the Animate Back-Expanded Shapes check box is checked, then the shapes will be back-expanded when sent to the animator. There are pole markers (inverted triangles) at the top of the plot axes, which are outlined in black if the corresponding pole was included in the refit residue processing, or gray if not, and filled if the corresponding pole is checked or empty if not. A pole can be edited by selecting only one pole in the Poles List and pressing the Edit button. An input dialog GUI is presented, as shown below, to edit the frequency and damping values of the pole.

Plot Function – Select the mode indicator functions to plot. Only one MIF type can be selected for synthesis comparison. The available MIFs are the same as for the Setup, Poles, and Shapes modules, with the addition of FRF. The measured functions (MIF or FRF) are plotted with a normal-width, solid line. The synthesized functions are plotted with a thicker, dashed line.

When the Plot Function is FRF, the y-limits can be fixed, in which case subsequent FRFs will be plotted with the current y-limit values. This option can be accessed from the axes context menu or the Display menu for the Verify module.

When the Plot Function is FRF and the complex format is magnitude and phase, there is a context menu on the upper axes y-label ("Phase (deg)") that contains a selection for the "clean phase" option. If "clean phase" is enabled, points where the phase differs by more than 270 degrees from the previous point are not displayed. The "clean phase" option can also be accessed from the Display menu for the Verify module.

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.

Plot Function : Max MIF Order – Select the maximum order of the mode indicator functions that are plotted.

References – Select the FRF references to plot. Use the context menu to select the list attributes and legend info, or to plot drive points or reciprocals.

Responses – Select the FRF responses to plot. Use the context menu to select the list attributes and legend info, find a response, or open the Responses dialog.

Selecting Find Response from the context menu presents an input dialog into which a response coordinate (e.g., 1234X+ or 1234X) or node (e.g., 1234) is entered. Any response with the specified coordinate or node will be found and plotted. The direction sense (i.e., +/−) is not required and if omitted, any response coordinate with the positive or negative sense of the specified direction will be found.

Slide Show – The slide show is an automated means to sequentially plot FRFs by incrementing one response. All of the selected references are plotted. The slide show controls on the toolbar are meant to have similar functionality to the buttons on a DVD player remote control. The slide show can step one response forward or reverse, or play the responses forward or reverse sequentially. In the slide show play mode, the response is automatically incremented on a timed interval. The Slide Show Pause Interval is set in the Preferences dialog.

Tools > Verify > Send Plotted Functions to UIPLOT – Sends the plotted measured and synthesized functions (MIF or FRF) to UIPLOT.

Tools > Verify > Send Plotted Functions to IMAT Plot – Sends the plotted measured and synthesized functions (MIF or FRF) to an IMAT plot figure.

Tools > Verify > Send MIFS to UIPLOT – Computes (if necessary) and sends all MIFs to UIPLOT.

Tools > Verify > Send MIFS to IMAT Plot – Computes (if necessary) and sends the selected MIF to an IMAT plot figure.

Tools > Verify > 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 > Verify > Send Synthesized MIFs to UIPLOT – Computes (if necessary) and sends all MIFs computed from synthesized FRFs to UIPLOT.

Tools > Verify > Send Synthesized MIFs to IMAT Plot – Computes (if necessary) and sends the selected MIF computed from synthesized FRFs to an IMAT plot figure.

Tools > Verify > Send Synthesized MIFs to spVIEW MIFs – Computes (if necessary) and sends the selected MIFs computed from synthesized FRFs 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 > Verify > Send Synthesized FRFs to UIPLOT – Computes (if necessary) and sends the synthesized FRFs to UIPLOT.

Tools > Verify > Send Synthesized FRFs to spVIEW Spectra – Computes (if necessary) and sends the synthesized FRFs to the spVIEW Spectra module. If spVIEW is already running, the functions are sent to this instance of spVIEW, otherwise a new spVIEW is started.

Tools > Verify > Write Synthesized FRFs to AFU File – Writes the synthesized FRF to an AFU file, with the append or replace option as selected. A file selection dialog is presented from which to browse and select the file to write.

Tools > Verify > Write Synthesized FRFs to Workspace – Writes the synthesized FRF to an imat_fn in the MATLAB workspace, with the append or replace option as selected. A variable selection dialog is presented from which to select the imat_fn to write.

Tools > Verify > Write Report Test XML – Writes an XML file (that can be displayed in Excel) that has automated mode shape comparison reporting for modal tests. A file selection dialog is presented from which to browse and select the file to write. The test shapes (from AFPoly), FEM shapes (if available), and TAM (if available) are used to generate posttest matrices (self-MAC, cross-MAC, self-orthogonality and cross-orthogonality), test-analysis comparison tables, and modal parameter summary tables. If FEM shapes and the TAM is not available, only the self-MAC of test shapes is generated. If FEM shapes are available but the TAM is not available, the cross-MAC, MAC comparison table, and summary tables are also generated. If the TAM is available and includes a reduced mass matrix, the self-orthogonality, cross-orthogonality, and orthogonality comparison tables are also generated.

Tools > Verify > Write Shapes Info Structure to CSV File – Writes the contents of the info structure associated with animat_shp that has been written to the MATLAB workspace. The info structure has the same variable name as the imat_shp, but with _info appended. The imat_shp can be written to a shapes file from the MATLAB Command Window using the writeadf function. This tool writes the CSV info file that accompanies the shapes file. A variable selection dialog is presented from which to select the structure to write. A file selection dialog is presented from which to browse and select the corresponding shapes file. The CSV info file has the same filename as the shapes file, but .info.csv is appended to the extension.

Tools > Verify > List Shapes Info – Lists the frequency and damping of the checked poles from the Pole List in a table dialog. The selected table cells can be copied with either Ctrl+C or by right-clicking on the table for a context menu. The contents of the copied cells can then be pasted as tab delimited text.

 

Tools > Verify > Verify Real Shapes – Verifies that real mode shapes will be scaled correctly when written. A warning dialog will be shown if any of the shapes have a positive imaginary driving point residue, which will result in a negative modal mass when the mode shapes are scaled for unity modal mass. The poles for which this condition exists are listed on the dialog and can be marked with x-cursors on the plot axes. This tool is invoked automatically when entering the Verify module when the Shapes Model Method is 'refit' and the Shapes Model Type is 'real'.

Tools > Verify > Cursors at Selected Poles – Adds a black-colored, dashed-line x-cursor at the pole marker for each of the selected poles in the Poles List.