mpl_toolkits.mplot3d.axes3d.Axes3D

clase mpl_toolkits.mplot3d.axes3d. Axes3D ( fig , rect = Ninguno , * args , elev = 30 , azim = -60 , roll = 0 , sharez = Ninguno , proj_type = 'persp' , box_aspect = Ninguno , computed_zorder = True , focal_length = Ninguno , ** kwargs )

Bases:Axes

Objeto de ejes 3D.

Parámetros :

figura de higo

La figura paterna.

tupla recta (izquierda, abajo, ancho, alto), por defecto: Ninguno.

La posición de los ejes.(left, bottom, width, height)

elev float, por defecto: 30

El ángulo de elevación en grados gira la cámara por encima y por debajo del plano xy, con un ángulo positivo correspondiente a una ubicación por encima del plano.

flotante azim , predeterminado: -60

El ángulo azimutal en grados gira la cámara sobre el eje z, con un ángulo positivo correspondiente a una rotación hacia la derecha. En otras palabras, un acimut positivo gira la cámara alrededor del origen desde su ubicación a lo largo del eje +x hacia el eje +y.

rollo flotante, por defecto: 0

El ángulo de balanceo en grados gira la cámara sobre el eje de visualización. Un ángulo positivo hace girar la cámara en el sentido de las agujas del reloj, lo que hace que la escena gire en el sentido contrario a las agujas del reloj.

sharez Axes3D, opcional

Otros ejes con los que compartir límites z.

proj_type {'persp', 'orto'}

El tipo de proyección, por defecto 'persp'.

box_aspect 3 tuplas de flotantes, predeterminado: Ninguno

Cambia las dimensiones físicas de Axes3D, de modo que la proporción de las longitudes de los ejes en unidades de visualización es x:y:z. Si no hay ninguno, el valor predeterminado es 4:4:3

booleano computado_zorder , predeterminado: Verdadero

Si es True, el orden de dibujo se calcula en función de la posición promedio de las Artists a lo largo de la dirección de la vista. Establézcalo en Falso si desea controlar manualmente el orden en que los artistas se dibujan uno encima del otro usando su atributo zorder . Esto se puede utilizar para el ajuste fino si el pedido automático no produce el resultado deseado. Sin embargo, tenga en cuenta que un zorder manual solo será correcto para un ángulo de visión limitado. Si el usuario gira la figura, se verá mal desde ciertos ángulos.

auto_add_to_figure bool, predeterminado: Falso

Antes de Matplotlib 3.4, Axes3D se agregaría a su figura de host en init. Otras clases de ejes no hacen esto.

Este comportamiento está en desuso en 3.4, el valor predeterminado se cambia a Falso en 3.6. La palabra clave no estará documentada y un valor que no sea Falso será un error en 3.7.

focal_length flotante, predeterminado: Ninguno

Para un tipo de proyección de 'persp', la distancia focal de la cámara virtual. Debe ser > 0. Si es Ninguno, el valor predeterminado es 1. Para un tipo de proyección de 'orto', debe establecerse en Ninguno o infinito (numpy.inf). Si es Ninguno, el valor predeterminado es infinito. La distancia focal se puede calcular a partir de un campo de visión deseado mediante la ecuación: longitud_focal = 1/bronceado(FOV/2)

**kwargs

Otros argumentos de palabras clave opcionales:

Propiedad	Descripción
adjustable	{'caja', 'límite de datos'}
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
anchor	(flotante, flotante) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'igual', 'igualxy', 'igualxz', 'igualz'}
autoscale_on	bool
autoscalex_on	desconocido
autoscaley_on	desconocido
autoscalez_on	desconocido
axes_locator	Invocable[[Ejes, Renderer], Bbox]
axisbelow	bool o 'línea'
box_aspect	3 tuplas de flotantes o Ninguno
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
facecoloro FC	color
figure	Figure
frame_on	bool
gid	calle
in_layout	bool
label	objeto
mouseover	bool
navigate	bool
navigate_mode	desconocido
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	[izquierda, abajo, ancho, alto] oBbox
proj_type	{'persp', 'orto'}
prop_cycle	desconocido
rasterization_zorder	flotante o Ninguno
rasterized	bool
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
title	desconocido
transform	Transform
url	calle
visible	bool
xbound	desconocido
xlabel	calle
xlimo xlim3d	(abajo: flotador, arriba: flotador)
xlim3d	(abajo: flotador, arriba: flotador)
xmargin	flotante mayor que -0.5
xscale	desconocido
xticklabels	desconocido
xticks	desconocido
ybound	desconocido
ylabel	calle
ylimo ylim3d	(abajo: flotador, arriba: flotador)
ylim3d	(abajo: flotador, arriba: flotador)
ymargin	flotante mayor que -0.5
yscale	desconocido
yticklabels	desconocido
yticks	desconocido
zbound	desconocido
zlabel	desconocido
zlimo zlim3d	desconocido
zmargin	flotante mayor que -0.5
zorder	flotar
zscale	desconocido
zticklabels	desconocido
zticks	desconocido

add_collection3d ( col , zs = 0 , zdir = 'z' )

Agregue un objeto de colección 3D a la trama.

Los tipos de colección 2D se convierten a una versión 3D modificando el objeto y agregando información de coordenadas z.

Se admiten:

• PolyCollection

• LineCollection

• Colección de parches

add_contour_set ( cset , extend3d = False , stride = 5 , zdir = 'z' , offset = None )

add_contourf_set ( cset , zdir = 'z' , offset = Ninguno )

apply_aspect ( posición = Ninguno )

Ajuste los ejes para una relación de aspecto de datos específica.

En función de get_adjustableesto se modificará o bien el cuadro de Ejes (posición) o bien los límites de la vista. En el primer caso, get_anchorafectará al cargo.

Parámetros :

posición Ninguno o .Bbox

Si no None, esto define la posición de los Ejes dentro de la figura como un Bbox. Ver get_position para más detalles.

Ver también

matplotlib.axes.Axes.set_aspect

Para obtener una descripción del manejo de la relación de aspecto.

matplotlib.axes.Axes.set_adjustable

Establezca cómo se ajustan los ejes para lograr la relación de aspecto requerida.

matplotlib.axes.Axes.set_anchor

Establezca la posición en caso de espacio adicional.

notas

Esto se llama automáticamente cuando se dibuja cada eje. Es posible que deba llamarlo usted mismo si necesita actualizar la posición de los ejes y/o ver los límites antes de dibujar la figura.

auto_scale_xyz ( X , Y , Z = Ninguno , had_data = Ninguno )

escala automática ( habilitar = Verdadero , eje = 'ambos' , apretado = Ninguno )

Método de conveniencia para escalado automático de vista de eje simple.

Ver Axes.autoscalepara la documentación completa. Debido a que esta función se aplica a los ejes 3D, el eje también se puede configurar en 'z', y al establecer el eje en 'ambos', los tres ejes se escalan automáticamente.

autoscale_view ( apretado = Ninguno , scalex = Verdadero , scaley = Verdadero , scalez = Verdadero )

Escale automáticamente los límites de vista utilizando los límites de datos.

Ver Axes.autoscale_viewpara la documentación completa. Debido a que esta función se aplica a los ejes 3D, también toma un argumento scalez .

bar ( izquierda , altura , zs = 0 , zdir = 'z' , * argumentos , datos = Ninguno , ** kwargs )

Agregar barra(s) 2D.

Parámetros :

como una matriz 1D izquierda

Las coordenadas x de los lados izquierdos de las barras.

altura 1D tipo matriz

La altura de las barras.

zs float o tipo matriz 1D

Coordenada Z de barras; si se especifica un solo valor, se utilizará para todas las barras.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

Al trazar datos 2D, la dirección a usar como z ('x', 'y' o 'z').

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**kwargs

Otros argumentos se envían a matplotlib.axes.Axes.bar.

Devoluciones :

mpl_toolkits.mplot3d.art3d.Patch3DCollection

bar3d ( x , y , z , dx , dy , dz , color = Ninguno , zsort = 'promedio' , sombra = Verdadero , fuente de luz = Ninguno , * argumentos , datos = Ninguno , ** kwargs )

Genere un gráfico de barras 3D.

Este método crea un gráfico de barras tridimensional donde el ancho, la profundidad, la altura y el color de las barras se pueden configurar de forma única.

Parámetros :

tipo matriz x, y, z

Las coordenadas del punto de anclaje de las barras.

dx, dy, dz flotante o tipo matriz

El ancho, la profundidad y la altura de las barras, respectivamente.

secuencia de colores de colores, opcional

El color de las barras se puede especificar de forma global o individual. Este parámetro puede ser:

• Un solo color, para colorear todas las barras del mismo color.

• Una matriz de colores de N barras de longitud, para colorear cada barra de forma independiente.

• Una matriz de colores de longitud 6, para colorear las caras de las barras de manera similar.

• Una matriz de colores de 6 * N barras de longitud, para colorear cada cara de forma independiente.

Al colorear las caras de las cajas específicamente, este es el orden del coloreado:

1. -Z (parte inferior de la caja)

2. +Z (parte superior de la caja)

3. -Y

4. +Y

5. -X

6. +X

zsort str, opcional

El esquema de clasificación del eje z pasó aPoly3DCollection

sombra bool, por defecto: Verdadero

Cuando es verdadero, esto sombrea los lados oscuros de las barras (en relación con la fuente de luz de la trama).

fuente de luzLightSource

La fuente de luz que se usará cuando la sombra sea True.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**kwargs

Cualquier argumento de palabra clave adicional se pasa a Poly3DCollection.

Devoluciones :

recopilaciónPoly3DCollection

Una colección de polígonos tridimensionales que representan las barras.

can_pan ( )

Devuelve si estos ejes admiten la funcionalidad del botón de panorámica/zoom.

Los objetos Axes3d no utilizan el botón de panorámica/zoom.

can_zoom ( )

Devuelve si estos ejes admiten la funcionalidad del botón del cuadro de zoom.

Los objetos Axes3D no utilizan el botón de cuadro de zoom.

clabel ( * argumentos , ** kwargs )

Actualmente no está implementado para ejes 3D y devuelve None .

borrar ( )

Borrar los ejes.

contorno ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Cree una gráfica de contorno 3D.

Parámetros :

X, Y, Z en forma de matriz,

Datos de entrada. Consulte Axes.contourlas formas de datos admitidas.

extend3d bool, por defecto: Falso

Ya sea para extender el contorno en 3D.

zancada int

Tamaño de paso para extender el contorno.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.contour.

Devoluciones :

matplotlib.contour.QuadContourSet

contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Cree una gráfica de contorno 3D.

Parámetros :

X, Y, Z en forma de matriz,

Datos de entrada. Consulte Axes.contourlas formas de datos admitidas.

extend3d bool, por defecto: Falso

Ya sea para extender el contorno en 3D.

zancada int

Tamaño de paso para extender el contorno.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.contour.

Devoluciones :

matplotlib.contour.QuadContourSet

contornof ( X , Y , Z , * args , zdir = 'z' , offset = Ninguno , datos = Ninguno , ** kwargs )

Cree un gráfico de contorno relleno en 3D.

Parámetros :

Tipo de matriz X, Y, Z

Datos de entrada. Consulte Axes.contourflas formas de datos admitidas.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.contourf.

Devoluciones :

matplotlib.contour.QuadContourSet

contourf3D ( X , Y , Z , * args , zdir = 'z' , offset = Ninguno , datos = Ninguno , ** kwargs )

Cree un gráfico de contorno relleno en 3D.

Parámetros :

Tipo de matriz X, Y, Z

Datos de entrada. Consulte Axes.contourflas formas de datos admitidas.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.contourf.

Devoluciones :

matplotlib.contour.QuadContourSet

convert_zunits ( z )

Para artistas en ejes, si el zaxis admite unidades, convierta z usando el tipo de unidad zaxis

disabled_mouse_rotation ( )

Deshabilite los botones del mouse para la rotación y el zoom en 3D.

propiedad dist

dibujar ( procesador )

Dibuja al Artista (y sus hijos) usando el renderizador dado.

Esto no tiene efecto si el artista no está visible ( Artist.get_visible devuelve Falso).

Parámetros :

subclase de renderizador .RendererBase

notas

Este método se anula en las subclases de artista.

barra de error ( x , y , z , zerr = Ninguno , yerr = Ninguno , xerr = Ninguno , fmt = '' , barsabove = False , errorevery = 1 , ecolor = Ninguno , elinewidth = Ninguno , capsize = Ninguno , capthick = Ninguno , xlolims = Falso , xuplims= Falso , ylolims = Falso , yuplims = Falso , zlolims = Falso , zuplims = Falso , * , datos = Ninguno , ** kwargs )

Trace líneas y/o marcadores con barras de error a su alrededor.

x / y / z definen las ubicaciones de los datos y xerr / yerr / zerr definen los tamaños de la barra de error. Por defecto, esto dibuja los marcadores/líneas de datos así como las barras de error. Use fmt='none' para dibujar barras de error únicamente.

Parámetros :

x, y, z flotante o tipo matriz

Las posiciones de los datos.

xerr, yerr, zerr float o tipo array, forma (N,) o (2, N), opcional

Los tamaños de la barra de error:

• escalar: valores simétricos +/- para todos los puntos de datos.

• forma (N,): valores simétricos +/- para cada punto de datos.

• forma (2, N): valores separados - y + para cada barra. La primera fila contiene los errores inferiores, la segunda fila contiene los errores superiores.

• Ninguno : Sin barra de error.

Tenga en cuenta que todas las matrices de errores deben tener valores positivos .

cadena fmt , por defecto: ''

El formato de los puntos de datos/líneas de datos. Ver plotpara más detalles.

Use 'ninguno' (sin distinción entre mayúsculas y minúsculas) para trazar barras de error sin ningún marcador de datos.

color ecolor , por defecto: Ninguno

El color de las líneas de la barra de error. Si no hay, use el color de la línea que conecta los marcadores.

elinewidth float, por defecto: Ninguno

El ancho de línea de las líneas de la barra de error. Si es Ninguno, se usa el ancho de línea del estilo actual.

capsize float, predeterminado: rcParams["errorbar.capsize"](predeterminado: 0.0)

La longitud de los límites de la barra de error en puntos.

capthick float, predeterminado: Ninguno

Un alias para el argumento de la palabra clave markeredgewidth (también conocido como mew ). Esta configuración es un nombre más sensato para la propiedad que controla el grosor de la tapa de la barra de error en puntos. Para compatibilidad con versiones anteriores, si se proporciona mew o markeredgewidth , estos anularán capthick . Esto puede cambiar en versiones futuras.

barsabove bool, predeterminado: Falso

Si es Verdadero, trazará las barras de error sobre los símbolos de trazado. El valor predeterminado está debajo.

xlolims, ylolims, zlolims bool, predeterminado: Falso

Estos argumentos se pueden usar para indicar que un valor proporciona solo límites inferiores. En ese caso, se utiliza un símbolo de intercalación para indicarlo. lims : los argumentos pueden ser escalares o similares a matrices de la misma longitud que los errores. Para usar límites con ejes invertidos, set_xlimo set_ylimdebe llamarse antes de errorbar. Tenga en cuenta los nombres de parámetros complicados: establecer, por ejemplo, ylolims en True significa que el valor y es un límite inferior del valor True, por lo que solo se dibujará una flecha que apunta hacia arriba .

xuplims, yuplims, zuplims bool, predeterminado: Falso

Igual que el anterior, pero para controlar los límites superiores.

errorevery int o (int, int), por defecto: 1

dibuja barras de error en un subconjunto de los datos. errorevery =N dibuja barras de error en los puntos (x[::N], y[::N], z[::N]). errorevery =(start, N) dibuja barras de error en los puntos (x[start::N], y[start::N], z[start::N]). por ejemplo, errorevery=(6, 3) agrega barras de error a los datos en (x[6], x[9], x[12], x[15], ...). Se utiliza para evitar la superposición de barras de error cuando dos series comparten valores en el eje x.

Devoluciones :

lista de líneas de error

Lista de Line3DCollectioninstancias, cada una de las cuales contiene una línea de barra de error.

lista caplines

Lista de Line3Dinstancias, cada una de las cuales contiene un objeto capline.

lista de marcadores

Lista de Line3Dinstancias, cada una de las cuales contiene un marcador con un límite superior o inferior.

Otros parámetros :

objeto indexable de datos , opcional

Si se proporcionan, los siguientes parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción):

x , y , z , xerr , yerr , zerr

**kwargs

Todos los demás argumentos de palabras clave para diseñar las líneas de la barra de errores se pasan Line3DCollection.

Ejemplos

( Código fuente , png )

format_coord ( xd , yd )

Dadas las coordenadas de la vista 2D, intente adivinar una coordenada 3D. Busca el borde más cercano al punto y luego asume que el punto está en la misma ubicación z que el punto más cercano en el borde.

format_zdata ( z )

Devuelve el formato de cadena z . Esta función usará el fmt_zdataatributo si es invocable, de lo contrario recurrirá al formateador principal de zaxis

get_autoscalez_on ( )

Devuelve si el zaxis se escala automáticamente.

get_axis_position ( )

get_frame_on ( )

Obtenga si los paneles de ejes 3D están dibujados.

get_proj ( )

Cree la matriz de proyección desde la posición de visualización actual.

get_tightbbox ( procesador = Ninguno , call_axes_locator = Verdadero , bbox_extra_artists = Ninguno , * , for_layout_only = Falso )

Devuelve el cuadro delimitador ajustado de los ejes, incluido el eje y sus decoradores (xlabel, título, etc.).

Los artistas que tienen artist.set_in_layout(False)no están incluidos en el bbox.

Parámetros :

subclase de renderizadorRendererBase

renderizador que se usará para dibujar las figuras (es decir, fig.canvas.get_renderer())

bbox_extra_artists lista de ArtistoNone

Lista de artistas para incluir en el cuadro delimitador estrecho. Si None(predeterminado), todos los hijos artistas de los ejes se incluyen en el cuadro delimitador estrecho.

call_axes_locator booleano , predeterminado: Verdadero

Si call_axes_locator es False, no llama al _axes_locatoratributo, lo cual es necesario para obtener el cuadro delimitador correcto. call_axes_locator=Falsese puede usar si la persona que llama solo está interesada en el tamaño relativo del tightbbox en comparación con el bbox de Axes.

for_layout_only predeterminado: Falso

El cuadro delimitador no incluirá la extensión x del título y la etiqueta x, ni la extensión y de la etiqueta y.

Devoluciones :

BboxBase

Cuadro delimitador en coordenadas de píxeles de figura.

Ver también

matplotlib.axes.Axes.get_window_extent

matplotlib.axis.Axis.get_tightbbox

matplotlib.spines.Spine.get_window_extent

get_w_lims ( )

Obtenga límites mundiales en 3D.

get_xlim ( )

Devuelve los límites de vista del eje x.

Devoluciones :

izquierda, derecha (flotante, flotante)

Los límites actuales del eje x en coordenadas de datos.

Ver también

Axes.set_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

notas

El eje x puede estar invertido, en cuyo caso el valor de la izquierda será mayor que el valor de la derecha .

get_xlim3d ( )

Alias ​​para get_xlim.

get_ylim ( )

Devuelve los límites de vista del eje y.

Devoluciones :

inferior, superior (flotante, flotante)

Los límites actuales del eje y en coordenadas de datos.

Ver también

Axes.set_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

notas

El eje y se puede invertir, en cuyo caso el valor inferior será mayor que el valor superior .

get_ylim3d ( )

Alias ​​para get_ylim.

get_zaxis ( )

Devuelve la instancia ZAxis( ).Axis

get_zbound ( )

Devuelve los límites inferior y superior del eje z, en orden creciente.

get_zgridlines ( )

Devuelve las líneas de cuadrícula de zaxis como una lista de Line2Ds.

get_zlabel ( )

Obtenga la cadena de texto de la etiqueta z.

get_zlim ( )

Obtener límites z 3D.

get_zlim3d ( )

Alias ​​para get_zlim.

get_zmajorticklabels ( )

Devuelve las principales etiquetas de marca de zaxis, como una lista de Text.

get_zminorticklabels ( )

Devuelve las etiquetas de ticks menores de zaxis, como una lista de Text.

get_zscale ( )

Devuelve la escala de zaxis (como str).

get_zticklabels ( menor = Falso , que = Ninguno )

Obtén las etiquetas de ticks de los zaxis.

Parámetros :

bool menor

Ya sea para devolver las etiquetas menores o mayores.

cual Ninguno, ('menor', 'mayor', 'ambos')

Anula menor .

Selecciona qué ticklabels devolver

Devoluciones :

lista deText

get_zticklines ( menor = Falso )

Devuelve las líneas de verificación de zaxis como una lista de Line2Ds.

get_zticks ( * , menor = Falso )

Devuelve las ubicaciones de marca de los zaxis en coordenadas de datos.

Las ubicaciones no se recortan a los límites del eje actual y, por lo tanto, pueden contener ubicaciones que no son visibles en la salida.

Parámetros :

bool menor , predeterminado: falso

True para devolver las direcciones de ticks menores, False para devolver las direcciones de ticks principales.

Devoluciones :

gran variedad de ubicaciones de garrapatas

grilla ( visible = Verdadero , ** kwargs )

Establecer/desestablecer cuadrícula 3D.

Nota

Actualmente, esta función no se comporta de la misma manera que axes.Axes.grid, pero está pensada para eventualmente admitir ese comportamiento.

invertir_zaxis ( )

Invertir el eje z.

márgenes ( * márgenes , x = Ninguno , y = Ninguno , z = Ninguno , apretado = Verdadero )

Establecer o recuperar márgenes de escalado automático.

Ver Axes.marginspara la documentación completa. Debido a que esta función se aplica a los ejes 3D, también toma un argumento z y devuelve .(xmargin, ymargin, zmargin)

mouse_init ( rotate_btn = 1 , zoom_btn = 3 )

Configure los botones del mouse para la rotación y el zoom en 3D.

Parámetros :

rotar_btn int o lista de int, por defecto: 1

El botón o botones del ratón que se utilizarán para la rotación 3D de los ejes.

zoom_btn int o lista de int, predeterminado: 3

El botón o botones del mouse que se usarán para hacer zoom en los ejes 3D.

nombre = '3d'

trama ( xs , ys , * argumentos , zdir = 'z' , ** kwargs )

Trazar datos 2D o 3D.

Parámetros :

xs 1D tipo matriz

coordenadas x de los vértices.

ys 1D tipo matriz

y coordenadas de vértices.

zs float o tipo matriz 1D

coordenadas z de vértices; uno para todos los puntos o uno para cada punto.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

Al trazar datos 2D, la dirección a usar como z ('x', 'y' o 'z').

**kwargs

Otros argumentos se envían a matplotlib.axes.Axes.plot.

plot3D ( xs , ys , * argumentos , zdir = 'z' , ** kwargs )

Trazar datos 2D o 3D.

Parámetros :

xs 1D tipo matriz

coordenadas x de los vértices.

ys 1D tipo matriz

y coordenadas de vértices.

zs float o tipo matriz 1D

coordenadas z de vértices; uno para todos los puntos o uno para cada punto.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

Al trazar datos 2D, la dirección a usar como z ('x', 'y' o 'z').

**kwargs

Otros argumentos se envían a matplotlib.axes.Axes.plot.

plot_surface ( X , Y , Z , * , norma = Ninguno , vmin = Ninguno , vmax = Ninguno , fuente de luz = Ninguno , ** kwargs )

Crea un gráfico de superficie.

De forma predeterminada, se coloreará en tonos de un color sólido, pero también es compatible con el mapeo de colores al proporcionar el argumento cmap .

Nota

Los kwargs rcount y ccount , que tienen un valor predeterminado de 50, determinan el número máximo de muestras utilizadas en cada dirección. Si los datos de entrada son más grandes, se reducirán (mediante cortes) a este número de puntos.

Nota

Para maximizar la velocidad de representación, considere establecer rstride y cstride en divisores del número de filas menos 1 y columnas menos 1 respectivamente. Por ejemplo, dadas 51 filas, rstride puede ser cualquiera de los divisores de 50.

De manera similar, una configuración de rstride y cstride igual a 1 (o rcount y ccount igual al número de filas y columnas) puede usar la ruta optimizada.

Parámetros :

Arreglos 2D X, Y, Z

Valores de datos.

rcuenta, cuenta int

Número máximo de muestras utilizadas en cada dirección. Si los datos de entrada son más grandes, se reducirán (mediante cortes) a este número de puntos. El valor predeterminado es 50.

rzancada, czancada int

Paso de reducción de muestreo en cada dirección. Estos argumentos son mutuamente excluyentes con rcount y ccount . Si solo se establece uno de rstride o cstride , el otro predeterminado es 10.

El modo 'clásico' usa un valor predeterminado de en lugar del nuevo valor predeterminado de .rstride = cstride = 10rcount = ccount = 50

color parecido al color

Color de los parches superficiales.

cmap Mapa de colores

Mapa de colores de los parches de la superficie.

facecolors como una matriz de colores.

Colores de cada parche individual.

norma Normalizar

Normalización para el mapa de colores.

flotante vmin, vmax

Límites para la normalización.

sombra bool, por defecto: Verdadero

Ya sea para sombrear los colores de la cara. El sombreado siempre está deshabilitado cuando se especifica cmap .

fuente de luzLightSource

La fuente de luz que se usará cuando la sombra sea True.

**kwargs

Otros argumentos se envían a Poly3DCollection.

plot_trisurf ( * argumentos , color = Ninguno , norma = Ninguno , vmin = Ninguno , vmax = Ninguno , fuente de luz = Ninguno , ** kwargs )

Trace una superficie triangulada.

La triangulación (opcional) se puede especificar de dos maneras; o:

plot_trisurf(triangulation, ...)

donde la triangulación es un Triangulationobjeto, o:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

en cuyo caso se creará un objeto Triangulación. Véase Triangulationpara una explicación de estas posibilidades.

Los argumentos restantes son:

plot_trisurf(..., Z)

donde Z es la matriz de valores a contornear, uno por punto en la triangulación.

Parámetros :

Tipo de matriz X, Y, Z

Valores de datos como matrices 1D.

color

Color de los parches superficiales.

cmap

Un mapa de colores para los parches de superficie.

norma Normalizar

Una instancia de Normalizar para asignar valores a colores.

vmin, vmax flotante, predeterminado: Ninguno

Valor mínimo y máximo a mapear.

sombra bool, por defecto: Verdadero

Ya sea para sombrear los colores de la cara. El sombreado siempre está deshabilitado cuando se especifica cmap .

fuente de luzLightSource

La fuente de luz que se usará cuando la sombra sea True.

**kwargs

Todos los demás argumentos se pasan a Poly3DCollection

Ejemplos

( Código fuente , png )

( Código fuente , png )

plot_wireframe ( X , Y , Z , ** kwargs )

Trace una estructura alámbrica 3D.

Nota

Los kwargs rcount y ccount , que tienen un valor predeterminado de 50, determinan el número máximo de muestras utilizadas en cada dirección. Si los datos de entrada son más grandes, se reducirán (mediante cortes) a este número de puntos.

Parámetros :

Arreglos 2D X, Y, Z

Valores de datos.

rcuenta, cuenta int

Número máximo de muestras utilizadas en cada dirección. Si los datos de entrada son más grandes, se reducirán (mediante cortes) a este número de puntos. Establecer un recuento en cero hace que los datos no se muestreen en la dirección correspondiente, lo que produce un gráfico de líneas 3D en lugar de un gráfico de estructura alámbrica. El valor predeterminado es 50.

rzancada, czancada int

Paso de reducción de muestreo en cada dirección. Estos argumentos son mutuamente excluyentes con rcount y ccount . Si solo se establece uno de rstride o cstride , el otro tiene el valor predeterminado 1. Establecer un paso en cero hace que los datos no se muestreen en la dirección correspondiente, lo que produce un gráfico de líneas 3D en lugar de un gráfico de estructura alámbrica.

El modo 'clásico' usa un valor predeterminado de en lugar del nuevo valor predeterminado de .rstride = cstride = 1rcount = ccount = 50

**kwargs

Otros argumentos se envían a Line3DCollection.

carcaj ( X , Y , Z , U , V , W , / , longitud = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

Trace un campo 3D de flechas.

Los argumentos pueden ser de tipo matriz o escalares, siempre que puedan transmitirse juntos. Los argumentos también pueden ser matrices enmascaradas. Si un elemento en cualquiera de los argumentos está enmascarado, ese elemento carcaj correspondiente no se trazará.

Parámetros :

Tipo de matriz X, Y, Z

Las coordenadas x, y y z de las ubicaciones de las flechas (el valor predeterminado es la cola de la flecha; consulte kwarg de pivote ).

U, V, W en forma de matriz

Los componentes x, y y z de los vectores de flecha.

flotante de longitud , por defecto: 1

La longitud de cada carcaj.

arrow_length_ratio flotante, predeterminado: 0.3

La relación de la punta de la flecha con respecto al carcaj.

pivote {'cola', 'medio', 'punta'}, predeterminado: 'cola'

La parte de la flecha que está en el punto de la cuadrícula; la flecha gira alrededor de este punto, de ahí el nombre de pivote .

normalizar bool, por defecto: Falso

Si todas las flechas están normalizadas para tener la misma longitud o mantienen las longitudes definidas por u , v y w .

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**kwargs

Cualquier argumento de palabra clave adicional se delega a LineCollection

quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

Trace un campo 3D de flechas.

Los argumentos pueden ser de tipo matriz o escalares, siempre que puedan transmitirse juntos. Los argumentos también pueden ser matrices enmascaradas. Si un elemento en cualquiera de los argumentos está enmascarado, ese elemento carcaj correspondiente no se trazará.

Parámetros :

Tipo de matriz X, Y, Z

Las coordenadas x, y y z de las ubicaciones de las flechas (el valor predeterminado es la cola de la flecha; consulte kwarg de pivote ).

U, V, W en forma de matriz

Los componentes x, y y z de los vectores de flecha.

flotante de longitud , por defecto: 1

La longitud de cada carcaj.

arrow_length_ratio flotante, predeterminado: 0.3

La relación de la punta de la flecha con respecto al carcaj.

pivote {'cola', 'medio', 'punta'}, predeterminado: 'cola'

La parte de la flecha que está en el punto de la cuadrícula; la flecha gira alrededor de este punto, de ahí el nombre de pivote .

normalizar bool, por defecto: Falso

Si todas las flechas están normalizadas para tener la misma longitud o mantienen las longitudes definidas por u , v y w .

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**kwargs

Cualquier argumento de palabra clave adicional se delega a LineCollection

dispersión ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = ninguno , sombra de profundidad = verdadero , * argumentos , datos = ninguno , ** kwargs )

Crea un gráfico de dispersión.

Parámetros :

xs, ys tipo matriz

Las posiciones de los datos.

zs flotante o similar a una matriz, predeterminado: 0

Las posiciones z. Ya sea una matriz de la misma longitud que xs e ys o un solo valor para colocar todos los puntos en el mismo plano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, predeterminado: 'z'

La dirección del eje para zs . Esto es útil cuando se trazan datos 2D en ejes 3D. Los datos deben pasarse como xs , ys . Al configurar zdir en 'y', se trazan los datos en el plano xz .

Ver también Graficar datos 2D en gráfica 3D .

s flotante o tipo matriz, por defecto: 20

El tamaño del marcador en puntos**2. Una matriz de la misma longitud que xs e ys o un solo valor para que todos los marcadores tengan el mismo tamaño.

c color, secuencia o secuencia de colores, opcional

El color del marcador. Valores posibles:

• Una cadena de formato de un solo color.

• Una secuencia de colores de longitud n.

• Una secuencia de n números que se asignarán a colores usando cmap y norm .

• Una matriz 2D en la que las filas son RGB o RGBA.

Para obtener más detalles, consulte el argumento cscatter de .

sombreado de profundidad booleano , predeterminado: Verdadero

Ya sea para sombrear los marcadores de dispersión para dar la apariencia de profundidad. Cada llamada a scatter()realizará su sombreado de profundidad de forma independiente.

objeto indexable de datos , opcional

Si se proporcionan, los siguientes parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción):

xs , ys , zs , s , edgecolors , c , facecolor , facecolors , color

**kwargs

Todos los demás argumentos se pasan a scatter.

Devoluciones :

caminosPathCollection

scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs )

Crea un gráfico de dispersión.

Parámetros :

xs, ys tipo matriz

Las posiciones de los datos.

zs flotante o similar a una matriz, predeterminado: 0

Las posiciones z. Ya sea una matriz de la misma longitud que xs e ys o un solo valor para colocar todos los puntos en el mismo plano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, predeterminado: 'z'

La dirección del eje para zs . Esto es útil cuando se trazan datos 2D en ejes 3D. Los datos deben pasarse como xs , ys . Al configurar zdir en 'y', se trazan los datos en el plano xz .

Ver también Graficar datos 2D en gráfica 3D .

s flotante o tipo matriz, por defecto: 20

El tamaño del marcador en puntos**2. Una matriz de la misma longitud que xs e ys o un solo valor para que todos los marcadores tengan el mismo tamaño.

c color, secuencia o secuencia de colores, opcional

El color del marcador. Valores posibles:

• Una cadena de formato de un solo color.

• Una secuencia de colores de longitud n.

• Una secuencia de n números que se asignarán a colores usando cmap y norm .

• Una matriz 2D en la que las filas son RGB o RGBA.

Para obtener más detalles, consulte el argumento cscatter de .

sombreado de profundidad booleano , predeterminado: Verdadero

Ya sea para sombrear los marcadores de dispersión para dar la apariencia de profundidad. Cada llamada a scatter()realizará su sombreado de profundidad de forma independiente.

objeto indexable de datos , opcional

Si se proporcionan, los siguientes parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción):

xs , ys , zs , s , edgecolors , c , facecolor , facecolors , color

**kwargs

Todos los demás argumentos se pasan a scatter.

Devoluciones :

caminosPathCollection

establecer ( * , ajustable=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , ancla=<UNSET> , animated=<UNSET> , aspect=<UNSET> , autoscale_on=<UNSET> , autoscalex_on=<UNSET > , autoscaley_on=<UNSET> , autoscalez_on=<UNSET> , axes_locator=<UNSET> , axisbelow=<UNSET> , box_aspect=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color de cara=<DESCONFIGURAR> , frame_on=<DESCONFIGURAR>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , browser =<UNSET> , path_effects=<UNSET> , picker=<UNSET> , position=<UNSET> , proj_type =<UNSET> , prop_cycle=<UNSET> , rasterization_zorder=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , title=<UNSET> , transform=<UNSET> , url=< DESCONFIGURAR> , visible=<DESCONFIGURAR>, xbound=<UNSET> ,xlabel=<UNSET> , xlim=<UNSET> , xlim3d=<UNSET> , xmargin=<UNSET> , xscale=<UNSET> , xticklabels=<UNSET> , xticks=<UNSET> , ybound=<UNSET> , ylabel= <UNSET> , ylim=<UNSET> , ylim3d=<UNSET> , ymargin=<UNSET> , yscale=<UNSET> , yticklabels=<UNSET> , yticks=<UNSET> , zbound=<UNSET> , zlabel=<UNSET > , zlim=<DESCONFIGURACIÓN> , zlim3d=<DESCONFIGURACIÓN>, zmargin=<DESCONFIGURAR> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> )

Establece varias propiedades a la vez.

Las propiedades admitidas son

Propiedad	Descripción
adjustable	{'caja', 'límite de datos'}
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
anchor	(flotante, flotante) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'igual', 'igualxy', 'igualxz', 'igualz'}
autoscale_on	bool
autoscalex_on	desconocido
autoscaley_on	desconocido
autoscalez_on	desconocido
axes_locator	Invocable[[Ejes, Renderer], Bbox]
axisbelow	bool o 'línea'
box_aspect	3 tuplas de flotantes o Ninguno
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
facecoloro FC	color
figure	Figure
frame_on	bool
gid	calle
in_layout	bool
label	objeto
mouseover	bool
navigate	bool
navigate_mode	desconocido
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	[izquierda, abajo, ancho, alto] oBbox
proj_type	{'persp', 'orto'}
prop_cycle	desconocido
rasterization_zorder	flotante o Ninguno
rasterized	bool
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
title	desconocido
transform	Transform
url	calle
visible	bool
xbound	desconocido
xlabel	calle
xlim	(abajo: flotador, arriba: flotador)
xlim3d	(abajo: flotador, arriba: flotador)
xmargin	flotante mayor que -0.5
xscale	desconocido
xticklabels	desconocido
xticks	desconocido
ybound	desconocido
ylabel	calle
ylim	(abajo: flotador, arriba: flotador)
ylim3d	(abajo: flotador, arriba: flotador)
ymargin	flotante mayor que -0.5
yscale	desconocido
yticklabels	desconocido
yticks	desconocido
zbound	desconocido
zlabel	desconocido
zlim	desconocido
zlim3d	desconocido
zmargin	flotante mayor que -0.5
zorder	flotar
zscale	desconocido
zticklabels	desconocido
zticks	desconocido

set_aspect ( aspecto , ajustable = Ninguno , ancla = Ninguno , compartir = Falso )

Establezca las relaciones de aspecto.

Parámetros :

aspecto {'auto', 'igual', 'equalxy', 'equalxz', 'equalyz'}

Valores posibles:

valor	descripción
'auto'	automático; llene el rectángulo de posición con datos.
'igual'	adapte todos los ejes para que tengan las mismas relaciones de aspecto.
'equalxy'	adapte los ejes x e y para que tengan relaciones de aspecto iguales.
'igualxz'	adapte los ejes x y z para que tengan relaciones de aspecto iguales.
'igualdad'	adapte los ejes y y z para que tengan relaciones de aspecto iguales.

ajustable Ninguno

Actualmente ignorado por Axes3D

Si no es Ninguno , esto define qué parámetro se ajustará para cumplir con el aspecto requerido. Ver set_adjustablepara más detalles.

ancla Ninguno o str o 2 tuplas de float, opcional

Si no es Ninguno , esto define dónde se dibujarán los ejes si hay espacio adicional debido a restricciones de aspecto. La forma más común de especificar el ancla son las abreviaturas de los puntos cardinales:

valor	descripción
'C'	centrado
'SUDOESTE'	esquina inferior izquierda
'S'	medio del borde inferior
'SE'	esquina inferior derecha
etc.

Ver set_anchorpara más detalles.

compartir bool, predeterminado: falso

Si True, aplique la configuración a todos los ejes compartidos.

Ver también

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscalez_on ( b )

Establezca si el eje z se escala automáticamente al dibujar o por Axes.autoscale_view.

Parámetros :

b bool

set_axis_off ( )

Apague los ejes x e y.

Esto afecta a las líneas de los ejes, los ticks, las etiquetas de los ticks, la cuadrícula y las etiquetas de los ejes.

set_axis_on ( )

Active los ejes x e y.

Esto afecta a las líneas de los ejes, los ticks, las etiquetas de los ticks, la cuadrícula y las etiquetas de los ejes.

set_box_aspect ( aspecto , * , zoom = 1 )

Establezca el aspecto del cuadro de ejes.

El aspecto de la caja es la relación entre la altura y el ancho en unidades de visualización para cada cara de la caja cuando se ve perpendicular a esa cara. Esto no debe confundirse con el aspecto de los datos (que para Axes3D siempre es 'auto'). Las proporciones predeterminadas son 4:4:3 (x:y:z).

Para simular tener el mismo aspecto en el espacio de datos, configure el aspecto del cuadro para que coincida con su rango de datos en cada dimensión.

zoom controla el tamaño total de Axes3D en la figura.

Parámetros :

aspecto 3-tupla de flotadores o Ninguno

Cambia las dimensiones físicas de Axes3D, de modo que la proporción de las longitudes de los ejes en unidades de visualización es x:y:z. Si ninguno, el valor predeterminado es (4,4,3).

zoom flotante, predeterminado: 1

Controle el tamaño total de Axes3D en la figura. Debe ser > 0.

set_frame_on ( b )

Establezca si se dibujan los paneles de ejes 3D.

Parámetros :

b bool

set_proj_type ( proj_type , focal_length = None )

Configure el tipo de proyección.

Parámetros :

proj_type {'persp', 'orto'}

El tipo de proyección.

focal_length flotante, predeterminado: Ninguno

Para un tipo de proyección de 'persp', la distancia focal de la cámara virtual. Debe ser > 0. Si no hay ninguno, el valor predeterminado es 1. La distancia focal se puede calcular a partir de un campo de visión deseado a través de la ecuación: longitud_focal = 1/bronceado(FOV/2)

set_title ( etiqueta , fontdict = Ninguno , loc = 'centro' , ** kwargs )

Establezca un título para los ejes.

Establezca uno de los tres títulos de Axes disponibles. Los títulos disponibles se colocan encima de los ejes en el centro, alineados con el borde izquierdo y alineados con el borde derecho.

Parámetros :

cadena de etiquetas

Texto a usar para el título

dictado de fuente

Un diccionario que controla la apariencia del texto del título, el fontdict predeterminado es:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc {'centro', 'izquierda', 'derecha'}, predeterminado: rcParams["axes.titlelocation"](predeterminado: 'center')

Qué título poner.

y float, predeterminado: rcParams["axes.titley"](predeterminado: None)

Ubicación de los ejes verticales para el título (1.0 es la parte superior). Si Ninguno (predeterminado) y rcParams["axes.titley"](predeterminado: None) también es Ninguno, y se determina automáticamente para evitar decoradores en los Ejes.

pad float, predeterminado: rcParams["axes.titlepad"](predeterminado: 6.0)

El desplazamiento del título desde la parte superior de los ejes, en puntos.

Devoluciones :

Text

La instancia de texto de matplotlib que representa el título.

Otros parámetros :

** Textpropiedades de los kwargs

Otros argumentos de palabras clave son propiedades de texto, consulte Textpara obtener una lista de propiedades de texto válidas.

set_top_view ( )

set_xlim3d ( izquierda = Ninguno , derecho = Ninguno , * , emit = Verdadero , automático = Falso , xmin = Ninguno , xmax = Ninguno )

Establezca los límites de vista del eje x.

Parámetros :

flotador izquierdo , opcional

El xlim izquierdo en coordenadas de datos. Pasar Ninguno deja el límite sin cambios.

Los xlims izquierdo y derecho también se pueden pasar como la tupla ( izquierda , derecha ) como el primer argumento posicional (o como el argumento de la palabra clave izquierda ).

flotador derecho , opcional

El xlim derecho en coordenadas de datos. Pasar Ninguno deja el límite sin cambios.

emitir bool, por defecto: Verdadero

Ya sea para notificar a los observadores del cambio de límite.

bool automático o Ninguno, predeterminado: Falso

Si activar el ajuste de escala automático del eje x. Verdadero se enciende, Falso se apaga, Ninguno se mantiene sin cambios.

xmin, xmax flotante, opcional

Son equivalentes a left y right respectivamente, y es un error pasar tanto xmin como left o xmax y right .

Devoluciones :

izquierda, derecha (flotante, flotante)

Los nuevos límites del eje x en coordenadas de datos.

Ver también

get_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

notas

El valor de la izquierda puede ser mayor que el valor de la derecha , en cuyo caso los valores del eje x disminuirán de izquierda a derecha.

Ejemplos

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

Un límite puede dejarse sin cambios.

>>> set_xlim(right=right_lim)

Los límites se pueden pasar en orden inverso para cambiar la dirección del eje x. Por ejemplo, supongamos que x representa el número de años antes del presente. Los límites del eje x pueden establecerse de la siguiente manera, de modo que hace 5000 años esté a la izquierda del gráfico y el presente esté a la derecha.

>>> set_xlim(5000, 0)

set_xscale ( valor , ** kwargs )

Establezca la escala del eje x.

Parámetros :

valor {"lineal"}

El tipo de escala de eje que se va a aplicar. Los ejes 3D actualmente solo admiten escalas lineales; otras escalas arrojan resultados sin sentido.

**kwargs

Los argumentos de palabras clave se reenvían nominalmente a la clase de escala, pero ninguno de ellos es aplicable para escalas lineales.

set_ylim3d ( inferior = Ninguno , superior = Ninguno , * , emit = Verdadero , automático = Falso , ymin = Ninguno , ymax = Ninguno )

Establezca los límites de vista del eje y.

Parámetros :

flotador inferior , opcional

El ylim inferior en coordenadas de datos. Pasar Ninguno deja el límite sin cambios.

Los ylims inferior y superior también se pueden pasar como la tupla ( inferior , superior ) como el primer argumento posicional (o como el argumento de palabra clave inferior ).

flotador superior , opcional

El ylim superior en coordenadas de datos. Pasar Ninguno deja el límite sin cambios.

emitir bool, por defecto: Verdadero

Ya sea para notificar a los observadores del cambio de límite.

bool automático o Ninguno, predeterminado: Falso

Ya sea para activar el ajuste de escala automático del eje y. Verdadero se enciende, Falso se apaga, Ninguno se mantiene sin cambios.

ymin, ymax float, opcional

Son equivalentes a bottom y top respectivamente, y es un error pasar tanto ymin como bottom o ymax y top .

Devoluciones :

inferior, superior (flotante, flotante)

Los nuevos límites del eje y en las coordenadas de datos.

Ver también

get_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

notas

El valor inferior puede ser mayor que el valor superior , en cuyo caso los valores del eje y disminuirán de abajo hacia arriba .

Ejemplos

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

Un límite puede dejarse sin cambios.

>>> set_ylim(top=top_lim)

Los límites se pueden pasar en orden inverso para cambiar la dirección del eje y. Por ejemplo, supongamos que yrepresenta la profundidad del océano en m. Los límites del eje y pueden establecerse de la siguiente manera, de modo que la profundidad de 5000 m esté en la parte inferior de la parcela y la superficie, 0 m, esté en la parte superior.

>>> set_ylim(5000, 0)

set_yscale ( valor , ** kwargs )

Establezca la escala del eje y.

Parámetros :

valor {"lineal"}

El tipo de escala de eje que se va a aplicar. Los ejes 3D actualmente solo admiten escalas lineales; otras escalas arrojan resultados sin sentido.

**kwargs

Los argumentos de palabras clave se reenvían nominalmente a la clase de escala, pero ninguno de ellos es aplicable para escalas lineales.

set_zbound ( inferior = Ninguno , superior = Ninguno )

Establezca los límites numéricos inferior y superior del eje z.

Este método respetará la inversión de los ejes independientemente del orden de los parámetros. No cambiará la configuración de ajuste de escala automático ( get_autoscalez_on()).

set_zlabel ( zlabel , fontdict = Ninguno , labelpad = Ninguno , ** kwargs )

Establecer zlabel. Consulte el documento para set_ylabelobtener una descripción.

set_zlim ( inferior = Ninguno , superior = Ninguno , * , emit = Verdadero , automático = Falso , zmin = Ninguno , zmax = Ninguno )

Establecer límites 3D z.

Ver Axes.set_ylimpara la documentación completa

set_zlim3d ( inferior = Ninguno , superior = Ninguno , * , emit = Verdadero , automático = Falso , zmin = Ninguno , zmax = Ninguno )

Alias ​​para set_zlim.

set_zmargin ( m )

Establezca el relleno de los límites de datos Z antes del escalado automático.

m veces el intervalo de datos se agregará a cada extremo de ese intervalo antes de que se use en el ajuste de escala automático. Si m es negativo, esto recortará el rango de datos en lugar de expandirlo.

Por ejemplo, si sus datos están en el rango [0, 2], un margen de 0,1 dará como resultado un rango [-0,2, 2,2]; un margen de -0,1 dará como resultado un rango de [0,2, 1,8].

Parámetros :

m flotante mayor que -0.5

set_zscale ( valor , ** kwargs )

Establezca la escala del eje z.

Parámetros :

valor {"lineal"}

El tipo de escala de eje que se va a aplicar. Los ejes 3D actualmente solo admiten escalas lineales; otras escalas arrojan resultados sin sentido.

**kwargs

Los argumentos de palabras clave se reenvían nominalmente a la clase de escala, pero ninguno de ellos es aplicable para escalas lineales.

set_zticklabels ( etiquetas , * , fontdict = Ninguno , menor = Falso , ** kwargs )

Establezca las etiquetas de los zaxis con la lista de etiquetas de cadena.

Advertencia

Este método solo debe usarse después de fijar las posiciones de marca usando Axes3D.set_zticks. De lo contrario, las etiquetas pueden terminar en posiciones inesperadas.

Parámetros :

lista de etiquetas de str

Los textos de la etiqueta.

dictado fontdict , opcional

Un diccionario que controla la apariencia de los ticklabels. El fontdict por defecto es:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

bool menor , predeterminado: falso

Si establecer las etiquetas de verificación menores en lugar de las principales.

Devoluciones :

lista deText

Las etiquetas.

Otros parámetros :

** Textpropiedades de los kwargs.

set_zticks ( ticks , etiquetas = Ninguno , * , menor = Falso , ** kwargs )

Establezca las ubicaciones de marca de zaxis y, opcionalmente, las etiquetas.

Si es necesario, los límites de vista del Eje se expanden para que todos los ticks dados sean visibles.

Parámetros :

lista de ticks de flotadores

Lista de ubicaciones de garrapatas. El eje Locatorse reemplaza por un FixedLocator.

Algunos formateadores de ticks no etiquetarán posiciones arbitrarias de ticks; por ejemplo, los formateadores de registros solo etiquetan los ticks de décadas de forma predeterminada. En tal caso, puede configurar un formateador explícitamente en el eje usando o proporcionar etiquetasAxis.set_major_formatter formateadas usted mismo.

lista de etiquetas de str, opcional

Lista de etiquetas de ticks. Si no se establece, las etiquetas se generan con la marca del eje Formatter.

bool menor , predeterminado: falso

Si False, establece los ticks principales; si True, las garrapatas menores.

**kwargs

Textpropiedades de las etiquetas. Estos surten efecto solo si pasa etiquetas . En otros casos, utilice tick_params.

notas

La expansión obligatoria de los límites de vista es una elección de diseño intencional para evitar la sorpresa de una marca no visible. Si necesita otros límites, debe establecer los límites explícitamente después de establecer las marcas.

sharez ( otro )

Comparta el eje z con otros .

Esto es equivalente a pasar sharex=othercuando se construyen los ejes y no se puede usar si el eje z ya se está compartiendo con otros ejes.

stem ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , Orientation = 'z' , data = None )

Cree un gráfico de tallos en 3D.

Un diagrama de tallo dibuja líneas perpendiculares a una línea de base y coloca marcadores en las cabezas. De forma predeterminada, la línea de base está definida por x e y , y los tallos se dibujan verticalmente desde abajo hasta z .

Parámetros :

tipo matriz x, y, z

Las posiciones de las cabezas de los tallos. Los tallos se dibujan a lo largo de la dirección de orientación desde la línea de base en la parte inferior (en la coordenada de orientación ) hasta las cabezas. De manera predeterminada, las posiciones x e y se usan para la línea de base y z para la posición de la cabeza, pero esto se puede cambiar por orientación .

linefmt str, por defecto: 'C0-'

Una cadena que define las propiedades de las líneas verticales. Por lo general, será un color o un color y un estilo de línea:

Personaje	Estilo de línea
'-'	línea sólida
'--'	Linea discontinua
'-.'	línea de puntos y guiones
':'	linea punteada

Nota: Si bien es técnicamente posible especificar formatos válidos que no sean color o color y estilo de línea (p. ej., 'rx' o '-.'), esto va más allá de la intención del método y lo más probable es que no resulte en un gráfico razonable.

marcadorfmt str, por defecto: 'C0o'

Una cadena que define las propiedades de los marcadores en las cabezas de las plicas.

cadena basefmt , por defecto: 'C3-'

Una cadena de formato que define las propiedades de la línea base.

flotante inferior , por defecto: 0

La posición de la línea base, en orientación -coordenadas.

etiqueta str, por defecto: Ninguno

La etiqueta que se usará para las raíces en las leyendas.

orientación {'x', 'y', 'z'}, por defecto: 'z'

La dirección a lo largo de la cual se dibujan los tallos.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

Devoluciones :

StemContainer

El contenedor se puede tratar como una tupla ( marcador , líneas base , línea base )

Ejemplos

( Código fuente , png )

( png )

( png )

stem3D ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , etiqueta = Ninguno , orientación = 'z' , datos = Ninguno )

Cree un gráfico de tallos en 3D.

Un diagrama de tallo dibuja líneas perpendiculares a una línea de base y coloca marcadores en las cabezas. De forma predeterminada, la línea de base está definida por x e y , y los tallos se dibujan verticalmente desde abajo hasta z .

Parámetros :

tipo matriz x, y, z

Las posiciones de las cabezas de los tallos. Los tallos se dibujan a lo largo de la dirección de orientación desde la línea de base en la parte inferior (en la coordenada de orientación ) hasta las cabezas. De manera predeterminada, las posiciones x e y se usan para la línea de base y z para la posición de la cabeza, pero esto se puede cambiar por orientación .

linefmt str, por defecto: 'C0-'

Una cadena que define las propiedades de las líneas verticales. Por lo general, será un color o un color y un estilo de línea:

Personaje	Estilo de línea
'-'	línea sólida
'--'	Linea discontinua
'-.'	línea de puntos y guiones
':'	linea punteada

Nota: Si bien es técnicamente posible especificar formatos válidos que no sean color o color y estilo de línea (p. ej., 'rx' o '-.'), esto va más allá de la intención del método y lo más probable es que no resulte en un gráfico razonable.

marcadorfmt str, por defecto: 'C0o'

Una cadena que define las propiedades de los marcadores en las cabezas de las plicas.

cadena basefmt , por defecto: 'C3-'

Una cadena de formato que define las propiedades de la línea base.

flotante inferior , por defecto: 0

La posición de la línea base, en orientación -coordenadas.

etiqueta str, por defecto: Ninguno

La etiqueta que se usará para las raíces en las leyendas.

orientación {'x', 'y', 'z'}, por defecto: 'z'

La dirección a lo largo de la cual se dibujan los tallos.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

Devoluciones :

StemContainer

El contenedor se puede tratar como una tupla ( marcador , líneas base , línea base )

Ejemplos

( Código fuente , png )

( png )

( png )

texto ( x , y , z , s , zdir = Ninguno , ** kwargs )

Añade texto a la trama. kwargs se pasarán a Axes.text, excepto por la palabra clave zdir , que establece la dirección que se usará como la dirección z.

text2D ( x , y , s , fontdict = Ninguno , ** kwargs )

Agregue texto a los ejes.

Agregue el texto s a los ejes en la ubicación x , y en las coordenadas de datos.

Parámetros :

x, y flotan

La posición para colocar el texto. Por defecto, esto está en coordenadas de datos. El sistema de coordenadas se puede cambiar usando el parámetro de transformación .

calle s

El texto.

fontdict dict, por defecto: Ninguno

Un diccionario para anular las propiedades de texto predeterminadas. Si fontdict es Ninguno, los valores predeterminados están determinados por rcParams.

Devoluciones :

Text

La Textinstancia creada.

Otros parámetros :

** Textpropiedades de los kwargs.

Otros parámetros de texto misceláneos.

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
animated	bool
backgroundcolor	color
bbox	dict con propiedades parapatches.FancyBboxPatch
clip_box	desconocido
clip_on	desconocido
clip_path	desconocido
coloro c	color
figure	Figure
fontfamilyo familia	{FONTNAME, 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}
fontpropertieso fuente o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo tamaño	float o {'xx-pequeño', 'x-pequeño', 'pequeño', 'mediano', 'grande', 'x-grande', 'xx-grande'}
fontstretcho estirar	{un valor numérico en el rango 0-1000, 'ultracondensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleo estilo	{'normal', 'cursiva', 'oblicua'}
fontvarianto variante	{'normal', 'pequeñas capitalizaciones'}
fontweighto peso	{un valor numérico en el rango 0-1000, 'ultraligero', 'ligero', 'normal', 'regular', 'libro', 'medio', 'romano', 'semibold', 'demibold', 'demi', 'negrita', 'pesada', 'extra negrita', 'negra'}
gid	calle
horizontalalignmento ja	{'izquierda centro derecha'}
in_layout	bool
label	objeto
linespacing	float (múltiplo del tamaño de fuente)
math_fontfamily	calle
mouseover	bool
multialignmento mamá	{'izquierda', 'derecha', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	(flotar, flotar)
rasterized	bool
rotation	flotante o {'vertical', 'horizontal'}
rotation_mode	{Ninguno, 'predeterminado', 'ancla'}
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
text	objeto
transform	Transform
transform_rotates_text	bool
url	calle
usetex	booleano o ninguno
verticalalignmento va	{'abajo', 'línea base', 'centro', 'línea_base_central', 'arriba'}
visible	bool
wrap	bool
x	flotar
y	flotar
zorder	flotar

Ejemplos

Los argumentos de palabras clave individuales se pueden usar para anular cualquier parámetro dado:

>>> text(x, y, s, fontsize=12)

La transformación predeterminada especifica que el texto está en coordenadas de datos; de forma alternativa, puede especificar texto en coordenadas de eje ((0, 0) está en la parte inferior izquierda y (1, 1) está en la parte superior derecha). El siguiente ejemplo coloca el texto en el centro de los ejes:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Puede poner un cuadro rectangular alrededor de la instancia de texto (por ejemplo, para establecer un color de fondo) usando la palabra clave bbox . bbox es un diccionario de Rectangle propiedades. Por ejemplo:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

text3D ( x , y , z , s , zdir = Ninguno , ** kwargs )

Añade texto a la trama. kwargs se pasarán a Axes.text, excepto por la palabra clave zdir , que establece la dirección que se usará como la dirección z.

tick_params ( eje = 'ambos' , ** kwargs )

Método conveniente para cambiar la apariencia de las marcas y las etiquetas de las marcas.

Ver Axes.tick_paramspara la documentación completa. Debido a que esta función se aplica a los ejes 3D, el eje también se puede configurar en 'z', y al establecer el eje en 'ambos', los tres ejes se escalan automáticamente.

Además, debido a que los objetos Axes3D se dibujan de manera muy diferente a los ejes 2D normales, algunas de estas configuraciones pueden tener un significado ambiguo. Para simplificar, el eje 'z' aceptará configuraciones como si fuera como el eje 'y'.

Nota

Axes3D actualmente ignora algunas de estas configuraciones.

tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Cree una gráfica de contorno 3D.

Nota

Actualmente, este método produce una salida incorrecta debido a un error de larga data en el renderizado 3D PolyCollection.

Parámetros :

Tipo de matriz X, Y, Z

Datos de entrada. Consulte Axes.tricontourlas formas de datos admitidas.

extend3d bool, por defecto: Falso

Ya sea para extender el contorno en 3D.

zancada int

Tamaño de paso para extender el contorno.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.tricontour.

Devoluciones :

matplotlib.tri.tricontour.TriContourSet

tricontourf ( * argumentos , zdir = 'z' , desplazamiento = Ninguno , datos = Ninguno , ** kwargs )

Cree un gráfico de contorno relleno en 3D.

Nota

Actualmente, este método produce una salida incorrecta debido a un error de larga data en el renderizado 3D PolyCollection.

Parámetros :

Tipo de matriz X, Y, Z

Datos de entrada. Consulte Axes.tricontourflas formas de datos admitidas.

zdir {'x', 'y', 'z'}, predeterminado: 'z'

La dirección de uso.

flotador compensado , opcional

Si se especifica, trace una proyección de las curvas de nivel en esta posición en un plano normal a zdir.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

*args, **kwargs

Otros argumentos se envían a matplotlib.axes.Axes.tricontourf.

Devoluciones :

matplotlib.tri.tricontour.TriContourSet

tunit_cube ( vals = Ninguno , M = Ninguno )

tunit_edges ( vals = Ninguno , M = Ninguno )

unit_cube ( vals = Ninguno )

update_datalim ( xys , ** kwargs )

Extienda el dataLimBbox para incluir los puntos dados.

Si no hay datos configurados actualmente, Bbox ignorará sus límites y establecerá el límite para que sean los límites de xydata ( xys ). De lo contrario, calculará los límites de la unión de sus datos actuales y los datos en xys .

Parámetros :

xys 2D similar a una matriz

Los puntos a incluir en los límites de datos Bbox. Puede ser una lista de tuplas (x, y) o una matriz Nx2.

updatex, update bool, predeterminado: Verdadero

Si actualizar los límites x/y.

view_init ( elev = Ninguno , azim = Ninguno , roll = Ninguno , vertical_axis = 'z' )

Establezca la elevación y el acimut de los ejes en grados (no en radianes).

Esto se puede usar para rotar los ejes mediante programación.

Para que parezca normal a los planos primarios, se pueden utilizar los siguientes ángulos de elevación y acimut. Un ángulo de giro de 0, 90, 180 o 270 grados rotará estas vistas mientras mantiene los ejes en ángulo recto.

ver plano	elevado	azim
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

Parámetros :

elev float, predeterminado: Ninguno

El ángulo de elevación en grados gira la cámara por encima del plano atravesado por el eje vertical, con un ángulo positivo correspondiente a una ubicación por encima de ese plano. Por ejemplo, con el eje vertical predeterminado de 'z', la elevación define el ángulo de ubicación de la cámara sobre el plano xy. Si es Ninguno, se utiliza el valor inicial especificado en el Axes3D constructor.

flotante azim , predeterminado: Ninguno

El ángulo azimutal en grados gira la cámara sobre el eje vertical, con un ángulo positivo correspondiente a una rotación hacia la derecha. Por ejemplo, con el eje vertical predeterminado de 'z', un acimut positivo gira la cámara sobre el origen desde su ubicación a lo largo del eje +x hacia el eje +y. Si es Ninguno, se utiliza el valor inicial especificado en el Axes3D constructor.

roll float, predeterminado: Ninguno

El ángulo de balanceo en grados gira la cámara sobre el eje de visualización. Un ángulo positivo hace girar la cámara en el sentido de las agujas del reloj, lo que hace que la escena gire en el sentido contrario a las agujas del reloj. Si es Ninguno, se utiliza el valor inicial especificado en el Axes3D constructor.

eje_vertical {"z", "x", "y"}, predeterminado: "z"

El eje para alinear verticalmente. azim gira alrededor de este eje.

vóxeles ( [ x , y , z , ] / , rellenos , facecolors=Ninguno , edgecolors=Ninguno , **kwargs )

Trazar un conjunto de vóxeles llenos

Todos los vóxeles se trazan como cubos de 1x1x1 en el eje, con su esquina inferior colocada en el origen. Las caras ocluidas no se trazan.filled[0, 0, 0]

Parámetros :

np.array 3D lleno de bool

Una matriz 3D de valores, con valores reales que indican qué vóxeles llenar

x, y, z 3D np.array, opcional

Las coordenadas de las esquinas de los vóxeles. Esto debería transmitir a una forma más grande en cada dimensión que la forma de relleno . Estos se pueden usar para trazar vóxeles no cúbicos.

Si no se especifica, el valor predeterminado es aumentar los números enteros a lo largo de cada eje, como los que devuelve indices(). Como lo indica /en la firma de la función, estos argumentos solo se pueden pasar posicionalmente.

colores de cara, colores de borde en forma de matriz, opcional

El color para dibujar las caras y los bordes de los vóxeles. Solo se pueden pasar como argumentos de palabra clave. Estos parámetros pueden ser:

• Un solo valor de color, para colorear todos los vóxeles del mismo color. Esto puede ser una cadena o una matriz rgb/rgba 1D

• None, el predeterminado, para usar un solo color para las caras y el estilo predeterminado para los bordes.

• Un ndarray 3D de nombres de colores, con cada elemento del color para el vóxel correspondiente. El tamaño debe coincidir con los vóxeles.

• Un ndarray 4D de datos rgb/rgba, con los componentes a lo largo del último eje.

sombra bool, por defecto: Verdadero

Ya sea para sombrear los colores de la cara. El sombreado siempre está deshabilitado cuando se especifica cmap .

fuente de luzLightSource

La fuente de luz que se usará cuando la sombra sea True.

**kwargs

Argumentos de palabras clave adicionales para pasar a Poly3DCollection.

Devoluciones :

dicta caras

Un diccionario indexado por coordenadas, donde es una de las caras dibujadas para el vóxel . Si no se dibujaron caras para un vóxel dado, ya sea porque no se pidió que se dibujara o porque está completamente ocluido, entonces .faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

Ejemplos

( Código fuente , png )

( Código fuente , png )

( Código fuente , png )

( Código fuente , png )

propiedad w_xaxis

propiedad w_yaxis

propiedad w_zaxis

zaxis_date ( tz = Ninguno )

Configure marcas de eje y etiquetas para tratar los datos a lo largo del eje z como fechas.

Parámetros :

tz str o datetime.tzinfo, predeterminado: rcParams["timezone"](predeterminado: 'UTC')

La zona horaria utilizada para crear etiquetas de fecha.

notas

Esta función solo se proporciona para completar, pero los ejes 3D no admiten fechas para los ticks, por lo que es posible que no funcione como se esperaba.

zaxis_inverted ( )

Devuelve True si el eje z está invertido.