matplotlib.pyplot.tricontour

matplotlib.pyplot. tricontour ( * argumentos , ** kwargs )

Dibuja líneas de contorno en una cuadrícula triangular sin estructura.

Firmas de llamada:

tricontour(triangulation, Z, [levels], ...)
tricontour(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

La cuadrícula triangular se puede especificar pasando un Triangulation objeto como primer parámetro o pasando los puntos x , y y, opcionalmente, los triángulos y una máscara . Consulte Triangulationpara obtener una explicación de estos parámetros. Si no se proporciona ni la triangulación ni los triángulos , la triangulación se calcula sobre la marcha.

Es posible pasar triángulos posicionalmente, es decir . Sin embargo, esto se desaconseja. Para mayor claridad, pase triángulos a través de un argumento de palabra clave.tricontour(x, y, triangles, Z, ...)

Parámetros :

triangulación Triangulation, opcional

Una cuadrícula triangular ya creada.

x, y, triángulos, máscara

Parámetros que definen la cuadrícula triangular. ver Triangulation_ Esto es mutuamente excluyente con la triangulación especificada .

tipo matriz Z

Los valores de altura sobre los que se dibuja el contorno. El mapeo de colores está controlado por cmap , norm , vmin y vmax .

niveles int o tipo matriz, opcional

Determina el número y las posiciones de las líneas de contorno/regiones.

Si es un int n , use MaxNLocator, que intenta elegir automáticamente no más de n+1 niveles de contorno "agradables" entre vmin y vmax .

Si es como una matriz, dibuje líneas de contorno en los niveles especificados. Los valores deben estar en orden creciente.

Devoluciones :

TriContourSet

Otros parámetros :

colores cadena de colores o secuencia de colores, opcional

Los colores de los niveles, es decir, las curvas de nivel.

La secuencia se cicla para los niveles en orden ascendente. Si la secuencia es más corta que el número de niveles, se repite.

Como método abreviado, se pueden utilizar cadenas de un solo color en lugar de listas de un elemento, es decir, 'red'en lugar de ['red']colorear todos los niveles con el mismo color. Este atajo solo funciona para cadenas de colores, no para otras formas de especificar colores.

De forma predeterminada (valor Ninguno ), se utilizará el mapa de colores especificado por cmap .

flotante alfa , predeterminado: 1

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

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.

Este parámetro se ignora si se establecen 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 .

Este parámetro se ignora si se establecen colores .

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

Si no se proporciona vmin o vmax , la escala de color predeterminada se basa en niveles .

Este parámetro se ignora si se establecen colores .

origen { Ninguno , 'superior', 'inferior', 'imagen'}, predeterminado: Ninguno

Determina la orientación y la posición exacta de Z especificando la posición de . Esto solo es relevante si no se dan X , Y.Z[0, 0]

• Ninguno : está en X=0, Y=0 en la esquina inferior izquierda.Z[0, 0]

• 'inferior': está en X=0.5, Y=0.5 en la esquina inferior izquierda.Z[0, 0]

• 'superior': está en X=N+0.5, Y=0.5 en la esquina superior izquierda.Z[0, 0]

• 'imagen': usa el valor de rcParams["image.origin"](predeterminado: 'upper').

extensión (x0, x1, y0, y1), opcional

Si el origen no es Ninguno , entonces la extensión se interpreta como en imshow: proporciona los límites de píxeles externos. En este caso, la posición de Z[0, 0] es el centro del píxel, no una esquina. Si el origen es Ninguno , entonces ( x0 , y0 ) es la posición de Z[0, 0] y ( x1 , y1 ) es la posición de Z[-1, -1].

Este argumento se ignora si se especifican X e Y en la llamada a contorno.

localizador ticker.Locator subclase, opcional

El localizador se utiliza para determinar los niveles de contorno si no se dan explícitamente a través de niveles . El valor predeterminado es MaxNLocator.

extender {'ninguno', 'ambos', 'min', 'max'}, por defecto: 'ninguno'

Determina la tricontourcoloración de los valores que están fuera del rango de niveles .

Si 'ninguno', los valores fuera del rango de niveles no están coloreados. Si es 'mínimo', 'máximo' o 'ambos', coloree los valores por debajo, por encima o por debajo y por encima del rango de niveles .

Los valores inferiores min(levels)y superiores max(levels)se asignan a los valores superiores e inferiores de Colormap. Tenga en cuenta que la mayoría de los mapas de colores no tienen colores dedicados para estos de forma predeterminada, por lo que los valores por encima y por debajo son los valores de borde del mapa de colores. Es posible que desee establecer estos valores de forma explícita mediante Colormap.set_undery Colormap.set_over.

Nota

No se notifica a un existente TriContourSetsi se cambian las propiedades de su mapa de colores. Por lo tanto, se necesita una llamada explícita a ContourSet.changed()después de modificar el mapa de colores. La llamada explícita se puede omitir si se asigna una barra de color a TriContourSetporque llama internamente a ContourSet.changed().

xunits, yunits unidades registradas, opcional

Anule las unidades de eje especificando una instancia de un archivo matplotlib.units.ConversionInterface.

bool suavizado , opcional

Habilite el antialiasing, anulando los valores predeterminados. Para contornos rellenos, el valor predeterminado es True . Para contornos de línea, se toma de rcParams["lines.antialiased"](predeterminado: True).

anchos de línea flotantes o tipo matriz, predeterminado: rcParams["contour.linewidth"](predeterminado: None)

El ancho de línea de las líneas de contorno.

Si es un número, todos los niveles se trazarán con este ancho de línea.

Si es una secuencia, los niveles en orden ascendente se trazarán con los anchos de línea en el orden especificado.

Si es Ninguno, vuelve a rcParams["lines.linewidth"](predeterminado: 1.5).

estilos de línea { Ninguno , 'sólido', 'discontinuado', 'guionado', 'punteado'}, opcional

Si linestyles es None , el valor predeterminado es 'sólido' a menos que las líneas sean monocromáticas. En ese caso, los contornos negativos tomarán su estilo de línea de la rcParams["contour.negative_linestyle"]configuración (predeterminada: 'dashed').

Los estilos de línea también pueden ser iterables de las cadenas anteriores que especifican un conjunto de estilos de línea que se usarán. Si este iterable es más corto que el número de niveles de contorno, se repetirá según sea necesario.