fill

named_arrays.plt.fill(*args, ax=None, axis=None, where=True, transformation=None, components=None, **kwargs)

Plot filled polygons

This is a thin wrapper around matplotlib.axes.Axes.fill() for named arrays.

The main difference of this function from matplotlib.pyplot.fill() is the addition of the axis parameter indicating along which axis the lines should be connected.

Parameters:

• args (AbstractArray) – Same signature as matplotlib.axes.Axes.fill(). If ax is a 2D plot, *args should be x, y. If ax is a 3D plot, *args should be x, y, z.

• ax (None | Axes | ScalarArray[ndarray[tuple[Any, ...], dtype[_ScalarT]]]) – The instances of matplotlib.axes.Axes to use. If None, calls matplotlib.pyplot.gca() to get the current axes. If an instance of named_arrays.ScalarArray, ax.shape should be a subset of the broadcasted shape of *args.

• axis (None | str) – The name of the axis that the plot lines should be connected along. If None, the broadcasted shape of args should have only one element, otherwise a ValueError is raised.

• where (bool | AbstractScalar) – A boolean array that selects which elements to plot

• transformation (None | AbstractTransformation) – A callable that is applied to args before plotting

• components (None | tuple[str, ...]) – The component names of *args to plot, helpful if *args are an instance of named_arrays.AbstractVectorArray.

• kwargs – Additional keyword arguments passed to matplotlib.axes.Axes.fill(). These can be instances of named_arrays.AbstractArray.

Return type:

ScalarArray[ndarray[tuple[Any, …], dtype[_ScalarT]]]