sysplot.plot_bode#

plot_bode(mag, phase, omega, axes=None, label=None, mag_to_dB=True, minor_ticks=True, tick_denominator=4, tick_numerator=1, x_to_log=True, phase_is_rad=True, **kwargs)[source]#

Plot a two-panel Bode magnitude and phase diagram.

Creates magnitude and phase subplots from frequency response arrays. Phase is unwrapped with numpy.unwrap for continuous display across ±π boundaries and labelled as multiples of π-fractions when phase_is_rad=True.

Note

To show phase in degrees, pass np.degrees(phase) and set phase_is_rad=False.

Parameters:

mag – Magnitude response values |H(jω)|.
phase – Phase response in radians (or degrees when phase_is_rad=False).
omega – Frequency vector in rad/s.
axes (Axes | Sequence[Axes] | ndarray | None) – Two Axes for [magnitude, phase] subplots. If None, creates a new 1×2 figure.
label (str | None) – Legend label for both subplots.
mag_to_dB (bool) – If True, plots magnitude in dB (20·log₁₀).
minor_ticks (bool) – If True, adds log-scale minor ticks to the frequency axis.
tick_denominator (int) – Denominator for π-based phase tick fractions (e.g., 4 gives π/4 increments). Default is 4.
tick_numerator (int) – Numerator for π-based phase tick fractions. Default is 1.
x_to_log (bool) – If True, uses a logarithmic frequency axis.
phase_is_rad (bool) – If True, labels the phase axis in multiples of π. If False, the axis uses default numeric labels.
**kwargs –
Additional keyword arguments forwarded to matplotlib.axes.Axes.plot() for both magnitude and phase curves.

If color or linestyle are not provided, they are taken from the active sysplot style cycler. Passing either key in kwargs overrides the cycler value for both subplots.

Return type: