control.phaseplot.vectorfield

control.phaseplot.vectorfield(sys, pointdata, gridspec=None, ax=None, suppress_warnings=False, _check_kwargs=True, **kwargs)[source]

Plot a vector field in the phase plane.

This function plots a vector field for a two-dimensional state space system.

Parameters
sysNonlinearIOSystem or callable(t, x, …)

I/O system or function used to generate phase plane data. If a function is given, the remaining arguments are drawn from the params keyword.

pointdatalist or 2D array

List of the form [xmin, xmax, ymin, ymax] describing the boundaries of the phase plot or an array of shape (N, 2) giving points of at which to plot the vector field.

gridtypestr, optional

The type of grid to use for generating initial conditions: ‘meshgrid’ (default) generates a mesh of initial conditions within the specified boundaries, ‘boxgrid’ generates initial conditions along the edges of the boundary, ‘circlegrid’ generates a circle of initial conditions around each point in point data.

gridspeclist, optional

If the gridtype is ‘meshgrid’ and ‘boxgrid’, gridspec gives the size of the grid in the x and y axes on which to generate points. If gridtype is ‘circlegrid’, then gridspec is a 2-tuple specifying the radius and number of points around each point in the pointdata array.

paramsdict or list, optional

Parameters to pass to system. For an I/O system, params should be a dict of parameters and values. For a callable, params should be dict with key ‘args’ and value given by a tuple (passed to callable).

colormatplotlib color spec, optional

Plot the vector field in the given color.

axmatplotlib.axes.Axes, optional

Use the given axes for the plot, otherwise use the current axes.

Returns
outQuiver
Other Parameters
rcParamsdict

Override the default parameters used for generating plots. Default is set by config.defaults['ctrlplot.rcParams'].

suppress_warningsbool, optional

If set to True, suppress warning messages in generating trajectories.