control.matlab.margin¶
- control.matlab.margin(sysdata)[source]¶
Calculate gain and phase margins and associated crossover frequencies
- Parameters
sysdata (LTI system or (mag, phase, omega) sequence) –
- sysStateSpace or TransferFunction
Linear SISO system representing the loop transfer function
- mag, phase, omegasequence of array_like
Input magnitude, phase (in deg.), and frequencies (rad/sec) from bode frequency response data
- Returns
gm (float) – Gain margin
pm (float) – Phase margin (in degrees)
wcg (float or array_like) – Crossover frequency associated with gain margin (phase crossover frequency), where phase crosses below -180 degrees.
wcp (float or array_like) – Crossover frequency associated with phase margin (gain crossover frequency), where gain crosses below 1.
Margins are calculated for a SISO open-loop system.
If there is more than one gain crossover, the one at the smallest margin
(deviation from gain = 1), in absolute sense, is returned. Likewise the
smallest phase margin (in absolute sense) is returned.
Examples
>>> sys = tf(1, [1, 2, 1, 0]) >>> gm, pm, wcg, wcp = margin(sys)