mpl_toolkits.mplot3d.axis3d.Axis#

classmpl_toolkits.mplot3d.axis3d.Axis(axes,*,rotate_label=None,**kwargs)[source]#

Bases:XAxis

An Axis class for the 3D plots.

Parameters:

axesAxes

TheAxes to which the created Axis belongs.

pickradiusfloat

The acceptance radius for containment tests. See alsoAxis.contains.

clearbool, default: True

Whether to clear the Axis on creation. This is not required, e.g., whencreating an Axis as part of an Axes, asAxes.clear will callAxis.clear... versionadded:: 3.8

active_pane()[source]#

propertyadir[source]#

[Deprecated]

Notes

Deprecated since version 3.6:

propertyd_interval[source]#

[Deprecated]

Notes

Deprecated since version 3.6:Use get_data_interval instead.

draw(renderer)[source]#

Draw the Artist (and its children) using the given renderer.

This has no effect if the artist is not visible (Artist.get_visiblereturns False).

Parameters:

rendererRendererBase subclass.

Notes

This method is overridden in the Artist subclasses.

draw_grid(renderer)[source]#

draw_pane(renderer)[source]#

Draw pane.

Parameters:

rendererRendererBase subclass

get_label_position()[source]#

Get the label position.

Returns:

str{'lower', 'upper', 'both', 'default', 'none'}

The position of the axis label.

get_major_ticks(numticks=None)[source]#

Return the list of majorTicks.

Warning

Ticks are not guaranteed to be persistent. Various operationscan create, delete and modify the Tick instances. There is animminent risk that changes to individual ticks will notsurvive if you work on the figure further (including alsopanning/zooming on a displayed figure).

Working on the individual ticks is a method of last resort.Useset_tick_params instead if possible.

get_minor_ticks(numticks=None)[source]#

Return the list of minorTicks.

Warning

Ticks are not guaranteed to be persistent. Various operationscan create, delete and modify the Tick instances. There is animminent risk that changes to individual ticks will notsurvive if you work on the figure further (including alsopanning/zooming on a displayed figure).

Working on the individual ticks is a method of last resort.Useset_tick_params instead if possible.

get_rotate_label(text)[source]#

get_ticks_position()[source]#

Get the ticks position.

Returns:

str{'lower', 'upper', 'both', 'default', 'none'}

The position of the bolded axis lines, ticks, and tick labels.

get_tightbbox(renderer=None,*,for_layout_only=False)[source]#

Return a bounding box that encloses the axis. It only accountstick labels, axis label, and offsetText.

Iffor_layout_only is True, then the width of the label (if thisis an x-axis) or the height of the label (if this is a y-axis) iscollapsed to near zero. This allows tight/constrained_layout to ignoretoo-long labels when doing their layout.

init3d()[source]#

[Deprecated]

Notes

Deprecated since version 3.6:

set(*,agg_filter=<UNSET>,alpha=<UNSET>,animated=<UNSET>,clip_box=<UNSET>,clip_on=<UNSET>,clip_path=<UNSET>,converter=<UNSET>,data_interval=<UNSET>,gid=<UNSET>,in_layout=<UNSET>,inverted=<UNSET>,label=<UNSET>,label_coords=<UNSET>,label_position=<UNSET>,label_text=<UNSET>,major_formatter=<UNSET>,major_locator=<UNSET>,minor_formatter=<UNSET>,minor_locator=<UNSET>,mouseover=<UNSET>,pane_color=<UNSET>,path_effects=<UNSET>,picker=<UNSET>,pickradius=<UNSET>,rasterized=<UNSET>,remove_overlapping_locs=<UNSET>,rotate_label=<UNSET>,sketch_params=<UNSET>,snap=<UNSET>,tick_params=<UNSET>,ticklabels=<UNSET>,ticks=<UNSET>,ticks_position=<UNSET>,transform=<UNSET>,units=<UNSET>,url=<UNSET>,view_interval=<UNSET>,visible=<UNSET>,zorder=<UNSET>)[source]#

Set multiple properties at once.

Supported properties are

Property	Description
agg_filter	a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image
alpha	float or None
animated	bool
clip_box	BboxBase or None
clip_on	bool
clip_path	Patch or (Path, Transform) or None
converter	ConversionInterface
data_interval	unknown
figure	Figure orSubFigure
gid	str
in_layout	bool
inverted	unknown
label	unknown
label_coords	unknown
label_position	{'lower', 'upper', 'both', 'default', 'none'}
label_text	str
major_formatter	Formatter,str, or function
major_locator	Locator
minor_formatter	Formatter,str, or function
minor_locator	Locator
mouseover	bool
pane_color	color
path_effects	list ofAbstractPathEffect
picker	None or bool or float or callable
pickradius	float
rasterized	bool
remove_overlapping_locs	unknown
rotate_label	unknown
sketch_params	(scale: float, length: float, randomness: float)
snap	bool or None
tick_params	unknown
ticklabels	sequence of str or ofTexts
ticks	1D array-like
ticks_position	{'lower', 'upper', 'both', 'default', 'none'}
transform	Transform
units	units tag
url	str
view_interval	unknown
visible	bool
zorder	float

set_label_position(position)[source]#

Set the label position.

Parameters:

position{'lower', 'upper', 'both', 'default', 'none'}

The position of the axis label.

set_pane_color(color,alpha=None)[source]#

Set pane color.

Parameters:

colorcolor

Color for axis pane.

alphafloat, optional

Alpha value for axis pane. If None, base it oncolor.

set_rotate_label(val)[source]#

Whether to rotate the axis label: True, False or None.If set to None the label will be rotated if longer than 4 chars.

set_ticks_position(position)[source]#

Set the ticks position.

Parameters:

position{'lower', 'upper', 'both', 'default', 'none'}

The position of the bolded axis lines, ticks, and tick labels.

propertyv_interval[source]#

[Deprecated]

Notes

Deprecated since version 3.6:Use get_view_interval instead.