Calculate natural frequencies, damping ratios and poles.
If no output is specified, display overview table containing poles, magnitude (if sys is a discrete-time model), damping ratios, natural frequencies and time constants.
Inputs
LTI model.
Outputs
Natural frequencies of each pole of sys (in increasing order). The frequency unit is rad/s (radians per second). If sys is a discrete-time model with specified sample time, Wn contains the natural frequencies of the equivalent continuous-time poles (see Algorithms). If sys has an unspecified sample time (tsam = -1), tsam = 1 is used to calculate Wn.
Damping ratios of each pole of sys (in the same order as Wn). If sys is a discrete-time model with specified sample time, zeta contains the damping ratios of the equivalent continuous-time poles (see Algorithms). If sys has an unspecified sample time (tsam = -1), tsam = 1 is used to calculate zeta.
Poles of sys (in the same order as Wn).
Algorithm
Poles s (or z for discrete-time models) are calculated via pole
and resorted in order of increasing natural frequency.
s = log (z) / sys.tsam (discrete-time models only)
mag = abs (z) (discrete-time models only)
Wn = abs (s)
zeta = -cos (arg (s))
tau = 1 / (Wn * zeta)
See also: dsort, eig, esort, pole, pzmap, zero.
Package: control