matplotlib.pyplot.contour #

matplotlib.pyplot. contorno ( * args , dados = Nenhum , ** kwargs ) [fonte] #

Traçar linhas de contorno.

Assinatura de chamada:

contour([X, Y,] Z, [levels], **kwargs)

contoure contourfdesenhe linhas de contorno e contornos preenchidos, respectivamente. Exceto conforme observado, as assinaturas de função e os valores de retorno são os mesmos para ambas as versões.

Parâmetros :
X, Y tipo array, opcional

As coordenadas dos valores em Z .

X e Y devem ser 2D com a mesma forma de Z (por exemplo, criados via numpy.meshgrid), ou ambos devem ser 1-D, de modo que seja o número de colunas em Z e seja o número de linhas em Z .len(X) == Nlen(Y) == M

X e Y devem ser ordenados monotonicamente.

Se não fornecidos, eles são considerados índices inteiros, ou seja , , .X = range(N)Y = range(M)

Z (M, N) semelhante a matriz

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 :
QuadContourSet
Outros Parâmetros :
corner_mask bool, padrão: rcParams["contour.corner_mask"](padrão: True)

Ativar/desativar a máscara de canto, que só tem efeito se Z for uma matriz mascarada. Se False, qualquer quad tocando um ponto mascarado é mascarado. Se True, apenas os vértices triangulares dos quads mais próximos desses pontos são sempre mascarados, outros vértices triangulares compreendendo três pontos não mascarados são contornados como de costume.

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

As cores dos níveis, ou seja, as linhas contoure as áreas para contourf.

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:

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 contourfcoloraçã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 QuadContourSetnão é notificado se as propriedades de seu mapa de cores forem alteradas. Portanto, uma chamada explícita QuadContourSet.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 QuadContourSetporque ela chama internamente QuadContourSet.changed().

Exemplo:

x = np.arange(1, 10)
y = x.reshape(-1, 1)
h = x * y

cs = plt.contourf(h, levels=[10, 30, 50],
    colors=['#808080', '#A0A0A0', '#C0C0C0'], extend='both')
cs.cmap.set_over('red')
cs.cmap.set_under('blue')
cs.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).

nchunk int >= 0, opcional

Se 0, nenhuma subdivisão do domínio. Especifique um número inteiro positivo para dividir o domínio em subdomínios de nchunk por nchunk quads. Chunking reduz o comprimento máximo de polígonos gerados pelo algoritmo de contorno, o que reduz a carga de trabalho de renderização passada para o back-end e também requer um pouco menos de RAM. No entanto, ele pode introduzir artefatos de renderização nos limites do bloco, dependendo do back-end, do sinalizador antialiased e do valor de alpha .

larguras de linha flutuantes ou semelhantes a matrizes, padrão: rcParams["contour.linewidth"](padrão: None)

Aplica-se apenas a contour .

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

Aplica-se apenas a contour .

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 irão, em vez disso, obter seu estilo de linha do argumento de estilos_de_linha negativos .

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.

estilo_de_linha negativa { Nenhum , 'sólido', 'tracejado', 'traço pontilhado', 'pontilhado'}, opcional

Aplica-se apenas a contour .

Se estilos de linha forem Nenhum e as linhas forem monocromáticas, esse argumento especifica o estilo de linha para contornos negativos.

Se estilo_de_linha negativa for Nenhum , o padrão será obtido de rcParams["contour.negative_linestyles"].

Negative_linestyles também pode ser iterável 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.

lista de hachuras [str], opcional

Aplica-se apenas a contourf .

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.

algoritmo {'mpl2005', 'mpl2014', 'serial', 'threaded'}, opcional

Qual algoritmo de contorno usar para calcular as linhas de contorno e polígonos. Os algoritmos são implementados no ContourPy , consulte a documentação do ContourPy para obter mais informações.

O padrão é obtido de rcParams["contour.algorithm"](padrão: 'mpl2014').

objeto indexável de dados , opcional

Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

Notas

  1. contourfdifere da versão MATLAB porque não desenha as arestas do polígono. Para desenhar arestas, adicione contornos de linha com chamadas a contour.

  2. contourfpreenche 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).

  3. contoure contourfuse um algoritmo de praças marchando para calcular as localizações do contorno. Mais informações podem ser encontradas na documentação do ContourPy .

Exemplos usando matplotlib.pyplot.contour#

funções interativas

funções interativas

funções interativas