matplotlib.pyplot.tricontourf

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

Dibuje regiones de contorno en una cuadrícula triangular sin estructura.

Firmas de llamada:

tricontourf(triangulation, Z, [levels], ...)
tricontourf(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.tricontourf(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 regiones de contorno.

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 tricontourfcoloració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).

lista de escotillas [str], opcional

Una lista de patrones de sombreado cruzado para usar en las áreas rellenas. Si es Ninguno, no se agregará sombreado al contorno. La eclosión solo se admite en los backends PostScript, PDF, SVG y Agg.

notas

tricontourfllena los intervalos que están cerrados en la parte superior; es decir, para los límites z1 y z2 , la región rellena es:

z1 < Z <= z2

excepto por el intervalo más bajo, que está cerrado en ambos lados (es decir, incluye el valor más bajo).