control.matlab.damp

control.matlab.damp(sys, doprint=True)[source]

Compute system’s natural frequencies, damping ratios, and poles.

Parameters:

sysStateSpace or TransferFunction: A linear system object.
doprintbool (optional): If True, print table with values.

Returns:

wnarray: Natural frequency for each system pole.
zetaarray: Damping ratio for each system pole.
polesarray: System pole locations.

See also

poles

Notes

If the system is continuous

wn = abs(poles)

zeta = -real(poles)/poles

If the system is discrete, the discrete poles are mapped to their equivalent location in the s-plane via

s = log(poles)/dt

and

wn = abs(s)

zeta = -real(s)/wn

Examples

>>> G = ct.tf([1], [1, 4])
>>> wn, zeta, poles = ct.damp(G)
    Eigenvalue (pole)       Damping     Frequency
                   -4             1             4