matplotlib.axes.Axes.hexbin

Machados. hexbin ( x , y , C=None , gridsize=100 , bins=None , xscale='linear' , yscale='linear' , extension= None , cmap=None , norm=None , vmin=None , vmax=None , alpha=None , linewidths=None , edgecolors='face' , reduce_C_function=<função média> , mincnt=None , marginais=False , * , data=None ,**kwargs )

Faça um gráfico binning hexagonal 2D dos pontos x , y .

Se C for None , o valor do hexágono será determinado pelo número de pontos no hexágono. Caso contrário, C especifica valores na coordenada (x[i], y[i]). Para cada hexágono, esses valores são reduzidos usando a função reduce_C_ .

Parâmetros :

x, y semelhante a uma matriz

As posições de dados. x e y devem ter o mesmo comprimento.

C array-like, opcional

Se fornecidos, esses valores são acumulados nas caixas. Caso contrário, cada ponto terá o valor 1. Deve ter o mesmo comprimento que x e y .

gridsize int ou (int, int), padrão: 100

Se for um único int, o número de hexágonos na direção x . O número de hexágonos na direção y é escolhido de forma que os hexágonos sejam aproximadamente regulares.

Como alternativa, se for uma tupla ( nx , ny ), o número de hexágonos na direção x e na direção y .

bins 'log' ou int ou sequência, padrão: Nenhum

Discretização dos valores do hexágono.

• Se None , nenhum binning é aplicado; a cor de cada hexágono corresponde diretamente ao seu valor de contagem.

• Se 'log', use uma escala logarítmica para o mapa de cores. Internamente,\(log_{10}(i+1)\)é usado para determinar a cor do hexágono. Isso é equivalente a norm=LogNorm().

• Se for um número inteiro, divida as contagens no número especificado de compartimentos e pinte os hexágonos de acordo.

• Se for uma sequência de valores, os valores do limite inferior dos compartimentos a serem usados.

xscale {'linear', 'log'}, padrão: 'linear'

Use uma escala linear ou log10 no eixo horizontal.

yscale {'linear', 'log'}, padrão: 'linear'

Use uma escala linear ou log10 no eixo vertical.

mincnt int > 0, padrão: Nenhum

Se não None , exibe apenas as células com mais de um número mínimo de pontos na célula.

marginals bool, padrão: False

Se marginals for True , plote a densidade marginal como retângulos mapeados por cores ao longo da parte inferior do eixo x e à esquerda do eixo y.

extensão 4 tuplas de float, default: None

Os limites dos bins (xmin, xmax, ymin, ymax). O padrão atribui os limites com base em gridsize , x , y , xscale e yscale .

Se xscale ou yscale for definido como 'log', espera-se que os limites sejam o expoente para uma potência de 10. Por exemplo, para limites x de 1 e 50 na escala 'linear' e limites y de 10 e 1000 em 'log ' escala, digite (1, 50, 1, 3).

Devoluções :

PolyCollection

A PolyCollectiondefinindo as caixas hexagonais.

• PolyCollection.get_offsetscontém uma matriz Mx2 contendo as posições x, y dos centros de hexágonos M.

• PolyCollection.get_arraycontém os valores dos hexágonos M.

Se margins for True , a barra horizontal e a barra vertical (ambas PolyCollections) serão anexadas à coleção de retorno como atributos hbar e vbar .

Outros Parâmetros :

cmap str ou Colormap, padrão: rcParams["image.cmap"](padrão: 'viridis')

A instância do Colormap ou nome do mapa de cores registrado usado para mapear dados escalares para cores.

norma str ou Normalize, opcional

O método de normalização usado para dimensionar dados escalares para o intervalo [0, 1] antes de mapear para cores usando cmap . Por padrão, uma escala linear é usada, mapeando o valor mais baixo para 0 e o mais alto para 1.

Se fornecido, pode ser um dos seguintes:

• Uma instância Normalizeou uma de suas subclasses (consulte Normalização do mapa de cores ).

• Um nome de escala, ou seja, um de "linear", "log", "symlog", "logit", etc. Para obter uma lista de escalas disponíveis, chame matplotlib.scale.get_scale_names(). Nesse caso, uma Normalizesubclasse adequada é gerada e instanciada dinamicamente.

vmin, vmax flutuante, opcional

Ao usar dados escalares e nenhuma norma explícita , vmin e vmax definem o intervalo de dados que o mapa de cores cobre. Por padrão, o mapa de cores cobre toda a faixa de valores dos dados fornecidos. É um erro usar vmin / vmax quando uma instância de norma é fornecida (mas usar um nome de norma junto com vmin / vmax é aceitável).str

alfa flutuante entre 0 e 1, opcional

O valor de mistura alfa, entre 0 (transparente) e 1 (opaco).

larguras de linha flutuantes, padrão: nenhum

Se None , o padrão é 1.0.

edgecolors {'face', 'none', None } ou cor, padrão: 'face'

A cor das bordas do hexágono. Os valores possíveis são:

• 'face': Desenhe as bordas na mesma cor da cor de preenchimento.

• 'none': Nenhuma aresta é desenhada. Às vezes, isso pode levar a pixels sem pintura desagradáveis ​​entre os hexágonos.

• Nenhum : desenhe contornos na cor padrão.

• Uma cor explícita.

reduce_C_function chamável, padrão:numpy.mean

A função para agregar C dentro dos compartimentos. É ignorado se C não for fornecido. Este deve ter a assinatura:

def reduce_C_function(C: array) -> float

As funções comumente usadas são:

• numpy.mean: média dos pontos

• numpy.sum: integral dos valores dos pontos

• numpy.amax: valor retirado do maior ponto

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 , C

** PolyCollectionpropriedades dos kwargs

Todos os outros argumentos de palavras-chave são passados ​​para PolyCollection:

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	tipo array ou escalar ou Nenhum
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	cor ou lista de cores ou 'face'
facecolorou facecolors ou fc	cor ou lista de cores
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
transform	Transform
url	str
urls	lista de str ou None
verts	lista de tipo array
verts_and_codes	desconhecido
visible	bool
zorder	flutuador

Veja também

hist2d

Caixas retangulares de histograma 2D

Exemplos usando matplotlib.axes.Axes.hexbin

Plotagem hexagonal agrupada

Plotagem hexagonal agrupada

hexbin(x, y, C)

hexbin(x, y, C)