control.nichols_grid

control.nichols_grid(cl_mags=None, cl_phases=None, line_style='dotted', ax=None, label_cl_phases=True)[source]

Plot Nichols chart grid.

Plots a Nichols chart grid on the current axes, or creates a new chart if no plot already exists.

Parameters
cl_magsarray_like (dB), optional

Array of closed-loop magnitudes defining the iso-gain lines on a custom Nichols chart.

cl_phasesarray_like (degrees), optional

Array of closed-loop phases defining the iso-phase lines on a custom Nichols chart. Must be in the range -360 < cl_phases < 0

line_stylestring, optional

Matplotlib linestyle.

axmatplotlib.axes.Axes, optional

Axes to add grid to. If None, use matplotlib.pyplot.gca.

label_cl_phasesbool, optional

If True, closed-loop phase lines will be labeled.

Returns
cl_mag_lineslist of matplotlib.line.Line2D

The constant closed-loop gain contours.

cl_phase_lineslist of matplotlib.line.Line2D

The constant closed-loop phase contours.

cl_mag_labelslist of matplotlib.text.Text

Magnitude contour labels; each entry corresponds to the respective entry in cl_mag_lines.

cl_phase_labelslist of matplotlib.text.Text

Phase contour labels; each entry corresponds to the respective entry in cl_phase_lines.