matplotlib.axes.Axes.tricontour #
- Machados. tricontour ( * args , ** kwargs ) [fonte] #
Desenhe linhas de contorno em uma grade triangular não estruturada.
Assinaturas de chamada:
tricontour(triangulation, Z, [levels], ...) tricontour(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)
A grade triangular pode ser especificada passando um
Triangulationobjeto como primeiro parâmetro ou passando os pontos x , y e opcionalmente os triângulos e uma máscara . ConsulteTriangulationpara obter uma explicação sobre esses parâmetros. Se nenhuma triangulação ou triângulos forem fornecidos, a triangulação é calculada na hora.É possível passar triângulos posicionalmente, ou seja, . No entanto, isso é desencorajado. Para maior clareza, passe triângulos por meio do argumento de palavra-chave.
tricontour(x, y, triangles, Z, ...)- Parâmetros :
- triangulação
Triangulation, opcional Uma grade triangular já criada.
- x, y, triângulos, máscara
Parâmetros que definem a grade triangular. Veja
Triangulation. Isso é mutuamente exclusivo com a especificação de triangulação .- tipo matriz Z
Os valores de altura sobre os quais o contorno é desenhado. O mapeamento de cores é controlado por cmap , norm , vmin e vmax .
- níveis int ou tipo array, opcional
Determina o número e as posições das curvas de nível/regiões.
Se um int n , use
MaxNLocator, que tenta escolher automaticamente não mais que n+1 níveis de contorno "agradáveis" entre vmin e vmax .Se for semelhante a uma matriz, desenhe linhas de contorno nos níveis especificados. Os valores devem estar em ordem crescente.
- triangulação
- Devoluções :
- Outros Parâmetros :
- cores seqüência de cores ou sequência de cores, opcional
As cores dos níveis, ou seja, as linhas de contorno.
A sequência é alternada para os níveis em ordem crescente. Se a sequência for menor que o número de níveis, ela é repetida.
Como atalho, cadeias de cores únicas podem ser usadas no lugar de listas de um elemento, ou seja,
'red'em vez de['red']colorir todos os níveis com a mesma cor. Este atalho funciona apenas para sequências de cores, não para outras formas de especificar cores.Por padrão (valor None ), o mapa de cores especificado por cmap será usado.
- flutuação alfa , padrão: 1
O valor de mistura alfa, entre 0 (transparente) e 1 (opaco).
- cmap str ou
Colormap, padrão:rcParams["image.cmap"](padrão:'viridis') A instância do Colormap ou nome do mapa de cores registrado usado para mapear dados escalares para cores.
Este parâmetro é ignorado se as cores forem definidas.
- norma str ou
Normalize, opcional O método de normalização usado para dimensionar dados escalares para o intervalo [0, 1] antes de mapear para cores usando cmap . Por padrão, uma escala linear é usada, mapeando o valor mais baixo para 0 e o mais alto para 1.
Se fornecido, pode ser um dos seguintes:
Uma instância
Normalizeou uma de suas subclasses (consulte Normalização do mapa de cores ).Um nome de escala, ou seja, um de "linear", "log", "symlog", "logit", etc. Para obter uma lista de escalas disponíveis, chame
matplotlib.scale.get_scale_names(). Nesse caso, umaNormalizesubclasse adequada é gerada e instanciada dinamicamente.
Este parâmetro é ignorado se as cores forem definidas.
- vmin, vmax flutuante, opcional
Ao usar dados escalares e nenhuma norma explícita , vmin e vmax definem o intervalo de dados que o mapa de cores cobre. Por padrão, o mapa de cores cobre toda a faixa de valores dos dados fornecidos. É um erro usar vmin / vmax quando uma instância de norma é fornecida (mas usar um nome de norma junto com vmin / vmax é aceitável).
strSe vmin ou vmax não forem fornecidos, a escala de cores padrão será baseada em níveis .
Este parâmetro é ignorado se as cores forem definidas.
- origin { Nenhum , 'superior', 'inferior', 'imagem'}, padrão: Nenhum
Determina a orientação e a posição exata de Z especificando a posição de . Isso só é relevante se X , Y não forem fornecidos.
Z[0, 0]Nenhum : está em X=0, Y=0 no canto inferior esquerdo.
Z[0, 0]'inferior': está em X=0.5, Y=0.5 no canto inferior esquerdo.
Z[0, 0]'superior': está em X=N+0,5, Y=0,5 no canto superior esquerdo.
Z[0, 0]'imagem': Use o valor de
rcParams["image.origin"](padrão:'upper').
- extensão (x0, x1, y0, y1), opcional
Se origin não for None , a extensão será interpretada como em
imshow: fornece os limites externos do pixel. Nesse caso, a posição de Z[0, 0] é o centro do pixel, não um canto. Se origin for None , então ( x0 , y0 ) é a posição de Z[0, 0], e ( x1 , y1 ) é a posição de Z[-1, -1].Este argumento é ignorado se X e Y forem especificados na chamada para contorno.
- locator ticker.Locator subclasse, opcional
O localizador é usado para determinar os níveis de contorno se eles não forem dados explicitamente através de níveis . O padrão é
MaxNLocator.- extend {'neither', 'both', 'min', 'max'}, default: 'neither'
Determina a
tricontourcoloração de valores que estão fora do intervalo de níveis .Se 'nenhum', os valores fora do intervalo de níveis não são coloridos. Se 'min', 'max' ou 'both', pinte os valores abaixo, acima ou abaixo e acima da faixa de níveis .
Os valores abaixo
min(levels)e acimamax(levels)são mapeados para os valores abaixo/acima doColormap. Observe que a maioria dos mapas de cores não possui cores dedicadas para eles por padrão, de modo que os valores acima e abaixo são os valores de borda do mapa de cores. Você pode querer definir esses valores explicitamente usandoColormap.set_undereColormap.set_over.Observação
Um existente
TriContourSetnão é notificado se as propriedades de seu mapa de cores forem alteradas. Portanto, uma chamada explícita paraContourSet.changed()é necessária após modificar o mapa de cores. A chamada explícita pode ser deixada de fora, se uma barra de cores for atribuída aTriContourSetporque ela chama internamenteContourSet.changed().- xunits, yunits unidades registradas, opcional
Substitua unidades de eixo especificando uma instância de um arquivo
matplotlib.units.ConversionInterface.- bool antialiased , opcional
Ative o antialiasing, substituindo os padrões. Para contornos preenchidos, o padrão é True . Para contornos de linha, é obtido de
rcParams["lines.antialiased"](padrão:True).- larguras de linha flutuantes ou semelhantes a matrizes, padrão:
rcParams["contour.linewidth"](padrão:None) A largura da linha das linhas de contorno.
Se for um número, todos os níveis serão plotados com essa largura de linha.
Se for uma sequência, os níveis em ordem crescente serão plotados com as larguras de linha na ordem especificada.
Se Nenhum, retorna para
rcParams["lines.linewidth"](padrão:1.5).- estilos de linha { Nenhum , 'sólido', 'tracejado', 'traço pontilhado', 'pontilhado'}, opcional
Se estilos de linha forem Nenhum , o padrão será 'sólido', a menos que as linhas sejam monocromáticas. Nesse caso, os contornos negativos terão seu estilo de linha da configuração
rcParams["contour.negative_linestyle"](padrão:'dashed').estilos de linha também podem ser iteráveis das strings acima, especificando um conjunto de estilos de linha a serem usados. Se este iterável for menor que o número de níveis de contorno, ele será repetido conforme necessário.
Exemplos usando matplotlib.axes.Axes.tricontour#
Gráfico de contorno de dados espaçados irregularmente
