matplotlib.contour

Clases para admitir el trazado y etiquetado de contornos para la clase Axes.

clase matplotlib.contour. ClabelText ( x = 0 , y = 0 , texto = '' , * , color = Ninguno , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = Ninguno , fontproperties = Ninguno , rotación = Ninguno , interlineado = Ninguno , modo_rotación = Ninguno, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Bases:Text

A diferencia del texto ordinario, get_rotation devuelve un ángulo actualizado en la coordenada de píxel, suponiendo que la rotación de entrada es un ángulo en la coordenada de datos (o cualquier conjunto de transformación).

Cree una Textinstancia en x , y con texto de cadena .

El texto se alinea en relación con el punto de ancla ( x , y ) según horizontalalignment(predeterminado: 'izquierda') y verticalalignment (predeterminado: 'abajo'). Véase también Alineación de texto .

Si bien Texto acepta el argumento de palabra clave 'etiqueta', de forma predeterminada no se agrega a los identificadores de una leyenda.

Los argumentos de palabra clave válidos son:

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

get_rotation ( )

Devuelve el ángulo del texto en grados entre 0 y 360.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation =<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<DESCONFIGURAR>, alineaciónhorizontal=<DESCONFIGURAR>, in_layout=<UNSET> , label=<UNSET> , linesping=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , selector =<DESCONFIGURACIÓN> , posición=<DESCONFIGURACIÓN> , rasterizado=<DESCONFIGURACIÓN> , rotación=<DESCONFIGURACIÓN>, modo_rotación = <DESCONFIGURACIÓN> , sketch_params=<DESCONFIGURACIÓN> , snap=<DESCONFIGURACIÓN> , texto=<DESCONFIGURACIÓN> , transform=< DESCONFIGURAR> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

Establece varias propiedades a la vez.

Las propiedades admitidas son

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	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
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

clase matplotlib.contour. ContourLabeler

Bases:object

Mixin para proporcionar capacidad de etiquetado a ContourSet.

add_label ( x , y , rotación , lev , cvalue )

Agregue la etiqueta de contorno usando Textla clase.

add_label_clabeltext ( x , y , rotación , lev , cvalue )

Agregue la etiqueta de contorno usando ClabelTextla clase.

add_label_near ( x , y , en línea = True , inline_spacing = 5 , transform = None )

Agregue una etiqueta cerca del punto .(x, y)

Parámetros :

x, y flotan

La ubicación aproximada de la etiqueta.

bool en línea , predeterminado: verdadero

Si es Verdadero , elimine el segmento del contorno debajo de la etiqueta.

inline_spacing int, predeterminado: 5

Espacio en píxeles para dejar a cada lado de la etiqueta al colocarla en línea. Este espaciado será exacto para etiquetas en ubicaciones donde el contorno es recto, menos para etiquetas en contornos curvos.

transformar Transformo False, por defecto:self.axes.transData

Una transformación aplicada antes del etiquetado. Las causas predeterminadas se interpretan como coordenadas de datos. es un sinónimo de ; es decir , debe interpretarse como coordenadas de visualización.(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc = Ninguno , espaciado = 5 )

Calcule la rotación de etiqueta adecuada dadas las coordenadas de contorno de línea en unidades de pantalla, el índice de la ubicación de la etiqueta y el ancho de la etiqueta.

Si lc no es Ninguno o está vacío, también rompa los contornos y calcule la inserción.

espaciado es el espacio vacío que se deja alrededor de la etiqueta, en píxeles.

Ambas tareas se realizan juntas para evitar calcular la longitud de la ruta varias veces, lo cual es relativamente costoso.

El método utilizado aquí implica calcular la longitud de la ruta a lo largo del contorno en coordenadas de píxeles y luego mirar aproximadamente (ancho de etiqueta / 2) lejos del punto central para determinar la rotación y luego romper el contorno si se desea.

clabel ( levels = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None )

Etiquete una gráfica de contorno.

Agrega etiquetas a los contornos de línea en this ContourSet(que hereda de esta clase mixin).

Parámetros :

niveles en forma de matriz, opcional

Una lista de valores de nivel, que deben etiquetarse. La lista debe ser un subconjunto de cs.levels. Si no se proporciona, todos los niveles están etiquetados.

tamaño de fuente str o float, predeterminado: rcParams["font.size"](predeterminado: 10.0)

Tamaño en puntos o tamaño relativo, por ejemplo, 'más pequeño', 'x-grande'. Consulte Text.set_sizelos valores de cadena aceptados.

colores color o colores o Ninguno, predeterminado: Ninguno

Los colores de la etiqueta:

• Si es Ninguno , el color de cada etiqueta coincide con el color del contorno correspondiente.

• Si un color de cadena, por ejemplo, colores = 'r' o colores = 'rojo', todas las etiquetas se trazarán en este color.

• Si es una tupla de colores (cadena, flotante, rgb, etc.), las diferentes etiquetas se trazarán en diferentes colores en el orden especificado.

bool en línea , predeterminado: verdadero

Si Truese elimina el contorno subyacente donde se coloca la etiqueta.

flotador inline_spacing , predeterminado: 5

Espacio en píxeles para dejar a cada lado de la etiqueta al colocarla en línea.

Este espaciado será exacto para etiquetas en ubicaciones donde el contorno es recto, menos para etiquetas en contornos curvos.

fmt Formattero str o callable o dict, opcional

Cómo se formatean los niveles:

• Si es Formatter, se usa para formatear todos los niveles a la vez, usando su Formatter.format_ticksmétodo.

• Si es una cadena, se interpreta como una cadena con formato de estilo %.

• Si es invocable, se llama con un nivel a la vez y debe devolver la etiqueta correspondiente.

• Si es un dictado, debe asignar directamente los niveles a las etiquetas.

El valor predeterminado es usar un estándar ScalarFormatter.

booleano manual o iterable, predeterminado: Falso

Si True, las etiquetas de contorno se colocarán manualmente con clics del mouse. Haga clic en el primer botón cerca de un contorno para agregar una etiqueta, haga clic en el segundo botón (o potencialmente en ambos botones del mouse a la vez) para terminar de agregar etiquetas. El tercer botón se puede usar para eliminar la última etiqueta agregada, pero solo si las etiquetas no están en línea. Alternativamente, el teclado se puede usar para seleccionar ubicaciones de etiquetas (ingresar para finalizar la ubicación de la etiqueta, eliminar o retroceder actuar como el tercer botón del mouse, y cualquier otra tecla seleccionará una ubicación de etiqueta).

manual también puede ser un objeto iterable de (x, y) tuplas. Las etiquetas de contorno se crearán como si se hiciera clic con el mouse en cada posición (x, y).

rightside_up bool, por defecto: Verdadero

Si True, las rotaciones de las etiquetas siempre serán de más o menos 90 grados desde el nivel.

use_clabeltext bool, por defecto: Falso

Si True, ClabelTextla clase (en lugar de Text) se usa para crear etiquetas. ClabelTextrecalcula los ángulos de rotación de los textos durante el tiempo de dibujo, por lo que puede usarse si cambia el aspecto de los ejes.

zorder float o Ninguno, por defecto:(2 + contour.get_zorder())

zorder de las etiquetas de contorno.

Devoluciones :

etiquetas

Una lista de Textinstancias para las etiquetas.

get_label_width ( lev , fmt , fsize )

[ Obsoleto ] Devuelve el ancho de la etiqueta en puntos.

notas

En desuso desde la versión 3.5.

get_text ( lev , fmt )

Obtener el texto de la etiqueta.

etiquetas ( inline , inline_spacing )

localizar_etiqueta ( contorno de línea , ancho de etiqueta )

Encuentre un buen lugar para dibujar una etiqueta (parte relativamente plana del contorno).

pop_label ( índice = -1 )

El valor predeterminado es eliminar la última etiqueta, pero se puede proporcionar cualquier índice

print_label ( contorno de línea , ancho de etiqueta )

Devuelve si un contorno es lo suficientemente largo para contener una etiqueta.

set_label_props ( etiqueta , texto , color )

Establezca las propiedades de la etiqueta: color, tamaño de fuente, texto.

too_close ( x , y , lw )

Devuelve si una etiqueta ya está cerca de esta ubicación.

clase matplotlib.contour. ContourSet ( ax , * args , niveles = Ninguno , relleno = Falso , anchos de línea = Ninguno , estilos de línea = Ninguno , sombreados = (Ninguno) , alfa = Ninguno , origen = Ninguno , extensión = Ninguno , cmap = Ninguno , colores = Ninguno , norma =Ninguno , vmin = Ninguno , vmax = Ninguno , extender = 'ninguno' , suavizado = Ninguno , nchunk = 0 , localizador = Ninguno , transformar = Ninguno , estilo de línea negativa = Ninguno , ** kwargs )

Bases: ScalarMappable,ContourLabeler

Almacene un conjunto de líneas de contorno o regiones rellenas.

Método llamable por el usuario:clabel

Parámetros :

hachaAxes

niveles [nivel0, nivel1, ..., niveln]

Una lista de números de coma flotante que indican los niveles de contorno.

todos los segmentos [ nivel0 segmentos, nivel1 segmentos, ...]

Lista de todos los segmentos del polígono para todos los niveles . Para curvas de nivel y regiones de curvas de nivel rellenas . Las listas deben verse comolen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

todos los tipos Noneo [nivel0tipos, nivel1tipos, ...]

Lista opcional de todos los tipos de vértices de polígonos (tipos de código), como se describe y utiliza en Ruta. Esto se usa para permitir múltiples rutas conectadas, como agujeros dentro de polígonos rellenos. Si no None, . Las listas deben verse comolen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds no lo es None, por lo general todos los polígonos para un nivel de contorno en particular se agrupan de modo que y .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Los argumentos de palabras clave se describen en la cadena de documentación de contour.

Atributos :

hachaAxes

El objeto Axes en el que se dibujan los contornos.

colecciones silent_listde PathCollections

La Artists que representa el contorno. Esta es una lista de PathCollections tanto para líneas como para contornos rellenos.

matriz de niveles

Los valores de los niveles de contorno.

matriz de capas

Igual que los niveles para los contornos de línea; a mitad de camino entre niveles para contornos rellenos. ver ContourSet._process_colors_

Dibuje líneas de contorno o regiones rellenas, dependiendo de si la palabra clave arg filled es False(predeterminada) o True.

Firma de llamada:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parámetros :

hachaAxes

El Axesobjeto a dibujar.

niveles [nivel0, nivel1, ..., niveln]

Una lista de números de coma flotante que indican los niveles de contorno.

todos los segmentos [ nivel0 segmentos, nivel1 segmentos, ...]

Lista de todos los segmentos del polígono para todos los niveles . Para curvas de nivel y regiones de curvas de nivel rellenas . Las listas deben verse comolen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

todo tipo [ nivel0tipos , nivel1tipos, ...], opcional

Lista opcional de todos los tipos de vértices de polígonos (tipos de código), como se describe y utiliza en Ruta. Esto se usa para permitir múltiples rutas conectadas, como agujeros dentro de polígonos rellenos. Si no None, . Las listas deben verse comolen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds no lo es None, por lo general todos los polígonos para un nivel de contorno en particular se agrupan de modo que y .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Los argumentos de palabras clave se describen en la cadena de documentación de contour.

cambiado ( )

Llame a esto cada vez que se cambie el mapeable para notificar a todos los oyentes de callbackSM sobre la señal 'cambiada'.

find_nearest_contour ( x , y , índices = Ninguno , píxel = Verdadero )

Encuentre el punto en la gráfica de contorno que está más cerca de .(x, y)

Este método no admite contornos rellenos.

Parámetros :

x, y flotan

El punto de referencia.

lista de índices de int o Ninguno, por defecto: Ninguno

Índices de niveles de contorno a considerar. Si es Ninguno (el valor predeterminado), se consideran todos los niveles.

píxel bool, predeterminado: Verdadero

Si es True , mida la distancia en el espacio de píxeles (pantalla), lo cual es útil para el etiquetado manual de contornos; de lo contrario, mida la distancia en el espacio de ejes.

Devoluciones :

contornoCollection

El contorno que está más cerca de .(x, y)

segmento int

El índice del Pathcontorno más cercano a .(x, y)

índice int

El índice del segmento de la ruta en el segmento que está más cerca de .(x, y)

xmin, ymin flotante

El punto en el gráfico de contorno que está más cerca de .(x, y)

flotador d2

La distancia al cuadrado de a .(xmin, ymin)(x, y)

get_alpha ( )

Devuelve alfa para que se aplique a todos los artistas de ContourSet.

get_transform ( )

Devuelve la Transforminstancia utilizada por este ContourSet.

legend_elements ( variable_name='x' , str_format=<clase 'str'> )

Devuelve una lista de artistas y sellos adecuados para pasar a los legendque representan este ContourSet.

Las etiquetas tienen la forma "0 < x <= 1" indicando los rangos de datos que representan los artistas.

Parámetros :

cadena nombre_variable

La cadena utilizada dentro de la desigualdad utilizada en las etiquetas.

función str_format : flotante -> str

Función utilizada para dar formato a los números en las etiquetas.

Devoluciones :

lista de artistas [ Artist]

Una lista de los artistas.

lista de etiquetas [str]

Una lista de las etiquetas.

set_alpha ( alfa )

Establezca el valor de fusión alfa para todos los artistas de ContourSet. alfa debe estar entre 0 (transparente) y 1 (opaco).

clase matplotlib.contour. QuadContourSet ( hacha , * argumentos , niveles = Ninguno , relleno = Falso , anchos de línea = Ninguno , estilos de línea = Ninguno , sombreados = (Ninguno) , alfa = Ninguno , origen = Ninguno , extensión = Ninguno , cmap = Ninguno , colores = Ninguno , norma =Ninguno , vmin = Ninguno , vmax = Ninguno , extender = 'ninguno' , suavizado = Ninguno , nchunk = 0 , localizador = Ninguno , transformar = Ninguno , estilo de línea negativa = Ninguno , ** kwargs )

Bases:ContourSet

Cree y almacene un conjunto de líneas de contorno o regiones rellenas.

Esta clase normalmente no es instanciada directamente por el usuario sino por contoury contourf.

Atributos :

hachaAxes

El objeto Axes en el que se dibujan los contornos.

colecciones silent_listde PathCollections

La Artists que representa el contorno. Esta es una lista de PathCollections tanto para líneas como para contornos rellenos.

matriz de niveles

Los valores de los niveles de contorno.

matriz de capas

Igual que los niveles para los contornos de línea; a mitad de camino entre niveles para contornos rellenos. ver ContourSet._process_colors_

Dibuje líneas de contorno o regiones rellenas, dependiendo de si la palabra clave arg filled es False(predeterminada) o True.

Firma de llamada:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parámetros :

hachaAxes

El Axesobjeto a dibujar.

niveles [nivel0, nivel1, ..., niveln]

Una lista de números de coma flotante que indican los niveles de contorno.

todos los segmentos [ nivel0 segmentos, nivel1 segmentos, ...]

Lista de todos los segmentos del polígono para todos los niveles . Para curvas de nivel y regiones de curvas de nivel rellenas . Las listas deben verse comolen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

todo tipo [ nivel0tipos , nivel1tipos, ...], opcional

Lista opcional de todos los tipos de vértices de polígonos (tipos de código), como se describe y utiliza en Ruta. Esto se usa para permitir múltiples rutas conectadas, como agujeros dentro de polígonos rellenos. Si no None, . Las listas deben verse comolen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Si allkinds no lo es None, por lo general todos los polígonos para un nivel de contorno en particular se agrupan de modo que y .level0segs = [polygon0]level0kinds = [polygon0kinds]

**kwargs

Los argumentos de palabras clave se describen en la cadena de documentación de contour.