mpl_toolkits.mplot3d.axes3d.Axes3D

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

Bases:Axes

Objeto de eixos 3D.

Parâmetros :

fig Figura

A figura paterna.

tupla rect (esquerda, inferior, largura, altura), padrão: Nenhum.

A posição dos eixos.(left, bottom, width, height)

flutuante elevado , padrão: 30

O ângulo de elevação em graus gira a câmera acima e abaixo do plano xy, com um ângulo positivo correspondente a um local acima do plano.

azim float, padrão: -60

O ângulo azimutal em graus gira a câmera em torno do eixo z, com um ângulo positivo correspondente a uma rotação à direita. Em outras palavras, um azimute positivo gira a câmera em torno da origem de sua localização ao longo do eixo +x em direção ao eixo +y.

rolar flutuar, padrão: 0

O ângulo de rolagem em graus gira a câmera sobre o eixo de visualização. Um ângulo positivo gira a câmera no sentido horário, fazendo com que a cena gire no sentido anti-horário.

sharez Axes3D, opcional

Outros eixos com os quais compartilhar os limites z.

proj_type {'persp', 'orto'}

O tipo de projeção, padrão 'persp'.

box_aspect 3 tuplas de floats, padrão: nenhum

Altera as dimensões físicas de Axes3D, de modo que a proporção dos comprimentos dos eixos em unidades de exibição seja x:y:z. Se Nenhum, o padrão é 4:4:3

computered_zorder bool, padrão: True

Se True, a ordem do desenho é calculada com base na posição média dos Artists ao longo da direção da vista. Defina como Falso se desejar controlar manualmente a ordem na qual os Artistas são desenhados uns sobre os outros usando seu atributo zorder . Isso pode ser usado para ajuste fino se a ordem automática não produzir o resultado desejado. Observe, no entanto, que um zorder manual só será correto para um ângulo de visão limitado. Se a figura for girada pelo usuário, ela parecerá errada de certos ângulos.

auto_add_to_figure bool, padrão: Falso

Antes do Matplotlib 3.4, o Axes3D se adicionava à figura do host no init. Outra classe Axes não faz isso.

Esse comportamento foi obsoleto na versão 3.4, o padrão foi alterado para False na versão 3.6. A palavra-chave será não documentada e um valor não-False será um erro em 3.7.

focal_length flutuante, padrão: nenhum

Para um tipo de projeção 'persp', a distância focal da câmera virtual. Deve ser > 0. Se Nenhum, o padrão é 1. Para um tipo de projeção 'orto', deve ser definido como Nenhum ou infinito (numpy.inf). Se Nenhum, o padrão é infinito. A distância focal pode ser calculada a partir de um campo de visão desejado por meio da equação: focal_length = 1/tan(FOV/2)

** kwargs

Outros argumentos de palavra-chave opcionais:

Propriedade	Descrição
adjustable	{'caixa', 'dados'}
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
anchor	(float, float) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
autoscale_on	bool
autoscalex_on	desconhecido
autoscaley_on	desconhecido
autoscalez_on	desconhecido
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool ou 'linha'
box_aspect	3 tuplas de floats ou None
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
facecolorou fc	cor
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	objeto
mouseover	bool
navigate	bool
navigate_mode	desconhecido
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	[esquerda, inferior, largura, altura] ouBbox
proj_type	{'persp', 'orto'}
prop_cycle	desconhecido
rasterization_zorder	flutuante ou nenhum
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
title	desconhecido
transform	Transform
url	str
visible	bool
xbound	desconhecido
xlabel	str
xlimou xlim3d	(inferior: flutuar, superior: flutuar)
xlim3d	(inferior: flutuar, superior: flutuar)
xmargin	flutuação maior que -0,5
xscale	desconhecido
xticklabels	desconhecido
xticks	desconhecido
ybound	desconhecido
ylabel	str
ylimou ylim3d	(inferior: flutuar, superior: flutuar)
ylim3d	(inferior: flutuar, superior: flutuar)
ymargin	flutuação maior que -0,5
yscale	desconhecido
yticklabels	desconhecido
yticks	desconhecido
zbound	desconhecido
zlabel	desconhecido
zlimou zlim3d	desconhecido
zmargin	flutuação maior que -0,5
zorder	flutuador
zscale	desconhecido
zticklabels	desconhecido
zticks	desconhecido

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

Adicione um objeto de coleção 3D ao gráfico.

Os tipos de coleção 2D são convertidos em uma versão 3D modificando o objeto e adicionando informações de coordenada z.

São suportados:

• PolyCollection

• LineCollection

• PatchCollection

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

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

apply_aspect ( posição = Nenhum )

Ajuste os eixos para uma proporção de aspecto de dados especificada.

Dependendo get_adjustabledisso, modificará a caixa dos eixos (posição) ou os limites da vista. No primeiro caso, get_anchorafetará a posição.

Parâmetros :

posição Nenhum ou .Bbox

Caso contrário None, isso define a posição dos eixos dentro da figura como uma Bbox. Consulte get_position para mais detalhes.

Veja também

matplotlib.axes.Axes.set_aspect

Para obter uma descrição do tratamento da relação de aspecto.

matplotlib.axes.Axes.set_adjustable

Defina como os eixos se ajustam para atingir a proporção necessária.

matplotlib.axes.Axes.set_anchor

Defina a posição em caso de espaço extra.

Notas

Isso é chamado automaticamente quando cada eixo é desenhado. Você mesmo pode precisar chamá-lo se precisar atualizar a posição dos eixos e/ou visualizar os limites antes que a Figura seja desenhada.

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

autoscale ( enable = True , axis = 'both' , tight = None )

Método de conveniência para dimensionamento automático de exibição de eixo simples.

Veja Axes.autoscalea documentação completa. Como esta função se aplica a eixos 3D, o eixo também pode ser definido como 'z' e definir o eixo como 'ambos' dimensiona automaticamente todos os três eixos.

autoscale_view ( tight = None , scalex = True , scaley = True , scalez = True )

Escale automaticamente os limites de exibição usando os limites de dados.

Veja Axes.autoscale_viewa documentação completa. Como esta função se aplica a eixos 3D, ela também recebe um argumento scalez .

bar ( esquerda , altura , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs )

Adicione barra(s) 2D.

Parâmetros :

tipo array 1D esquerdo

As coordenadas x dos lados esquerdos das barras.

altura 1D semelhante a array

A altura das barras.

zs float ou tipo array 1D

Coordenada Z das barras; se um único valor for especificado, ele será usado para todas as barras.

zdir {'x', 'y', 'z'}, padrão: 'z'

Ao plotar dados 2D, a direção a ser usada como z ('x', 'y' ou 'z').

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

** kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.bar.

Devoluções :

mpl_toolkits.mplot3d.art3d.Patch3DCollection

bar3d ( x , y , z , dx , dy , dz , color = None , zsort = 'average' , shade = True , lightsource = None , * args , data = None , ** kwargs )

Gere um gráfico de barras 3D.

Este método cria gráficos de barras tridimensionais onde a largura, profundidade, altura e cor das barras podem ser definidas exclusivamente.

Parâmetros :

tipo matriz x, y, z

As coordenadas do ponto de ancoragem das barras.

dx, dy, dz float ou array-like

A largura, profundidade e altura das barras, respectivamente.

seqüência de cores de cores, opcional

A cor das barras pode ser especificada globalmente ou individualmente. Este parâmetro pode ser:

• Uma única cor, para colorir todas as barras da mesma cor.

• Uma matriz de cores de N barras de comprimento, para colorir cada barra independentemente.

• Uma matriz de cores de comprimento 6, para colorir as faces das barras de forma semelhante.

• Uma matriz de cores de comprimento 6 * N barras, para colorir cada face independentemente.

Ao colorir especificamente as faces das caixas, esta é a ordem da coloração:

1. -Z (fundo da caixa)

2. +Z (topo da caixa)

3. -Y

4. +Y

5. -X

6. +X

zsort str, opcional

O esquema de ordenação do eixo z passou paraPoly3DCollection

shade bool, padrão: True

Quando verdadeiro, sombreia os lados escuros das barras (em relação à fonte de luz do gráfico).

fonte de luzLightSource

A fonte de luz a ser usada quando a sombra é True.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

** kwargs

Quaisquer argumentos de palavra-chave adicionais são passados ​​para Poly3DCollection.

Devoluções :

coleçãoPoly3DCollection

Uma coleção de polígonos tridimensionais representando as barras.

can_pan ( )

Retorna se este eixo suporta a funcionalidade do botão panorâmico/zoom.

Os objetos Axes3d não usam o botão panorâmico/zoom.

can_zoom ( )

Retorna se este eixo suporta a funcionalidade do botão da caixa de zoom.

Os objetos Axes3D não usam o botão da caixa de zoom.

clabel ( * args , ** kwargs )

Atualmente não implementado para eixos 3D e retorna None .

claro ( )

Limpe os eixos.

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

Crie um gráfico de contorno 3D.

Parâmetros :

X, Y, Z tipo matriz,

Dados de entrada. Consulte Axes.contouras formas de dados com suporte.

extend3d bool, padrão: Falso

Se deve estender o contorno em 3D.

passo int

Tamanho do passo para estender o contorno.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.contour.

Devoluções :

matplotlib.contour.QuadContourSet

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

Crie um gráfico de contorno 3D.

Parâmetros :

X, Y, Z tipo matriz,

Dados de entrada. Consulte Axes.contouras formas de dados com suporte.

extend3d bool, padrão: Falso

Se deve estender o contorno em 3D.

passo int

Tamanho do passo para estender o contorno.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.contour.

Devoluções :

matplotlib.contour.QuadContourSet

contornof ( X , Y , Z , * args , zdir = 'z' , deslocamento = Nenhum , dados = Nenhum , ** kwargs )

Crie uma plotagem de contorno preenchida em 3D.

Parâmetros :

X, Y, Z semelhante a matriz

Dados de entrada. Consulte Axes.contourfas formas de dados com suporte.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.contourf.

Devoluções :

matplotlib.contour.QuadContourSet

contornof3D ( X , Y , Z , * args , zdir = 'z' , deslocamento = Nenhum , dados = Nenhum , ** kwargs )

Crie uma plotagem de contorno preenchida em 3D.

Parâmetros :

X, Y, Z semelhante a matriz

Dados de entrada. Consulte Axes.contourfas formas de dados com suporte.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.contourf.

Devoluções :

matplotlib.contour.QuadContourSet

convert_zunits ( z )

Para artistas em um Axes, se o zaxis tiver suporte a unidades, converta z usando o tipo de unidade zaxis

disable_mouse_rotation ( )

Desative os botões do mouse para rotação e zoom 3D.

propriedade dist

desenhar ( renderizador )

Desenhe o Artista (e seus filhos) usando o renderizador fornecido.

Isso não tem efeito se o artista não estiver visível ( Artist.get_visible retorna False).

Parâmetros :

subclasse do renderizador .RendererBase

Notas

Este método é substituído nas subclasses Artist.

errorbar ( x , y , z , zerr = None , yerr = None , xerr = None , fmt = '' , barsabove = False , errorevery = 1 , ecolor = None , elinewidth = None , capsize = None , capthick = None , xlolims = Falso , xuplims= Falso , ylolims = Falso , yuplims = Falso , zlolims = Falso , zuplims = Falso , * , dados = Nenhum , ** kwargs )

Trace linhas e/ou marcadores com barras de erro ao redor deles.

x / y / z definem os locais dos dados e xerr / yerr / zerr definem os tamanhos da barra de erro. Por padrão, isso desenha os marcadores/linhas de dados, bem como as barras de erro. Use fmt='none' para desenhar somente barras de erro.

Parâmetros :

x, y, z float ou array-like

As posições de dados.

xerr, yerr, zerr float ou array-like, forma (N,) ou (2, N), opcional

Os tamanhos da barra de erro:

• escalar: Valores +/- simétricos para todos os pontos de dados.

• shape(N,): Valores +/- simétricos para cada ponto de dados.

• shape(2, N): Separe os valores - e + para cada barra. A primeira linha contém os erros inferiores, a segunda linha contém os erros superiores.

• Nenhum : Nenhuma barra de erro.

Observe que todas as matrizes de erro devem ter valores positivos .

fmt str, padrão: ''

O formato para os pontos de dados/linhas de dados. Consulte plotpara obter detalhes.

Use 'none' (sem distinção entre maiúsculas e minúsculas) para plotar barras de erro sem nenhum marcador de dados.

cor ecolor , padrão: nenhum

A cor das linhas da barra de erro. Se Nenhum, use a cor da linha que conecta os marcadores.

elinewidth flutuante, padrão: nenhum

A largura de linha das linhas da barra de erro. Se Nenhum, a largura de linha do estilo atual é usada.

capsize float, padrão: rcParams["errorbar.capsize"](padrão: 0.0)

O comprimento da barra de erro é limitado em pontos.

capthick float, padrão: nenhum

Um alias para o argumento de palavra-chave markeredgewidth (também conhecido como mew ). Essa configuração é um nome mais sensato para a propriedade que controla a espessura da tampa da barra de erro em pontos. Para compatibilidade com versões anteriores, se mew ou markeredgewidth forem fornecidos, eles substituirão capthick . Isso pode mudar em versões futuras.

barsabove bool, padrão: False

Se for True, irá plotar as barras de erro acima dos símbolos de plotagem. O padrão está abaixo.

xlolims, ylolims, zlolims bool, padrão: Falso

Esses argumentos podem ser usados ​​para indicar que um valor fornece apenas limites inferiores. Nesse caso, um símbolo de circunflexo é usado para indicar isso. lims -argumentos podem ser escalares ou semelhantes a matrizes do mesmo tamanho que os erros. Para usar limites com eixos invertidos, set_xlimou set_ylimdeve ser chamado antes errorbar. Observe os nomes complicados dos parâmetros: definir, por exemplo, ylolims como True significa que o valor y é um limite inferior do valor True, portanto, apenas uma seta apontando para cima será desenhada!

xuplims, yuplims, zuplims bool, padrão: Falso

O mesmo que acima, mas para controlar os limites superiores.

errorevery int ou (int, int), padrão: 1

desenha barras de erro em um subconjunto dos dados. errorevery =N desenha barras de erro nos pontos (x[::N], y[::N], z[::N]). errorevery =(início, N) desenha barras de erro nos pontos (x[início::N], y[início::N], z[início::N]). por exemplo, errorevery=(6, 3) adiciona barras de erro aos dados em (x[6], x[9], x[12], x[15], ...). Usado para evitar a sobreposição de barras de erro quando duas séries compartilham valores do eixo x.

Devoluções :

lista de linhas de erro

Lista de Line3DCollectioninstâncias, cada uma contendo uma linha de barra de erro.

lista de letras maiúsculas

Lista de Line3Dinstâncias, cada uma contendo um objeto capline.

lista de limites

Lista de Line3Dinstâncias, cada uma contendo um marcador com um limite superior ou inferior.

Outros Parâmetros :

objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

x , y , z , xerr , yerr , zerr

** kwargs

Todos os outros argumentos de palavra-chave para estilizar as linhas da barra de erro são passados Line3DCollection.

Exemplos

( Código fonte , png )

format_coord ( xd , yd )

Dadas as coordenadas da visualização 2D, tente adivinhar uma coordenada 3D. Procura a aresta mais próxima do ponto e assume que o ponto está na mesma localização z do ponto mais próximo da aresta.

format_zdata ( z )

Retorna a string z formatada. Esta função usará o fmt_zdataatributo se for possível chamá-lo, caso contrário, recorrerá ao formatador principal zaxis

get_autoscalez_on ( )

Retorna se o zaxis é dimensionado automaticamente.

get_axis_position ( )

get_frame_on ( )

Obtenha se os painéis de eixos 3D são desenhados.

get_proj ( )

Crie a matriz de projeção a partir da posição de visualização atual.

get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False )

Retorne a caixa delimitadora apertada dos Axes, incluindo o eixo e seus decoradores (xlabel, título, etc).

Artistas que não artist.set_in_layout(False)estão incluídos no bbox.

Parâmetros :

subclasse do renderizadorRendererBase

renderizador que será usado para desenhar as figuras (ie fig.canvas.get_renderer())

bbox_extra_artists lista de ArtistouNone

Lista de artistas a serem incluídos na caixa delimitadora restrita. Se None(padrão), todos os artistas filhos dos Axes são incluídos na caixa delimitadora compacta.

call_axes_locator bool, padrão: True

Se call_axes_locator for False, ele não chamará o _axes_locatoratributo, que é necessário para obter a caixa delimitadora correta. call_axes_locator=Falsepode ser usado se o chamador estiver interessado apenas no tamanho relativo do tightbbox em comparação com o Axes bbox.

for_layout_only padrão: Falso

A caixa delimitadora não incluirá a extensão x do título e o xlabel ou a extensão y do ylabel.

Devoluções :

BboxBase

Caixa delimitadora em coordenadas de pixel de figura.

Veja também

matplotlib.axes.Axes.get_window_extent

matplotlib.axis.Axis.get_tightbbox

matplotlib.spines.Spine.get_window_extent

get_w_lims ( )

Obtenha limites mundiais em 3D.

get_xlim ( )

Retorne os limites de visualização do eixo x.

Devoluções :

esquerda, direita (flutuar, flutuar)

Os limites atuais do eixo x nas coordenadas de dados.

Veja também

Axes.set_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

Notas

O eixo x pode ser invertido, caso em que o valor esquerdo será maior que o valor direito .

get_xlim3d ( )

Alias ​​para get_xlim.

get_ylim ( )

Retorne os limites de visualização do eixo y.

Devoluções :

inferior, superior (flutuar, flutuar)

Os limites atuais do eixo y em coordenadas de dados.

Veja também

Axes.set_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

Notas

O eixo y pode ser invertido, caso em que o valor inferior será maior que o valor superior .

get_ylim3d ( )

Alias ​​para get_ylim.

get_zaxis ( )

Retorne a instância ZAxis( ).Axis

get_zbound ( )

Retorne os limites inferior e superior do eixo z, em ordem crescente.

get_zgridlines ( )

Retorna as linhas de grade do zaxis como uma lista de Line2Ds.

get_zlabel ( )

Obtenha a sequência de texto do rótulo z.

get_zlim ( )

Obtenha limites z 3D.

get_zlim3d ( )

Alias ​​para get_zlim.

get_zmajorticklabels ( )

Retorna os principais rótulos de escala do zaxis, como uma lista de Text.

get_zminorticklabels ( )

Retorna os rótulos de ticks menores do zaxis, como uma lista de Text.

get_zscale ( )

Retorne a escala do zaxis (como um str).

get_zticklabels ( menor = Falso , qual = Nenhum )

Obtenha os rótulos dos tiques dos zaxis.

Parâmetros :

bool menor

Se deve retornar os rótulos menores ou maiores.

qual Nenhum, ('menor', 'maior', 'ambos')

Substitui menor .

Seleciona quais marcadores retornar

Devoluções :

lista deText

get_zticklines ( menor = Falso )

Retorna as linhas de marcação do zaxis como uma lista de Line2Ds.

get_zticks ( * , menor = Falso )

Retorna as localizações dos ticks do zaxis nas coordenadas de dados.

As localizações não são cortadas nos limites do eixo atual e, portanto, podem conter localizações que não são visíveis na saída.

Parâmetros :

bool menor , padrão: False

True para retornar as direções de marcação secundárias, False para retornar as direções de marcação principais.

Devoluções :

matriz numpy de locais de marcação

grade ( visível = True , ** kwargs )

Definir/desativar grade 3D.

Observação

Atualmente, esta função não se comporta da mesma forma que axes.Axes.grid, mas destina-se a eventualmente suportar esse comportamento.

invert_zaxis ( )

Inverta o eixo z.

margens ( * margens , x = Nenhum , y = Nenhum , z = Nenhum , apertado = Verdadeiro )

Defina ou recupere margens de escala automática.

Veja Axes.marginsa documentação completa. Como esta função se aplica a eixos 3D, ela também recebe um argumento z e retorna .(xmargin, ymargin, zmargin)

mouse_init ( rotate_btn = 1 , zoom_btn = 3 )

Defina os botões do mouse para rotação e zoom 3D.

Parâmetros :

rotate_btn int ou lista de int, padrão: 1

O botão ou botões do mouse a serem usados ​​para rotação 3D dos eixos.

zoom_btn int ou lista de int, padrão: 3

O botão ou botões do mouse a serem usados ​​para ampliar os eixos 3D.

nome = '3d'

plot ( xs , ys , * args , zdir = 'z' , ** kwargs )

Plote dados 2D ou 3D.

Parâmetros :

xs 1D semelhante a array

x coordenadas dos vértices.

ys 1D tipo array

coordenadas y dos vértices.

zs float ou tipo array 1D

coordenadas z dos vértices; um para todos os pontos ou um para cada ponto.

zdir {'x', 'y', 'z'}, padrão: 'z'

Ao plotar dados 2D, a direção a ser usada como z ('x', 'y' ou 'z').

** kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.plot.

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

Plote dados 2D ou 3D.

Parâmetros :

xs 1D semelhante a array

x coordenadas dos vértices.

ys 1D tipo array

coordenadas y dos vértices.

zs float ou tipo array 1D

coordenadas z dos vértices; um para todos os pontos ou um para cada ponto.

zdir {'x', 'y', 'z'}, padrão: 'z'

Ao plotar dados 2D, a direção a ser usada como z ('x', 'y' ou 'z').

** kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.plot.

plot_surface ( X , Y , Z , * , norm = Nenhum , vmin = Nenhum , vmax = Nenhum , lightsource = Nenhum , ** kwargs )

Crie um gráfico de superfície.

Por padrão, ele será colorido em tons de uma cor sólida, mas também suporta mapeamento de cores fornecendo o argumento cmap .

Observação

Os kwargs rcount e ccount , cujo padrão é 50, determinam o número máximo de amostras usadas em cada direção. Se os dados de entrada forem maiores, serão reduzidos (por divisão) para esses números de pontos.

Observação

Para maximizar a velocidade de renderização, considere definir rstride e cstride como divisores do número de linhas menos 1 e colunas menos 1, respectivamente. Por exemplo, dado 51 linhas, rstride pode ser qualquer um dos divisores de 50.

Da mesma forma, uma configuração de rstride e cstride igual a 1 (ou rcount e ccount igual ao número de linhas e colunas) pode usar o caminho otimizado.

Parâmetros :

Matrizes 2D X, Y, Z

Valores de dados.

rcount, ccount int

Número máximo de amostras usadas em cada direção. Se os dados de entrada forem maiores, serão reduzidos (por divisão) para esses números de pontos. O padrão é 50.

rstride, cstride int

Downsampling passo em cada direção. Esses argumentos são mutuamente exclusivos com rcount e ccount . Se apenas um de rstride ou cstride for definido, o outro será padronizado para 10.

O modo 'clássico' usa um padrão de em vez do novo padrão de .rstride = cstride = 10rcount = ccount = 50

cor semelhante a cor

Cor das manchas de superfície.

cmap Mapa de cores

Mapa de cores das manchas de superfície.

facecolors semelhante a uma matriz de cores.

Cores de cada patch individual.

norma normalizar

Normalização para o mapa de cores.

vmin, vmax flutuante

Limites para a normalização.

shade bool, padrão: True

Se deve sombrear as cores do rosto. O sombreamento é sempre desabilitado quando cmap é especificado.

fonte de luzLightSource

A fonte de luz a ser usada quando a sombra é True.

** kwargs

Outros argumentos são encaminhados para Poly3DCollection.

plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs )

Traçar uma superfície triangular.

A triangulação (opcional) pode ser especificada de duas maneiras; qualquer:

plot_trisurf(triangulation, ...)

onde a triangulação é um Triangulationobjeto, ou:

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

caso em que um objeto de Triangulação será criado. Consulte Triangulationpara obter uma explicação dessas possibilidades.

Os restantes argumentos são:

plot_trisurf(..., Z)

onde Z é a matriz de valores a contornar, um por ponto na triangulação.

Parâmetros :

X, Y, Z semelhante a matriz

Valores de dados como matrizes 1D.

cor

Cor das manchas de superfície.

cmap

Um mapa de cores para os patches de superfície.

norma normalizar

Uma instância de Normalize para mapear valores para cores.

vmin, vmax flutuante, padrão: nenhum

Valor mínimo e máximo a mapear.

shade bool, padrão: True

Se deve sombrear as cores do rosto. O sombreamento é sempre desabilitado quando cmap é especificado.

fonte de luzLightSource

A fonte de luz a ser usada quando a sombra é True.

** kwargs

Todos os outros argumentos são passados ​​para Poly3DCollection

Exemplos

( Código fonte , png )

( Código fonte , png )

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

Plote um wireframe 3D.

Observação

Os kwargs rcount e ccount , cujo padrão é 50, determinam o número máximo de amostras usadas em cada direção. Se os dados de entrada forem maiores, serão reduzidos (por divisão) para esses números de pontos.

Parâmetros :

Matrizes 2D X, Y, Z

Valores de dados.

rcount, ccount int

Número máximo de amostras usadas em cada direção. Se os dados de entrada forem maiores, serão reduzidos (por divisão) para esses números de pontos. Definir uma contagem como zero faz com que os dados não sejam amostrados na direção correspondente, produzindo um gráfico de linha 3D em vez de um gráfico de estrutura de arame. O padrão é 50.

rstride, cstride int

Downsampling passo em cada direção. Esses argumentos são mutuamente exclusivos com rcount e ccount . Se apenas um de rstride ou cstride for definido, o outro padrão será 1. Definir um passo como zero faz com que os dados não sejam amostrados na direção correspondente, produzindo um gráfico de linha 3D em vez de um gráfico de estrutura de arame.

O modo 'clássico' usa um padrão de em vez do novo padrão de .rstride = cstride = 1rcount = ccount = 50

** kwargs

Outros argumentos são encaminhados para Line3DCollection.

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

Traçar um campo 3D de setas.

Os argumentos podem ser do tipo array ou escalares, desde que possam ser transmitidos juntos. Os argumentos também podem ser matrizes mascaradas. Se um elemento em qualquer um dos argumentos for mascarado, o elemento quiver correspondente não será plotado.

Parâmetros :

X, Y, Z semelhante a matriz

As coordenadas x, y e z das localizações das setas (o padrão é a cauda da seta; consulte pivô kwarg).

Tipo de matriz U, V, W

Os componentes x, y e z dos vetores de seta.

flutuação de comprimento , padrão: 1

O comprimento de cada aljava.

arrow_length_ratio flutuante, padrão: 0,3

A proporção da ponta da flecha em relação à aljava.

pivô {'cauda', 'meio', 'ponta'}, padrão: 'cauda'

A parte da seta que está no ponto da grade; a seta gira em torno desse ponto, daí o nome pivô .

normalizar bool, padrão: False

Se todas as setas são normalizadas para ter o mesmo comprimento ou manter os comprimentos definidos por u , v e w .

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

** kwargs

Quaisquer argumentos de palavra-chave adicionais são delegados para LineCollection

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

Traçar um campo 3D de setas.

Os argumentos podem ser do tipo array ou escalares, desde que possam ser transmitidos juntos. Os argumentos também podem ser matrizes mascaradas. Se um elemento em qualquer um dos argumentos for mascarado, o elemento quiver correspondente não será plotado.

Parâmetros :

X, Y, Z semelhante a matriz

As coordenadas x, y e z das localizações das setas (o padrão é a cauda da seta; consulte pivô kwarg).

Tipo de matriz U, V, W

Os componentes x, y e z dos vetores de seta.

flutuação de comprimento , padrão: 1

O comprimento de cada aljava.

arrow_length_ratio flutuante, padrão: 0,3

A proporção da ponta da flecha em relação à aljava.

pivô {'cauda', 'meio', 'ponta'}, padrão: 'cauda'

A parte da seta que está no ponto da grade; a seta gira em torno desse ponto, daí o nome pivô .

normalizar bool, padrão: False

Se todas as setas são normalizadas para ter o mesmo comprimento ou manter os comprimentos definidos por u , v e w .

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

** kwargs

Quaisquer argumentos de palavra-chave adicionais são delegados para LineCollection

scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = Nenhum , depthshade = True , * args , dados = Nenhum , ** kwargs )

Crie um gráfico de dispersão.

Parâmetros :

xs, ys tipo array

As posições de dados.

zs float ou tipo array, padrão: 0

As posições z. Uma matriz do mesmo comprimento que xs e ys ou um único valor para colocar todos os pontos no mesmo plano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, padrão: 'z'

A direção do eixo para o zs . Isso é útil ao plotar dados 2D em eixos 3D. Os dados devem ser passados ​​como xs , ys . Definir zdir como 'y' plota os dados no plano xz.

Consulte também Plotar dados 2D em plotagem 3D .

s float ou tipo array, padrão: 20

O tamanho do marcador em pontos**2. Uma matriz do mesmo comprimento que xs e ys ou um único valor para tornar todos os marcadores do mesmo tamanho.

c cor, sequência ou sequência de cores, opcional

A cor do marcador. Valores possíveis:

• Uma string de formato de cor única.

• Uma sequência de cores de comprimento n.

• Uma sequência de n números a serem mapeados para cores usando cmap e norm .

• Uma matriz 2D na qual as linhas são RGB ou RGBA.

Para obter mais detalhes, consulte o argumento cscatter de .

depthshade bool, padrão: True

Se deve sombrear os marcadores de dispersão para dar a aparência de profundidade. Cada chamada para scatter()executará seu sombreamento de profundidade de forma independente.

objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

xs , ys , zs , s , cores de borda , c , facecolor , facecolors , cor

** kwargs

Todos os outros argumentos são passados ​​para scatter.

Devoluções :

caminhosPathCollection

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

Crie um gráfico de dispersão.

Parâmetros :

xs, ys tipo array

As posições de dados.

zs float ou tipo array, padrão: 0

As posições z. Uma matriz do mesmo comprimento que xs e ys ou um único valor para colocar todos os pontos no mesmo plano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, padrão: 'z'

A direção do eixo para o zs . Isso é útil ao plotar dados 2D em eixos 3D. Os dados devem ser passados ​​como xs , ys . Definir zdir como 'y' plota os dados no plano xz.

Consulte também Plotar dados 2D em plotagem 3D .

s float ou tipo array, padrão: 20

O tamanho do marcador em pontos**2. Uma matriz do mesmo comprimento que xs e ys ou um único valor para tornar todos os marcadores do mesmo tamanho.

c cor, sequência ou sequência de cores, opcional

A cor do marcador. Valores possíveis:

• Uma string de formato de cor única.

• Uma sequência de cores de comprimento n.

• Uma sequência de n números a serem mapeados para cores usando cmap e norm .

• Uma matriz 2D na qual as linhas são RGB ou RGBA.

Para obter mais detalhes, consulte o argumento cscatter de .

depthshade bool, padrão: True

Se deve sombrear os marcadores de dispersão para dar a aparência de profundidade. Cada chamada para scatter()executará seu sombreamento de profundidade de forma independente.

objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

xs , ys , zs , s , cores de borda , c , facecolor , facecolors , cor

** kwargs

Todos os outros argumentos são passados ​​para scatter.

Devoluções :

caminhosPathCollection

set ( * , ajustável=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , âncora=<UNSET> , animada=<UNSET> , aspecto=<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> , cor do rosto=<UNSET> , frame_on=<UNSET>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , navegue=<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=< UNSET> , visível=<UNSET>, 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=<UNSET> , zlim3d=<UNSET>, zmargin=<UNSET> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
adjustable	{'caixa', 'dados'}
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
anchor	(float, float) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
autoscale_on	bool
autoscalex_on	desconhecido
autoscaley_on	desconhecido
autoscalez_on	desconhecido
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool ou 'linha'
box_aspect	3 tuplas de floats ou None
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
facecolorou fc	cor
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	objeto
mouseover	bool
navigate	bool
navigate_mode	desconhecido
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	[esquerda, inferior, largura, altura] ouBbox
proj_type	{'persp', 'orto'}
prop_cycle	desconhecido
rasterization_zorder	flutuante ou nenhum
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
title	desconhecido
transform	Transform
url	str
visible	bool
xbound	desconhecido
xlabel	str
xlim	(inferior: flutuar, superior: flutuar)
xlim3d	(inferior: flutuar, superior: flutuar)
xmargin	flutuação maior que -0,5
xscale	desconhecido
xticklabels	desconhecido
xticks	desconhecido
ybound	desconhecido
ylabel	str
ylim	(inferior: flutuar, superior: flutuar)
ylim3d	(inferior: flutuar, superior: flutuar)
ymargin	flutuação maior que -0,5
yscale	desconhecido
yticklabels	desconhecido
yticks	desconhecido
zbound	desconhecido
zlabel	desconhecido
zlim	desconhecido
zlim3d	desconhecido
zmargin	flutuação maior que -0,5
zorder	flutuador
zscale	desconhecido
zticklabels	desconhecido
zticks	desconhecido

set_aspect ( aspecto , ajustável = Nenhum , âncora = Nenhum , compartilhamento = Falso )

Defina as proporções.

Parâmetros :

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

Valores possíveis:

valor	Descrição
'auto'	automático; preencha o retângulo de posição com dados.
'igual'	adaptar todos os eixos para terem proporções iguais.
'igual'	adapte os eixos x e y para que tenham proporções iguais.
'igualxz'	adapte os eixos x e z para que tenham proporções iguais.
'igualar'	adapte os eixos y e z para que tenham proporções iguais.

ajustável Nenhum

Atualmente ignorado por Axes3D

Se não None , define qual parâmetro será ajustado para atender o aspecto requerido. Consulte set_adjustablepara mais detalhes.

âncora Nenhum ou str ou 2 tuplas de float, opcional

Se não for None , isso define onde os eixos serão desenhados se houver espaço extra devido a restrições de aspecto. A maneira mais comum de especificar a âncora são as abreviaturas dos pontos cardeais:

valor	Descrição
'C'	centrado
'SW'	canto inferior esquerdo
'S'	meio da borda inferior
'SE'	canto inferior direito
etc.

Consulte set_anchorpara mais detalhes.

compartilhar bool, padrão: Falso

Se True, aplique as configurações a todos os eixos compartilhados.

Veja também

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscalez_on ( b )

Defina se o zaxis é dimensionado automaticamente ao desenhar ou por Axes.autoscale_view.

Parâmetros :

b bool

set_axis_off ( )

Desligue os eixos x e y.

Isso afeta as linhas de eixo, ticks, ticklabels, grade e rótulos de eixo.

set_axis_on ( )

Ative os eixos x e y.

Isso afeta as linhas de eixo, ticks, ticklabels, grade e rótulos de eixo.

set_box_aspect ( aspecto , * , zoom = 1 )

Defina o aspecto da caixa Axes.

O aspecto da caixa é a relação entre altura e largura em unidades de exibição para cada face da caixa quando vista perpendicularmente a essa face. Isso não deve ser confundido com o aspecto de dados (que para Axes3D é sempre 'auto'). As proporções padrão são 4:4:3 (x:y:z).

Para simular um aspecto igual no espaço de dados, defina o aspecto da caixa para corresponder ao seu intervalo de dados em cada dimensão.

zoom controla o tamanho geral do Axes3D na figura.

Parâmetros :

aspecto 3-tupla de floats ou None

Altera as dimensões físicas de Axes3D, de modo que a proporção dos comprimentos dos eixos em unidades de exibição seja x:y:z. Se Nenhum, o padrão é (4,4,3).

zoom flutuante, padrão: 1

Controle o tamanho geral do Axes3D na figura. Deve ser > 0.

set_frame_on ( b )

Defina se os painéis de eixos 3D são desenhados.

Parâmetros :

b bool

set_proj_type ( proj_type , focal_length = Nenhum )

Defina o tipo de projeção.

Parâmetros :

proj_type {'persp', 'orto'}

O tipo de projeção.

focal_length flutuante, padrão: nenhum

Para um tipo de projeção 'persp', a distância focal da câmera virtual. Deve ser > 0. Se nenhum, o padrão é 1. A distância focal pode ser calculada a partir de um campo de visão desejado por meio da equação: focal_length = 1/tan(FOV/2)

set_title ( label , fontdict = None , loc = 'center' , ** kwargs )

Defina um título para os eixos.

Defina um dos três títulos de Axes disponíveis. Os títulos disponíveis são posicionados acima dos Eixos no centro, nivelados com a borda esquerda e nivelados com a borda direita.

Parâmetros :

rótulo str

Texto a ser usado para o título

ditado de fonte

Um dicionário que controla a aparência do texto do título, o fontdict padrão é:

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

loc {'centro', 'esquerda', 'direita'}, padrão: rcParams["axes.titlelocation"](padrão: 'center')

Qual título definir.

y float, padrão: rcParams["axes.titley"](padrão: None)

Localização dos eixos verticais para o título (1.0 é o topo). Se None (o padrão) e rcParams["axes.titley"](padrão: None) também for None, y é determinado automaticamente para evitar decoradores nos eixos.

pad float, padrão: rcParams["axes.titlepad"](padrão: 6.0)

O deslocamento do título do topo dos Eixos, em pontos.

Devoluções :

Text

A instância de texto matplotlib representando o título

Outros Parâmetros :

** Textpropriedades dos kwargs

Outros argumentos de palavra-chave são propriedades de texto, consulte Textpara obter uma lista de propriedades de texto válidas.

set_top_view ( )

set_xlim3d ( esquerda = Nenhum , direita = Nenhum , * , emitir = Verdadeiro , auto = Falso , xmin = Nenhum , xmax = Nenhum )

Defina os limites de exibição do eixo x.

Parâmetros :

flutuação esquerda , opcional

O xlim esquerdo em coordenadas de dados. Passar Nenhum deixa o limite inalterado.

Os xlims esquerdo e direito também podem ser passados ​​como a tupla ( left , right ) como o primeiro argumento posicional (ou como o argumento de palavra-chave left ).

flutuador direito , opcional

O xlim certo nas coordenadas de dados. Passar Nenhum deixa o limite inalterado.

emitir bool, padrão: True

Se deve notificar os observadores sobre a mudança de limite.

auto bool ou None, padrão: False

Se o dimensionamento automático do eixo x deve ser ativado. Verdadeiro ativa, Falso desativa, Nenhum permanece inalterado.

xmin, xmax flutuante, opcional

Eles são equivalentes a left e right respectivamente, e é um erro passar xmin e left ou xmax e right .

Devoluções :

esquerda, direita (flutuar, flutuar)

Os novos limites do eixo x nas coordenadas de dados.

Veja também

get_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

Notas

O valor esquerdo pode ser maior que o valor direito , caso em que os valores do eixo x diminuirão da esquerda para a direita.

Exemplos

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

Um limite pode ser deixado inalterado.

>>> set_xlim(right=right_lim)

Os limites podem ser passados ​​na ordem inversa para inverter a direção do eixo x. Por exemplo, suponha que x represente o número de anos antes do presente. Os limites do eixo x podem ser definidos como o seguinte, de modo que 5.000 anos atrás esteja à esquerda do gráfico e o presente à direita.

>>> set_xlim(5000, 0)

set_xscale ( valor , ** kwargs )

Defina a escala do eixo x.

Parâmetros :

valor {"linear"}

O tipo de escala do eixo a ser aplicado. Os eixos 3D atualmente suportam apenas escalas lineares; outras escalas produzem resultados absurdos.

** kwargs

Os argumentos de palavra-chave são encaminhados nominalmente para a classe de escala, mas nenhum deles é aplicável para escalas lineares.

set_ylim3d ( bottom = None , top = None , * , emit = True , auto = False , ymin = None , ymax = None )

Defina os limites de visualização do eixo y.

Parâmetros :

flutuador inferior , opcional

O ylim inferior em coordenadas de dados. Passar Nenhum deixa o limite inalterado.

Os ylims bottom e top também podem ser passados ​​como a tupla ( bottom , top ) como o primeiro argumento posicional (ou como o argumento de palavra-chave bottom ).

flutuador superior , opcional

O ylim superior em coordenadas de dados. Passar Nenhum deixa o limite inalterado.

emitir bool, padrão: True

Se deve notificar os observadores sobre a mudança de limite.

auto bool ou None, padrão: False

Se o escalonamento automático do eixo y deve ser ativado. Verdadeiro ativa, Falso desativa, Nenhum permanece inalterado.

ymin, ymax flutuante, opcional

Eles são equivalentes a bottom e top respectivamente, e é um erro passar ymin e bottom ou ymax e top .

Devoluções :

inferior, superior (flutuar, flutuar)

Os novos limites do eixo y nas coordenadas de dados.

Veja também

get_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

Notas

O valor inferior pode ser maior que o valor superior ; nesse caso, os valores do eixo y diminuirão de baixo para cima .

Exemplos

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

Um limite pode ser deixado inalterado.

>>> set_ylim(top=top_lim)

Os limites podem ser passados ​​na ordem inversa para inverter a direção do eixo y. Por exemplo, suponha que yrepresente a profundidade do oceano em m. Os limites do eixo y podem ser definidos como a seguir, de modo que a profundidade de 5.000 m esteja na parte inferior do gráfico e a superfície, 0 m, esteja no topo.

>>> set_ylim(5000, 0)

set_yscale ( valor , ** kwargs )

Defina a escala do eixo y.

Parâmetros :

valor {"linear"}

O tipo de escala do eixo a ser aplicado. Os eixos 3D atualmente suportam apenas escalas lineares; outras escalas produzem resultados absurdos.

** kwargs

Os argumentos de palavra-chave são encaminhados nominalmente para a classe de escala, mas nenhum deles é aplicável para escalas lineares.

set_zbound ( inferior = Nenhum , superior = Nenhum )

Defina os limites numéricos inferior e superior do eixo z.

Este método respeitará a inversão dos eixos independentemente da ordem dos parâmetros. Isso não mudará a configuração de dimensionamento automático ( get_autoscalez_on()).

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

Definir zlabel. Veja doc set_ylabelpara descrição.

set_zlim ( fundo = Nenhum , topo = Nenhum , * , emit = Verdadeiro , auto = Falso , zmin = Nenhum , zmax = Nenhum )

Defina os limites 3D z.

Veja Axes.set_ylima documentação completa

set_zlim3d ( bottom = None , top = None , * , emit = True , auto = False , zmin = None , zmax = None )

Alias ​​para set_zlim.

set_zmargin ( m )

Defina o preenchimento dos limites de dados Z antes do dimensionamento automático.

m vezes o intervalo de dados será adicionado a cada extremidade desse intervalo antes de ser usado no escalonamento automático. Se m for negativo, isso cortará o intervalo de dados em vez de expandi-lo.

Por exemplo, se seus dados estiverem no intervalo [0, 2], uma margem de 0,1 resultará em um intervalo [-0,2, 2,2]; uma margem de -0,1 resultará em um intervalo de [0,2, 1,8].

Parâmetros :

m flutuante maior que -0,5

set_zscale ( valor , ** kwargs )

Defina a escala do eixo z.

Parâmetros :

valor {"linear"}

O tipo de escala do eixo a ser aplicado. Os eixos 3D atualmente suportam apenas escalas lineares; outras escalas produzem resultados absurdos.

** kwargs

Os argumentos de palavra-chave são encaminhados nominalmente para a classe de escala, mas nenhum deles é aplicável para escalas lineares.

set_zticklabels ( labels , * , fontdict = None , minor = False , ** kwargs )

Defina os rótulos dos zaxis com a lista de rótulos de string.

Aviso

Este método só deve ser usado após fixar as posições dos ticks usando Axes3D.set_zticks. Caso contrário, as etiquetas podem ficar em posições inesperadas.

Parâmetros :

lista de marcadores de str

Os textos da etiqueta.

ditado fontdict , opcional

Um dicionário que controla a aparência dos ticklabels. O fontdict padrão é:

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

bool menor , padrão: False

Se deve definir os rótulos secundários em vez dos principais.

Devoluções :

lista deText

Os rótulos.

Outros Parâmetros :

** Textpropriedades kwargs.

set_zticks ( ticks , labels = None , * , minor = False , ** kwargs )

Defina os locais dos tiques do zaxis e, opcionalmente, os rótulos.

Se necessário, os limites de visualização do Eixo são expandidos para que todos os ticks fornecidos fiquem visíveis.

Parâmetros :

lista de carrapatos de carros alegóricos

Lista de locais de marcação. O eixo Locatoré substituído por um FixedLocator.

Alguns formatadores de ticks não rotularão posições arbitrárias de ticks; por exemplo, os formatadores de log apenas rotulam os ticks de década por padrão. Nesse caso, você pode definir um formatador explicitamente no eixo usando Axis.set_major_formatterou fornecer rótulos formatados por conta própria.

lista de rótulos de str, opcional

Lista de rótulos de escala. Se não definido, os rótulos são gerados com o tick do eixo Formatter.

bool menor , padrão: False

Se False, defina os ticks principais; se True, o menor marca.

** kwargs

Textpropriedades para os rótulos. Eles terão efeito somente se você passar rótulos . Em outros casos, use tick_params.

Notas

A expansão obrigatória dos limites de visualização é uma escolha de design intencional para evitar a surpresa de um tick não visível. Se precisar de outros limites, você deve definir os limites explicitamente após definir os tiques.

sharez ( outros )

Compartilhe o eixo z com outros arquivos .

Isso equivale a passar sharex=otherao construir os eixos e não pode ser usado se o eixo z já estiver sendo compartilhado com outros eixos.

stem ( x , y , z , * , linefmt = ' C0-' , marcadorfmt = 'C0o' , basefmt = ' C3- ' , bottom = 0 , label = Nenhum , orientação = ' z ' , dados = Nenhum )

Crie um gráfico de haste 3D.

Um gráfico de haste desenha linhas perpendiculares a uma linha de base e coloca marcadores nas cabeças. Por padrão, a linha de base é definida por x e y , e as hastes são desenhadas verticalmente de baixo para z .

Parâmetros :

tipo matriz x, y, z

As posições das cabeças das hastes. As hastes são desenhadas ao longo da orientação -direção da linha de base na parte inferior (na orientação -coordenada) até as cabeças. Por padrão, as posições x e y são usadas para a linha de base e z para a posição da cabeça, mas isso pode ser alterado pela orientação .

linefmt str, padrão: 'C0-'

Uma string que define as propriedades das linhas verticais. Normalmente, será uma cor ou uma cor e um estilo de linha:

Personagem	estilo de linha
'-'	linha sólida
'--'	linha tracejada
'-.'	linha traço-ponto
':'	linha pontilhada

Nota: Embora seja tecnicamente possível especificar formatos válidos diferentes de cor ou cor e estilo de linha (por exemplo, 'rx' ou '-.'), isso está além da intenção do método e provavelmente não resultará em um gráfico razoável.

marcadorfmt str, padrão: 'C0o'

Uma string que define as propriedades dos marcadores nas cabeças das hastes.

basefmt str, padrão: 'C3-'

Uma string de formato que define as propriedades da linha de base.

flutuante inferior , padrão: 0

A posição da linha de base, em coordenadas de orientação .

label str, padrão: Nenhum

O rótulo a ser usado para as hastes nas legendas.

orientação {'x', 'y', 'z'}, padrão: 'z'

A direção ao longo da qual as hastes são desenhadas.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

Devoluções :

StemContainer

O contêiner pode ser tratado como uma tupla ( markerline , stemlines , baseline )

Exemplos

( Código fonte , png )

( png )

( png )

stem3D ( x , y , z , * , linefmt = ' C0-' , marcadorfmt = 'C0o' , basefmt = ' C3- ' , bottom = 0 , label = Nenhum , orientação = ' z ' , dados = Nenhum )

Crie um gráfico de haste 3D.

Um gráfico de haste desenha linhas perpendiculares a uma linha de base e coloca marcadores nas cabeças. Por padrão, a linha de base é definida por x e y , e as hastes são desenhadas verticalmente de baixo para z .

Parâmetros :

tipo matriz x, y, z

As posições das cabeças das hastes. As hastes são desenhadas ao longo da orientação -direção da linha de base na parte inferior (na orientação -coordenada) até as cabeças. Por padrão, as posições x e y são usadas para a linha de base e z para a posição da cabeça, mas isso pode ser alterado pela orientação .

linefmt str, padrão: 'C0-'

Uma string que define as propriedades das linhas verticais. Normalmente, será uma cor ou uma cor e um estilo de linha:

Personagem	estilo de linha
'-'	linha sólida
'--'	linha tracejada
'-.'	linha traço-ponto
':'	linha pontilhada

Nota: Embora seja tecnicamente possível especificar formatos válidos diferentes de cor ou cor e estilo de linha (por exemplo, 'rx' ou '-.'), isso está além da intenção do método e provavelmente não resultará em um gráfico razoável.

marcadorfmt str, padrão: 'C0o'

Uma string que define as propriedades dos marcadores nas cabeças das hastes.

basefmt str, padrão: 'C3-'

Uma string de formato que define as propriedades da linha de base.

flutuante inferior , padrão: 0

A posição da linha de base, em coordenadas de orientação .

label str, padrão: Nenhum

O rótulo a ser usado para as hastes nas legendas.

orientação {'x', 'y', 'z'}, padrão: 'z'

A direção ao longo da qual as hastes são desenhadas.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

Devoluções :

StemContainer

O contêiner pode ser tratado como uma tupla ( markerline , stemlines , baseline )

Exemplos

( Código fonte , png )

( png )

( png )

text ( x , y , z , s , zdir = Nenhum , ** kwargs )

Adicione texto ao gráfico. kwargs serão passados ​​para Axes.text, exceto para a palavra-chave zdir , que define a direção a ser usada como a direção z.

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

Adicione texto aos eixos.

Adicione o texto s aos eixos no local x , y nas coordenadas de dados.

Parâmetros :

x, y flutuam

A posição para colocar o texto. Por padrão, isso está em coordenadas de dados. O sistema de coordenadas pode ser alterado usando o parâmetro de transformação .

s str

O texto.

ditado fontdict , padrão: nenhum

Um dicionário para substituir as propriedades de texto padrão. Se fontdict for None, os padrões serão determinados por rcParams.

Devoluções :

Text

A Textinstância criada.

Outros Parâmetros :

** Textpropriedades kwargs.

Outros parâmetros de texto diversos.

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	desconhecido
clip_on	desconhecido
clip_path	desconhecido
colorou c	cor
figure	Figure
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

Exemplos

Argumentos de palavras-chave individuais podem ser usados ​​para substituir qualquer parâmetro:

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

A transformação padrão especifica que o texto está em coordenadas de dados, alternativamente, você pode especificar o texto em coordenadas de eixo ((0, 0) é o canto inferior esquerdo e (1, 1) é o canto superior direito). O exemplo abaixo coloca o texto no centro dos eixos:

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

Você pode colocar uma caixa retangular ao redor da instância do texto (por exemplo, para definir uma cor de fundo) usando a palavra-chave bbox . bbox é um dicionário de Rectangle propriedades. Por exemplo:

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

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

Adicione texto ao gráfico. kwargs serão passados ​​para Axes.text, exceto para a palavra-chave zdir , que define a direção a ser usada como a direção z.

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

Método de conveniência para alterar a aparência de marcas e rótulos de marcas.

Veja Axes.tick_paramsa documentação completa. Como esta função se aplica a eixos 3D, o eixo também pode ser definido como 'z' e definir o eixo como 'ambos' dimensiona automaticamente todos os três eixos.

Além disso, devido à forma como os objetos Axes3D são desenhados de forma muito diferente dos eixos 2D regulares, algumas dessas configurações podem ter um significado ambíguo. Para simplificar, o eixo 'z' aceitará as configurações como se fosse o eixo 'y'.

Observação

Axes3D atualmente ignora algumas dessas configurações.

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

Crie um gráfico de contorno 3D.

Observação

Este método atualmente produz saída incorreta devido a um bug de longa data na renderização 3D PolyCollection.

Parâmetros :

X, Y, Z semelhante a matriz

Dados de entrada. Consulte Axes.tricontouras formas de dados com suporte.

extend3d bool, padrão: Falso

Se deve estender o contorno em 3D.

passo int

Tamanho do passo para estender o contorno.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.tricontour.

Devoluções :

matplotlib.tri.tricontour.TriContourSet

tricontourf ( * args , zdir = 'z' , offset = None , data = None , ** kwargs )

Crie uma plotagem de contorno preenchida em 3D.

Observação

Este método atualmente produz saída incorreta devido a um bug de longa data na renderização 3D PolyCollection.

Parâmetros :

X, Y, Z semelhante a matriz

Dados de entrada. Consulte Axes.tricontourfas formas de dados com suporte.

zdir {'x', 'y', 'z'}, padrão: 'z'

A direção a ser usada.

deslocamento flutuante, opcional

Se especificado, trace uma projeção das linhas de contorno nesta posição em um plano normal a zdir.

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

*args, **kwargs

Outros argumentos são encaminhados para matplotlib.axes.Axes.tricontourf.

Devoluções :

matplotlib.tri.tricontour.TriContourSet

tunit_cube ( vals = Nenhum , M = Nenhum )

tunit_edges ( vals = Nenhum , M = Nenhum )

unit_cube ( vals = None )

update_datalim ( xys , ** kwargs )

Estenda o dataLimBbox para incluir os pontos fornecidos.

Se nenhum dado for definido atualmente, o Bbox irá ignorar seus limites e definir o limite como sendo os limites do xydata ( xys ). Caso contrário, ele calculará os limites da união de seus dados atuais e os dados em xys .

Parâmetros :

tipo array xys 2D

Os pontos a incluir nos limites de dados Bbox. Isso pode ser uma lista de tuplas (x, y) ou uma matriz Nx2.

updatex, updatey bool, padrão: True

Se os limites x/y devem ser atualizados.

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

Defina a elevação e o azimute dos eixos em graus (não em radianos).

Isso pode ser usado para girar os eixos programaticamente.

Para parecer normal aos planos primários, os seguintes ângulos de elevação e azimute podem ser usados. Um ângulo de rolagem de 0, 90, 180 ou 270 graus irá girar essas visualizações enquanto mantém os eixos em ângulos retos.

plano de visão	elev	azim
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

Parâmetros :

flutuador elev , padrão: nenhum

O ângulo de elevação em graus gira a câmera acima do plano perfurado pelo eixo vertical, com um ângulo positivo correspondente a um local acima desse plano. Por exemplo, com o eixo vertical padrão 'z', a elevação define o ângulo da localização da câmera acima do plano xy. Se None, o valor inicial conforme especificado no Axes3D construtor é usado.

azim float, padrão: nenhum

O ângulo azimutal em graus gira a câmera em torno do eixo vertical, com um ângulo positivo correspondendo a uma rotação à direita. Por exemplo, com o eixo vertical padrão 'z', um azimute positivo gira a câmera sobre a origem de sua localização ao longo do eixo +x em direção ao eixo +y. Se None, o valor inicial conforme especificado no Axes3D construtor é usado.

roll float, padrão: nenhum

O ângulo de rolagem em graus gira a câmera sobre o eixo de visualização. Um ângulo positivo gira a câmera no sentido horário, fazendo com que a cena gire no sentido anti-horário. Se None, o valor inicial conforme especificado no Axes3D construtor é usado.

vertical_axis {"z", "x", "y"}, padrão: "z"

O eixo para alinhar verticalmente. azim gira sobre este eixo.

voxels ( [ x , y , z , ] / , preenchido , facecolors=Nenhum , edgecolors=Nenhum , **kwargs )

Traçar um conjunto de voxels preenchidos

Todos os voxels são plotados como cubos 1x1x1 no eixo, com seu canto inferior na origem. As faces ocluídas não são plotadas.filled[0, 0, 0]

Parâmetros :

3D np.array preenchido de bool

Uma matriz 3D de valores, com valores verdadeiros indicando quais voxels preencher

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

As coordenadas dos cantos dos voxels. Isso deve ser transmitido para uma forma maior em todas as dimensões do que a forma preenchida . Estes podem ser usados ​​para plotar voxels não cúbicos.

Se não especificado, o padrão é aumentar números inteiros ao longo de cada eixo, como aqueles retornados por indices(). Conforme indicado pelo /na assinatura da função, esses argumentos só podem ser passados ​​posicionalmente.

facecolors, edgecolors tipo matriz, opcional

A cor para desenhar as faces e arestas dos voxels. Só podem ser passados ​​como argumentos de palavra-chave. Esses parâmetros podem ser:

• Um único valor de cor, para colorir todos os voxels da mesma cor. Isso pode ser uma string ou uma matriz 1D rgb/rgba

• None, o padrão, para usar uma única cor para as faces e o estilo padrão para as arestas.

• Um ndarray 3D de nomes de cores, com cada item a cor do voxel correspondente. O tamanho deve corresponder aos voxels.

• Um ndarray 4D de dados rgb/rgba, com os componentes ao longo do último eixo.

shade bool, padrão: True

Se deve sombrear as cores do rosto. O sombreamento é sempre desabilitado quando cmap é especificado.

fonte de luzLightSource

A fonte de luz a ser usada quando a sombra é True.

** kwargs

Argumentos de palavra-chave adicionais para passar para Poly3DCollection.

Devoluções :

enfrenta ditado

Um dicionário indexado por coordenada, onde é uma das faces desenhadas para o voxel . Se nenhuma face foi desenhada para um determinado voxel, seja porque não foi solicitado para ser desenhado ou porque está totalmente ocluído, então .faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

Exemplos

( Código fonte , png )

( Código fonte , png )

( Código fonte , png )

( Código fonte , png )

propriedade w_xaxis

propriedade w_yaxis

propriedade w_zaxis

zaxis_date ( tz = Nenhum )

Configure marcas de eixo e rótulos para tratar os dados ao longo do zaxis como datas.

Parâmetros :

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

O fuso horário usado para criar rótulos de data.

Notas

Esta função é fornecida apenas para fins de integridade, mas os eixos 3D não suportam datas para ticks e, portanto, isso pode não funcionar conforme o esperado.

zaxis_inverted ( )

Retorna True se o eixo z estiver invertido.