control.root_locus_map

control.root_locus_map(sysdata, gains=None)[source]

Compute the root locus map for an LTI system.

Calculate the root locus by finding the roots of 1 + k * G(s) where G is a linear system and k varies over a range of gains.

Parameters

  • sysdata (LTI system or list of LTI systems) – Linear input/output systems (SISO only, for now).

  • gains (array_like, optional) – Gains to use in computing plot of closed-loop poles. If not given, gains are chosen to include the main features of the root locus map.

Returns

rldata – Root locus data object(s). The loci of the root locus diagram are available in the array rldata.loci, indexed by the gain index and the locus index, and the gains are in the array rldata.gains.

Return type

PoleZeroData or list of PoleZeroData

Notes

For backward compatibility, the rldata return object can be assigned to the tuple roots, gains.