matplotlib.axes.Axes.tricontour #
- hachas tricontour ( * argumentos , ** kwargs ) [fuente] #
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
Triangulationobjeto como primer parámetro o pasando los puntos x , y y, opcionalmente, los triángulos y una máscara . ConsulteTriangulationpara 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.
- triangulación
- Devoluciones :
- 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 ).
strSi 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 superioresmax(levels)se asignan a los valores superiores e inferiores deColormap. 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 medianteColormap.set_underyColormap.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 aContourSet.changed()después de modificar el mapa de colores. La llamada explícita se puede omitir si se asigna una barra de color aTriContourSetporque llama internamente aContourSet.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.
Ejemplos usando matplotlib.axes.Axes.tricontour#
Gráfico de contorno de datos espaciados irregularmente
