Multitone Analysis
Purpose
Perform a multitone analysis
Library
PLECS Extras / Analysis Tools
Description
The Multitone Analysis block enables you to determine the transfer function of a generic system from a single input to one or more outputs. The analysis is performed by injecting a small multitone signal containing different frequencies into the system and extracting the same frequencies from the system output(s) by Fourier analysis. The perturbation signal is available at the block output. The system outputs to be analyzed must be fed into the block's input port.
A multitone analysis can be started either by clicking the button Start analysis or with the MATLAB command
plmultitone(block);
where block is the Simulink handle or the full block path of the Multitone Analysis block. The block handle or path can be followed by parameter/value pairs that override the settings in the dialog box.
For additional information see section Multitone Analysis.
Parameters
- Frequency range
- A vector containing the lowest and highest perturbation frequency.
- Amplitude
- The amplitude of the perturbation signal.
- Init. simulation period
- The duration of an initial simulation performed before the response is measured. It is assumed that during this period, the system reaches its steady state. The total simulation duration will be the sum of this parameter and one period of the base frequency signal.
- Output variable
- The name of a MATLAB variable used to store the transfer function at the end of an analysis. If the analysis was run interactively from the GUI, the variable is assigned in the MATLAB base workspace. If the analysis was run with the plmultitone command, the variable is assigned in the caller's workspace.
- Plot bode diagram
- Specifies whether to plot the transfer function in a bode diagram.
- Display level
- Specifies the level of detail of the diagnostic messages displayed in the command window (iteration, final, off).