matplotlib.axes.Axes.tricontourf #
- Machados. tricontourf ( * args , ** kwargs ) [fonte] #
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
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.
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 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 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, 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
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 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).- 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).
Exemplos usando matplotlib.axes.Axes.tricontourf#
Gráfico de contorno de dados espaçados irregularmente
