Create a 3D stem plot. A stem plot draws lines perpendicular to a baseline, and places markers at the heads. By default, the baseline is defined by *x* and *y*, and stems are drawn vertically from *bottom* to *z*. Parameters ---------- x, y,
(self, x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-',
bottom=0, label=None, orientation='z', axlim_clip=False)
| 4175 | |
| 4176 | @_preprocess_data() |
| 4177 | def stem(self, x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', |
| 4178 | bottom=0, label=None, orientation='z', axlim_clip=False): |
| 4179 | """ |
| 4180 | Create a 3D stem plot. |
| 4181 | |
| 4182 | A stem plot draws lines perpendicular to a baseline, and places markers |
| 4183 | at the heads. By default, the baseline is defined by *x* and *y*, and |
| 4184 | stems are drawn vertically from *bottom* to *z*. |
| 4185 | |
| 4186 | Parameters |
| 4187 | ---------- |
| 4188 | x, y, z : array-like |
| 4189 | The positions of the heads of the stems. The stems are drawn along |
| 4190 | the *orientation*-direction from the baseline at *bottom* (in the |
| 4191 | *orientation*-coordinate) to the heads. By default, the *x* and *y* |
| 4192 | positions are used for the baseline and *z* for the head position, |
| 4193 | but this can be changed by *orientation*. |
| 4194 | |
| 4195 | linefmt : str, default: 'C0-' |
| 4196 | A string defining the properties of the vertical lines. Usually, |
| 4197 | this will be a color or a color and a linestyle: |
| 4198 | |
| 4199 | ========= ============= |
| 4200 | Character Line Style |
| 4201 | ========= ============= |
| 4202 | ``'-'`` solid line |
| 4203 | ``'--'`` dashed line |
| 4204 | ``'-.'`` dash-dot line |
| 4205 | ``':'`` dotted line |
| 4206 | ========= ============= |
| 4207 | |
| 4208 | Note: While it is technically possible to specify valid formats |
| 4209 | other than color or color and linestyle (e.g. 'rx' or '-.'), this |
| 4210 | is beyond the intention of the method and will most likely not |
| 4211 | result in a reasonable plot. |
| 4212 | |
| 4213 | markerfmt : str, default: 'C0o' |
| 4214 | A string defining the properties of the markers at the stem heads. |
| 4215 | |
| 4216 | basefmt : str, default: 'C3-' |
| 4217 | A format string defining the properties of the baseline. |
| 4218 | |
| 4219 | bottom : float, default: 0 |
| 4220 | The position of the baseline, in *orientation*-coordinates. |
| 4221 | |
| 4222 | label : str, optional |
| 4223 | The label to use for the stems in legends. |
| 4224 | |
| 4225 | orientation : {'x', 'y', 'z'}, default: 'z' |
| 4226 | The direction along which stems are drawn. |
| 4227 | |
| 4228 | axlim_clip : bool, default: False |
| 4229 | Whether to hide stems that are outside the axes limits. |
| 4230 | |
| 4231 | .. versionadded:: 3.10 |
| 4232 | |
| 4233 | data : indexable object, optional |
| 4234 | DATA_PARAMETER_PLACEHOLDER |