matplotlib.pyplot.tricontourf

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

Desenhe regiões de contorno em uma grade triangular não estruturada.

Assinaturas de chamada:

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

A grade triangular pode ser especificada passando um Triangulation objeto como primeiro parâmetro ou passando os pontos x , y e opcionalmente os triângulos e uma máscara . Consulte Triangulationpara 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.tricontourf(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 malha 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.

Devoluções :

TriContourSet

Outros Parâmetros :

cores seqüência de cores ou sequência de cores, opcional

As cores dos níveis, ou seja, as regiões 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, uma Normalizesubclasse 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).str

Se 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 tricontourfcoloraçã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 acima max(levels)são mapeados para os valores abaixo/acima do Colormap. 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 usando Colormap.set_undere Colormap.set_over.

Observação

Um existente TriContourSetnão é notificado se as propriedades de seu mapa de cores forem alteradas. Portanto, uma chamada explícita para ContourSet.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 a TriContourSetporque ela chama internamente ContourSet.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).

lista de hachuras [str], opcional

Uma lista de padrões de hachura cruzada para usar nas áreas preenchidas. Se Nenhum, nenhuma hachura será adicionada ao contorno. A hachura é suportada apenas nos back-ends PostScript, PDF, SVG e Agg.

Notas

tricontourfpreenche intervalos fechados na parte superior; ou seja, para os limites z1 e z2 , a região preenchida é:

z1 < Z <= z2

exceto para o intervalo mais baixo, que é fechado em ambos os lados (ou seja, inclui o valor mais baixo).