matplotlib.axes.Axes.hexbin

hachas hexbin ( x , y , C=Ninguno , gridsize=100 , bins=Ninguno , xscale='linear' , yscale='linear' , extension=Ninguno , cmap=Ninguno , norm=Ninguno , vmin=Ninguno , vmax=Ninguno , alpha=Ninguno , linewidths =Ninguno , edgecolors='face' , reduce_C_function=<función media> , mincnt=Ninguno , marginals=False , * , data=Ninguno ,**kwargs )

Haz un gráfico binning hexagonal 2D de los puntos x , y .

Si C es Ninguno , el valor del hexágono está determinado por el número de puntos en el hexágono. De lo contrario, C especifica valores en la coordenada (x[i], y[i]). Para cada hexágono, estos valores se reducen mediante reduce_C_function .

Parámetros :

x, y en forma de matriz

Las posiciones de los datos. x e y deben tener la misma longitud.

Tipo de matriz C , opcional

Si se dan, estos valores se acumulan en los contenedores. De lo contrario, cada punto tiene un valor de 1. Debe tener la misma longitud que x e y .

gridsize int o (int, int), por defecto: 100

Si es un entero único, el número de hexágonos en la dirección x . El número de hexágonos en la dirección y se elige de manera que los hexágonos sean aproximadamente regulares.

Alternativamente, si es una tupla ( nx , ny ), el número de hexágonos en la dirección x y la dirección y .

bins 'log' o int o secuencia, predeterminado: Ninguno

Discretización de los valores del hexágono.

• Si es Ninguno , no se aplica la clasificación; el color de cada hexágono corresponde directamente a su valor de conteo.

• Si es 'registro', utilice una escala logarítmica para el mapa de colores. Internamente,\(log_{10}(i+1)\)se utiliza para determinar el color del hexágono. Esto es equivalente a norm=LogNorm().

• Si es un número entero, divida los recuentos en el número especificado de contenedores y coloree los hexágonos según corresponda.

• Si se trata de una secuencia de valores, se utilizarán los valores del límite inferior de los intervalos.

xscale {'lineal', 'registro'}, predeterminado: 'lineal'

Utilice una escala lineal o log10 en el eje horizontal.

yscale {'lineal', 'registro'}, predeterminado: 'lineal'

Use una escala lineal o log10 en el eje vertical.

mincnt int > 0, predeterminado: Ninguno

Si no es Ninguno , solo muestra las celdas con más de un número mínimo de puntos en la celda.

marginales bool, por defecto: Falso

Si marginals es True , trace la densidad marginal como rectángulos en mapas de colores a lo largo de la parte inferior del eje x ya la izquierda del eje y.

extensión de 4 tuplas de float, por defecto: Ninguno

Los límites de los contenedores (xmin, xmax, ymin, ymax). El valor predeterminado asigna los límites en función del tamaño de cuadrícula , x , y , xscale y yscale .

Si xscale o yscale se establece en 'log', se espera que los límites sean el exponente de una potencia de 10. Por ejemplo, para límites x de 1 y 50 en escala 'lineal' y límites y de 10 y 1000 en 'log ' escala, ingrese (1, 50, 1, 3).

Devoluciones :

PolyCollection

A PolyCollectionque define los bins hexagonales.

• PolyCollection.get_offsetscontiene una matriz Mx2 que contiene las posiciones x, y de los centros hexagonales M.

• PolyCollection.get_arraycontiene los valores de los M hexágonos.

Si marginals es True , la barra horizontal y la barra vertical (ambas PolyCollections) se adjuntarán a la colección de devolución como atributos hbar y vbar .

Otros parámetros :

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

La instancia de mapa de colores o el nombre de mapa de colores registrado que se utiliza para asignar datos escalares a colores.

norma str o Normalize, opcional

El método de normalización usado para escalar datos escalares al rango [0, 1] antes de mapear a colores usando cmap . De forma predeterminada, se utiliza una escala lineal, asignando el valor más bajo a 0 y el más alto a 1.

Si se da, puede ser uno de los siguientes:

• Una instancia de Normalizeo una de sus subclases (consulte Normalización de mapa de colores ).

• Un nombre de escala, es decir, uno de "linear", "log", "symlog", "logit", etc. Para obtener una lista de las escalas disponibles, llame al matplotlib.scale.get_scale_names(). NormalizeEn ese caso, se genera e instancia dinámicamente una subclase adecuada .

vmin, vmax flotante, opcional

Cuando se usan datos escalares y no hay una norma explícita , vmin y vmax definen el rango de datos que cubre el mapa de colores. De forma predeterminada, el mapa de colores cubre el rango de valores completo de los datos proporcionados. Es un error usar vmin / vmax cuando se proporciona una instancia de norma (pero es aceptable usar un nombre de norma junto con vmin / vmax ).str

alfa flotante entre 0 y 1, opcional

El valor de fusión alfa, entre 0 (transparente) y 1 (opaco).

linewidths float, por defecto: Ninguno

Si es Ninguno , el valor predeterminado es 1.0.

edgecolors {'cara', 'ninguno', Ninguno } o color, por defecto: 'cara'

El color de los bordes del hexágono. Los valores posibles son:

• 'cara': Dibuja los bordes en el mismo color que el color de relleno.

• 'none': no ​​se dibujan bordes. Esto a veces puede dar lugar a píxeles antiestéticos sin pintar entre los hexágonos.

• Ninguno : Dibujar contornos en el color predeterminado.

• Un color explícito.

reduce_C_function invocable, predeterminado:numpy.mean

La función para agregar C dentro de los contenedores. Se ignora si no se da C. Esto debe tener la firma:

def reduce_C_function(C: array) -> float

Las funciones comúnmente utilizadas son:

• numpy.mean: promedio de los puntos

• numpy.sum: integral de los valores de los puntos

• numpy.amax: valor tomado del punto más grande

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

** PolyCollectionpropiedades de los kwargs

Todos los demás argumentos de palabras clave se pasan a PolyCollection:

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	tipo matriz o escalar o ninguno
animated	bool
antialiasedo aa o suavizado	bool o lista de bools
array	tipo matriz o ninguno
capstyle	CapStyleo {'trasero', 'proyectando', 'redondo'}
clim	(vmin: flotante, vmax: flotante)
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
cmap	Colormapo str o Ninguno
color	color o lista de tuplas rgba
edgecoloro ec o edgecolors	color o lista de colores o 'cara'
facecoloro colores de cara o fc	color o lista de colores
figure	Figure
gid	calle
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'inglete', 'redondo', 'bisel'}
label	objeto
linestyleo guiones o estilos de línea o ls	str o tuple o lista de los mismos
linewidtho anchos de línea o lw	flotador o lista de flotadores
mouseover	bool
norm	Normalizeo str o Ninguno
offset_transformo transOffset	desconocido
offsets	(N, 2) o (2,) en forma de matriz
path_effects	AbstractPathEffect
paths	lista de tipo matriz
picker	Ninguno o bool o flotante o invocable
pickradius	desconocido
rasterized	bool
sizes	ndarray o Ninguno
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
transform	Transform
url	calle
urls	lista de str o Ninguno
verts	lista de tipo matriz
verts_and_codes	desconocido
visible	bool
zorder	flotar

Ver también

hist2d

Bandejas rectangulares de histograma 2D

Ejemplos usando matplotlib.axes.Axes.hexbin

Parcela en bins hexagonales

Parcela en bins hexagonales

hexadecimal (x, y, C)

hexadecimal (x, y, C)