Use the Diagnostic Viewer to analyze the results of your frequency response estimation, obtained by performing the steps in Estimate Frequency Response Using Linear Analysis Tool.
To open the Diagnostic Viewer when estimating a model in the Linear Analysis Tool:
Before performing the estimation task, in the Estimation tab, select the Diagnostic Viewer check box.
This action sets the Diagnostic Viewer to open when the frequency response estimation is performed.
In the Estimate section, select your desired plot option to estimate the frequency response of the model. The Diagnostic Viewer appears in the plot pane.
To open the Diagnostic Viewer to view a previously estimated model in the Linear Analysis Tool:
In the Linear Analysis Workspace, select the estimated model.
In the Plots and Results tab, select the Diagnostic Viewer.
Note: This option is only available for models that have been previously estimated with the Diagnostic Viewer check box selected. |
Use the Simulation Results Viewer to analyze the results of your frequency response estimation, obtained by performing the steps in Estimate Frequency Response at the Command Line.
Open the Simulation Results Viewer using the frest.simView
command:
frest.simView(simout,input,sysest)
where simout
is the simulated output, input
is
the input signal you created, and sysest
is the
estimated frequency response.
By default, the Diagnostic Viewer shows these plots:
Frequency Response
Time Response (Simulated Output)
FFT of Time Response
To select the plots displayed in the Diagnostic Viewer using the Linear Analysis Tool:
If the Diagnostic Viewer tab is not visible, in the Plots and Results tab, select the Diagnostic Viewer plot.
In the Diagnostic Viewer tab, in the Plot Visibilities section, select the check boxes for the plots that you want to view.
To modify plot settings, such as axis frequency units, right-click on a plot, and select the corresponding option.
By default, the Simulation Results Viewer shows these plots:
Frequency Response
Time Response (Simulated Output)
FFT of Time Response
To select the plots displayed in the Simulation Results Viewer, choose the corresponding plot from the Edit > Plots menu. To modify plot settings, such as axis frequency units, right-click a plot, and select the corresponding option.
Use the Bode plot to analyze the frequency response. If the frequency response does not match the dynamics of your system, see Troubleshooting Frequency Response Estimation for information about possible causes and solutions. While troubleshooting, you can use the Bode plot controls to view the time response at the problematic frequencies.
You can usually improve estimation results by either modifying your input signal or disabling the model blocks that drive your system away from the operating point, and repeating the estimation.
Use this plot to check whether the simulated output is at steady state at specific frequencies. If the response has not reached steady state, see Time Response Not at Steady State for possible causes and solutions.
If you used the sinestream input for estimation, check both the filtered and the unfiltered time response. You can toggle the display of filtered and unfiltered output by right-clicking the plot and selecting Show filtered steady state output only. If both the filtered and unfiltered response appear at steady state, then your model must be at steady state. You can explore other possible causes in Troubleshooting Frequency Response Estimation.
Note: If you used the sinestream input for estimation, toggling the filtered and unfiltered display only updates the Time Response and FFT plots. This selection does not change the estimation results. For more information about filtering during estimation, see How Frequency Response Estimation Treats Sinestream Inputs. |
Use this plot to analyze the spectrum of the simulated output.
For example, you can use the spectrum to identify strong nonlinearities. When the FFT plot shows large amplitudes at frequencies other than the input signal, your model is operating outside of linear range. If you are interested in analyzing the linear response of your system for small perturbations, explore possible solutions in FFT Contains Large Harmonics at Frequencies Other than the Input Signal Frequency.
Use the controls in the Diagnostic Viewer tab of the Linear Analysis Tool to analyze the estimation results at specific frequencies.
If the Diagnostic Viewer tab is not visible, in the Plots and Results tab, select the Diagnostic Viewer plot.
In the Diagnostic Viewer tab, in the Frequency Selector section, specify the frequency range that you want to inspect. Use the frequency units used in the Bode plot in the Diagnostic Viewer.
In the Simulation Results Viewer, use the Bode controls to display the simulated output and its spectrum at specific frequencies.
Drag the arrows individually to display the time response and FFT at specific frequencies.
Drag the shaded region to shift the time response and FFT to a different frequency range.
You can display a data tip on the Time Response, FFT, and Bode plots in the Simulation Results Viewer by clicking the corresponding curve. Dragging the data tip updates the information.
Data tips are useful for correcting poor estimation results at a specific sinestream frequency, which requires you to modify the input at a specific frequency. You can use the data tip to identify the frequency index where the response does not match your system.
In the previous figure, the Time Response data tip shows that
the frequency index is 11. You can use this frequency index to modify
the corresponding portion of the input signal. For example, to modify
the NumPeriods
and SettlingPeriods
properties
of the sinestream signal, using MATLAB^{®} code:
input.NumPeriods(11) = 80; input.SettlingPeriods(11) = 75;
To modify the sinestream in the Linear Analysis Tool, see Modify Sinestream Signal Using Linear Analysis Tool
For MIMO systems, view frequency response information for specific input and output channels:
In both the Diagnostic Viewer and Simulation Results Viewer, right-click any plot, and select I/O Selector.
Choose the input channel in the From list and the output channel in the To list.