yt.raven.PlotCollectionInteractive.add_slice

PlotCollectionInteractive.add_slice(*args, **kwargs)

Create a slice, from that a slice plot, and add it to the current collection.

This function will generate a yt.lagos.AMRSliceBase from the given parameters. This slice then gets passed to a yt.raven.SlicePlot, and the resultant plot is added to the current collection. Various parameters allow control of the way the slice is displayed, as well as how the slice is generated.

Parameters :

field : string

The initial field to slice and display.

axis : int

The axis along which to slice. Can be 0, 1, or 2 for x, y, z.

coord : float, optional

The coordinate to place the slice at, along the slicing axis.

center : array_like, optional

The center to be used for things like radius and radial velocity. Defaults to the center of the plot collection.

use_colorbar : bool, optional

Whether we should leave room for and create a colorbar.

figure : matplotlib.figure.Figure, optional

The figure onto which the axes will be placed. Typically not used unless axes is also specified.

axes : matplotlib.axes.Axes, optional

The axes object which will be used to create the image plot. Typically used for things like multiplots and the like.

fig_size : tuple of floats

This parameter can act as a proxy for the manual creation of a figure. By specifying it, you can create plots with an arbitrarily large or small size. It is in inches, defaulting to 100 dpi.

periodic : boolean, optional

By default, the slices are assumed to be periodic, and they will wrap around the edges.

obj : yt.lagos.AMRSliceBase, optional

If you would like to use an existing slice, you may specify it here, in which case a new slice will not be created.

field_parameters : dict, optional

This set of parameters will be passed to the slice upon creation, which can be used for passing variables to derived fields.

Returns :

plot : yt.raven.SlicePlot

The plot that has been added to the PlotCollection.

See also

yt.lagos.AMRSliceBase
This is the type created by this function and passed to the plot created here.

Notes

This is the primary mechanism for creating slice plots, and generating slice plots along multiple axes was the original purpose of the PlotCollection.

Note that all plots can be modified. See callback_list for more information.

Examples

>>> pf = load("RD0005-mine/RedshiftOutput0005")
>>> pc = PlotCollection(pf, [0.5, 0.5, 0.5])
>>> p = pc.add_slice("Density", 0)

This Page