control_plotly.nichols

control_plotly.nichols(sys_list, w=None, x_lim=None, y_lim=None, cm=array([6.0, 3.0, 1.0, 0.5, 0.25, 0.0, - 1.0, - 3.0, - 6.0, - 12.0, - 20.0, - 40.0]), cp=array([1, 5, 10, 20, 30, 50, 90, 120, 150, 180]), show_grid=True, show_mag=True, show_phase=True)

Returns the nichols chart of the continuous or discrete-time systems sys_list.

Parameters

  • sys_list (system or list of systems) – A single system or a list of systems to analyse

  • w (numpy vector (optional)) – The base angular frequency vector (in rad/s)

  • x_lim (list (optional)) – A list of two element that defines the min and max value for the x axis

  • y_lim (list (optional)) – A list of two element that defines the min and max value for the y axis

  • cm (numpy vector (optional)) – A numpy vector containing the list of contour gain (in dB)

  • cp (numpy vector (optional)) – A numpy vector containing the list of contour phase (in deg)

  • show_grid (boolean (optional)) – Add the nichols grid

  • show_mag (boolean (optional)) – Show the nichols magnitude grid

  • show_phase (boolean (optional)) – Show the nichols phase grid

Returns

fig – A plotly figure

Return type

plotly figure

Example

import control as ctl
from control_plotly import nichols

sys1 = ctl.tf([1],[2,1,1])
sys2 = ctl.tf([1],[1,0.5,1])

nichols([sys1,sys2])
alternate text 
import control as ctl
import numpy as np
from control_plotly import nichols

sys = ctl.tf([1],[2,1,1])

nichols(sys,show_phase=False,cm=np.array([0.5,-6]),x_lim=[-200,0],y_lim=[-40,10])
alternate text