impedanceScanBodePlot

Create Bode plot from output data of Impedance Scan (Three-Phase) block

Since R2026a

collapse all in page

Syntax

impedanceScanBodePlot(Data)
H = impedanceScanBodePlot(Data)

Description

impedanceScanBodePlot(Data) generates Bode plots of impedance or admittance along the D and Q axes from the perturbed voltage or current measurements stored in the Data structure. The data port of the Impedance Scan (Three-Phase) block outputs a structure with the correct fields. To plot the magnitude and phase of the impedance or admittance as functions of frequency, store the signal from this port in a variable and use the variable as the Data argument.

For shunt current injections, the function generates Bode plots of the impedance Z. For series voltage injections, the function generates Bode plots of the admittance Y.

Example: If you connect the data port of the Impedance Scan (Three-Phase) block to a To Workspace block and use the default value of the Variable name parameter, impedanceScanBodePlot(out.simout) generates Bode plots from your impedance or admittance scan simulation results.

H = impedanceScanBodePlot(Data) returns a structure H that contains complex values of impedance or admittance along the D and Q axes and the corresponding frequencies.

Input Arguments

collapse all

Perturbed voltage or current measurements, specified as a structure with the same fields as the signal from the data of the Impedance Scan (Three-Phase) block:

  • DD — Voltage and current measurements along the D-axis for a disturbance injection along the D-axis, in volts and amps respectively, specified as a structure.

  • DQ — Voltage and current measurements along the Q-axis for a disturbance injection along the D-axis, in volts and amps respectively, specified as a structure.

  • QD — Voltage and current measurements along the D-axis for a disturbance injection along the Q-axis, in volts and amps respectively, specified as a structure.

  • QQ — Voltage and current measurements along the Q-axis for a disturbance injection along the Q-axis, in volts and amps respectively, specified as a structure.

  • Dd — Per-unit amplitude of the disturbance along the D-axis, specified as a time series. The value of the Data property of this time series is equal to the value of the Disturbance amplitude along D-axis (pu) parameter of the Impedance Scan (Three-Phase) block.

  • Dq — Per-unit amplitude of the disturbance along the Q-axis, specified as a time series. The value of the Data property of this time series is equal to the value of the Disturbance amplitude along Q-axis (pu) parameter of the Impedance Scan (Three-Phase) block.

  • Tstart — Time at which the disturbance injection starts in seconds, specified as a time series. The value of the Data property of this time series is equal to the value of the Disturbance injection start time (s) parameter of the Impedance Scan (Three-Phase) block.

  • Tend — Time at which the disturbance injection ends in seconds, specified as a time series. The value of the Data property of this time series is equal to the value of the Disturbance injection end time (s) parameter of the Impedance Scan (Three-Phase) block.

  • f — Frequencies at which the block calculates the frequency response in hertz, specified as a time series. The value of the Data property of this time series is equal to the value of the Disturbance frequency vector (Hz) parameter of the Impedance Scan (Three-Phase) block.

  • scan — Type of disturbance injected, specified as a time series. The value of the Data property of this time series is 0 for a sinestream injection and 1 for a pseudorandom binary sequence (PRBS) injection. This value corresponds to the Disturbance parameter of the Impedance Scan (Three-Phase) block.

Output Arguments

collapse all

Frequency spectrum data from the impedance or admittance scan test, returned as a structure with these fields:

Impedance or admittance measurements for a disturbance along the D-axis, returned as a structure with these fields:

  • DD — Impedance or admittance measurements along the D-axis, in ohms or siemens respectively, returned as a complex double.

  • DQ — Impedance or admittance measurements along the Q-axis, in ohms or siemens respectively, returned as a complex double.

The H argument contains the D field if the per-unit amplitude of the disturbance along the D-axis is greater than 1e-6.

Impedance or admittance measurements for a disturbance along the Q-axis, returned as a structure with these fields:

  • QD — Impedance or admittance measurements along the D-axis, in ohms or siemens respectively, returned as a complex double.

  • QQ — Impedance or admittance measurements along the Q-axis, in ohms or siemens respectively, returned as a complex double.

The H argument contains the Q field if the per-unit amplitude of the disturbance along the Q-axis is greater than 1e-6.

Frequencies corresponding to the impedance or admittance values specified in the D and Q structures, returned as a 1-D table.

Version History

Introduced in R2026a

See Also

Blocks

Teaching Resources