mpl_toolkits.mplot3d.art3d.Poly3DCollection

classe mpl_toolkits.mplot3d.art3d. Poly3DCollection ( verts , * args , zsort = 'average' , ** kwargs )

Bases:PolyCollection

Uma coleção de polígonos 3D.

Observação

Preenchimento de polígonos 3D

Não há definição simples da superfície fechada de um polígono 3D, a menos que o polígono seja planar.

Na prática, o Matplotlib preenche a projeção 2D do polígono. Isso fornece uma aparência de preenchimento correta apenas para polígonos planares. Para todos os outros polígonos, você encontrará orientações nas quais as arestas do polígono se cruzam na projeção. Isso levará a uma visualização incorreta da área 3D.

Caso necessite de áreas preenchidas, é recomendável criá-las via plot_trisurf, que cria uma triangulação e assim gera superfícies consistentes.

Parâmetros :

verts lista de (N, 3) tipo array

Cada elemento descreve um polígono como uma seqüência de N_ipontos .(x, y, z)

zsort {'average', 'min', 'max'}, padrão: 'average'

O método de cálculo para a ordem z. Consulte set_zsortpara obter detalhes.

*args, **kwargs

Todos os outros parâmetros são encaminhados para PolyCollection.

Notas

Observe que esta classe faz um pouco de mágica com as propriedades _facecolors e _edgecolors.

do_3d_projection ( )

Execute a projeção 3D para este objeto.

get_edgecolor ( )

get_facecolor ( )

get_vector ( segmentos3d )

Otimize pontos para projeção.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , antialiased=<UNSET> , array=<UNSET> , capstyle=<UNSET> , clim=<UNSET> , clip_box=<UNSET > , clip_on=<UNSET> , clip_path=<UNSET> , cmap=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , gid=<UNSET> , hachura=<UNSET> , in_layout=<UNSET> ,joinstyle=<UNSET> ,label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , norm=<UNSET> , offset_transform=<UNSET> , offsets=<UNSET> , path_effects=<UNSET> , paths= <UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterizado=<UNSET> , tamanhos=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , sort_zpos=<UNSET> , transform=<UNSET > , url=<UNSET> ,urls=<UNSET> , verts=<UNSET>, verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> , zsort=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

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	desconhecido
animated	bool
antialiasedou aa ou antialiaseds	bool ou lista de bools
array	tipo array ou nenhum
capstyle	CapStyleou {'bunda', 'projetando', 'redondo'}
clim	(vmin: flutuante, vmax: flutuante)
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
cmap	Colormapou str ou Nenhum
color	cor ou lista de tuplas rgba
edgecolorou ec ou cores de borda	desconhecido
facecolorou facecolors ou fc	desconhecido
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
label	objeto
linestyleou traços ou estilos de linha ou ls	str ou tupla ou lista dos mesmos
linewidthou larguras de linha ou lw	flutuador ou lista de flutuadores
mouseover	bool
norm	Normalizeou str ou Nenhum
offset_transformou transOffset	desconhecido
offsets	(N, 2) ou (2,) tipo matriz
path_effects	AbstractPathEffect
paths	lista de tipo array
picker	None ou bool ou float ou callable
pickradius	desconhecido
rasterized	bool
sizes	ndarray ou nenhum
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
sort_zpos	desconhecido
transform	Transform
url	str
urls	lista de str ou None
verts	desconhecido
verts_and_codes	desconhecido
visible	bool
zorder	flutuador
zsort	{'média', 'mín', 'máx'}

set_3d_properties ( )

set_alpha ( alpha )

Defina o valor alfa usado para mesclagem - não suportado em todos os back-ends.

Parâmetros :

alpha array-like ou escalar ou None

Todos os valores devem estar dentro do intervalo 0-1, inclusive. Valores mascarados e nans não são suportados.

set_edgecolor ( cores )

Defina as cores de borda da coleção.

Parâmetros :

c cor ou lista de cores ou 'face'

A(s) cor(es) da(s) borda(s) da coleção. Se for uma sequência, os patches passam por ela. Se for 'rosto', combine a cor do rosto.

set_facecolor ( cores )

Defina a(s) cor(ões) da face da coleção. c pode ser uma cor (todos os patches têm a mesma cor) ou uma sequência de cores; se for uma sequência, os patches percorrerão a sequência.

Se c for 'none', o patch não será preenchido.

Parâmetros :

c cor ou lista de cores

set_sort_zpos ( val )

Defina a posição a ser usada para classificação z.

set_verts ( verts , closed = True )

Definir vértices 3D.

set_verts_and_codes ( verts , codes )

Defina vértices 3D com códigos de caminho.

set_zsort ( zsort )

Defina o método de cálculo para a ordem z.

Parâmetros :

zsort {'média', 'min', 'max'}

A função aplicada nas coordenadas z dos vértices no sistema de coordenadas do visualizador, para determinar a ordem z.

Exemplos usando mpl_toolkits.mplot3d.art3d.Poly3DCollection

Hillshading personalizado em uma plotagem de superfície 3D

Hillshading personalizado em uma plotagem de superfície 3D

Eixos 2D e 3D na mesma Figura

*Eixos* 2D e 3D na mesma *Figura*

Gere polígonos para preencher o gráfico de linha 3D

Gere polígonos para preencher o gráfico de linha 3D

Tramas 3D como subtramas

Tramas 3D como subtramas

Superfície 3D (mapa de cores)

Superfície 3D (mapa de cores)

superfície 3D (tabuleiro de damas)

superfície 3D (tabuleiro de damas)