Parameters ---------- fig : Figure The parent figure. rect : tuple (left, bottom, width, height), default: (0, 0, 1, 1) The ``(left, bottom, width, height)`` Axes position. elev : float, default: 30 The elevation angle in d
(
self, fig, rect=None, *args,
elev=30, azim=-60, roll=0, shareview=None, sharez=None,
proj_type='persp', focal_length=None,
box_aspect=None,
computed_zorder=True,
**kwargs,
)
| 83 | Axes._shared_axes["view"] = cbook.Grouper() |
| 84 | |
| 85 | def __init__( |
| 86 | self, fig, rect=None, *args, |
| 87 | elev=30, azim=-60, roll=0, shareview=None, sharez=None, |
| 88 | proj_type='persp', focal_length=None, |
| 89 | box_aspect=None, |
| 90 | computed_zorder=True, |
| 91 | **kwargs, |
| 92 | ): |
| 93 | """ |
| 94 | Parameters |
| 95 | ---------- |
| 96 | fig : Figure |
| 97 | The parent figure. |
| 98 | rect : tuple (left, bottom, width, height), default: (0, 0, 1, 1) |
| 99 | The ``(left, bottom, width, height)`` Axes position. |
| 100 | elev : float, default: 30 |
| 101 | The elevation angle in degrees rotates the camera above and below |
| 102 | the x-y plane, with a positive angle corresponding to a location |
| 103 | above the plane. |
| 104 | azim : float, default: -60 |
| 105 | The azimuthal angle in degrees rotates the camera about the z axis, |
| 106 | with a positive angle corresponding to a right-handed rotation. In |
| 107 | other words, a positive azimuth rotates the camera about the origin |
| 108 | from its location along the +x axis towards the +y axis. |
| 109 | roll : float, default: 0 |
| 110 | The roll angle in degrees rotates the camera about the viewing |
| 111 | axis. A positive angle spins the camera clockwise, causing the |
| 112 | scene to rotate counter-clockwise. |
| 113 | shareview : Axes3D, optional |
| 114 | Other Axes to share view angles with. Note that it is not possible |
| 115 | to unshare axes. |
| 116 | sharez : Axes3D, optional |
| 117 | Other Axes to share z-limits with. Note that it is not possible to |
| 118 | unshare axes. |
| 119 | proj_type : {'persp', 'ortho'} |
| 120 | The projection type, default 'persp'. |
| 121 | focal_length : float, default: None |
| 122 | For a projection type of 'persp', the focal length of the virtual |
| 123 | camera. Must be > 0. If None, defaults to 1. |
| 124 | For a projection type of 'ortho', must be set to either None |
| 125 | or infinity (numpy.inf). If None, defaults to infinity. |
| 126 | The focal length can be computed from a desired Field Of View via |
| 127 | the equation: focal_length = 1/tan(FOV/2) |
| 128 | box_aspect : 3-tuple of floats, default: None |
| 129 | Changes the physical dimensions of the Axes3D, such that the ratio |
| 130 | of the axis lengths in display units is x:y:z. |
| 131 | If None, defaults to 4:4:3 |
| 132 | computed_zorder : bool, default: True |
| 133 | If True, the draw order is computed based on the average position |
| 134 | along the view direction for supported artist types (currently |
| 135 | Collections and Patches only). |
| 136 | Set to False if you want to manually control the order in which |
| 137 | Artists are drawn on top of each other using their *zorder* |
| 138 | attribute. This can be used for fine-tuning if the automatic order |
| 139 | does not produce the desired result. Note however, that a manual |
| 140 | order will only be correct for a limited view angle. If the figure |
| 141 | is rotated by the user, it will look wrong from certain angles. |
| 142 |
nothing calls this directly
no test coverage detected