matplotlib.contour

Classes para oferecer suporte a plotagem de contorno e rotulagem para a classe Axes.

classe matplotlib.contour. ClabelText ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode = Nenhum, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Bases:Text

Ao contrário do texto comum, o get_rotation retorna um ângulo atualizado na coordenada de pixel assumindo que a rotação de entrada é um ângulo na coordenada de dados (ou qualquer conjunto de transformação).

Crie uma Textinstância em x , y com string text .

O texto é alinhado em relação ao ponto de ancoragem ( x , y ) de acordo com horizontalalignment(padrão: 'esquerda') e verticalalignment (padrão: 'inferior'). Consulte também Alinhamento de texto .

Embora o texto aceite o argumento de palavra-chave 'rótulo', por padrão ele não é adicionado aos identificadores de uma legenda.

Os argumentos de palavra-chave válidos são:

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	desconhecido
clip_on	desconhecido
clip_path	desconhecido
colorou c	cor
figure	Figure
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

get_rotation ( )

Retorna o ângulo do texto em graus entre 0 e 360.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<DESATIVAR>, horizontalalignment=<UNSET>, in_layout=<UNSET> , label=<UNSET> , linepacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , seletor =<UNSET> , position=<UNSET> , rasterizado=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=< DESCONFIGURAR> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
colorou c	cor
figure	Figure
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

classe matplotlib.contour. ContourLabeler

Bases:object

Mixin para fornecer capacidade de rotulagem para arquivos ContourSet.

add_label ( x , y , rotação , lev , cvalue )

Adicionar rótulo de contorno usando Textclass.

add_label_clabeltext ( x , y , rotação , lev , cvalue )

Adicionar rótulo de contorno usando ClabelTextclass.

add_label_near ( x , y , inline = True , inline_spacing = 5 , transform = None )

Adicione um rótulo próximo ao ponto .(x, y)

Parâmetros :

x, y flutuam

A localização aproximada da etiqueta.

bool embutido , padrão: True

Se True , remova o segmento do contorno abaixo do rótulo.

inline_spacing int, padrão: 5

Espaço em pixels a ser deixado em cada lado da etiqueta ao colocar em linha. Este espaçamento será exato para etiquetas em locais onde o contorno é reto, menos para etiquetas em contornos curvos.

transformar Transformou False, padrão:self.axes.transData

Uma transformação aplicada antes da rotulagem. As causas padrão devem ser interpretadas como coordenadas de dados. é sinônimo de ; ou seja , deve ser interpretado como coordenadas de exibição.(x, y)(x, y)FalseIdentityTransform(x, y)

calc_label_rot_and_inline ( slc , ind , lw , lc = Nenhum , espaçamento = 5 )

Calcule a rotação apropriada da etiqueta dadas as coordenadas do contorno da linha em unidades de tela, o índice da localização da etiqueta e a largura da etiqueta.

Se lc não for None ou estiver vazio, quebre também contornos e calcule inlining.

espaçamento é o espaço vazio a ser deixado ao redor do rótulo, em pixels.

Ambas as tarefas são executadas juntas para evitar o cálculo de comprimentos de caminho várias vezes, o que é relativamente caro.

O método usado aqui envolve calcular o comprimento do caminho ao longo do contorno em coordenadas de pixel e, em seguida, olhar aproximadamente (largura do rótulo / 2) para longe do ponto central para determinar a rotação e, em seguida, quebrar o contorno, se desejado.

clabel ( levels = None , * , fontsize = None , inline = True , inline_spacing = 5 , fmt = None , colors = None , use_clabeltext = False , manual = False , rightside_up = True , zorder = None )

Rotule um gráfico de contorno.

Adiciona rótulos aos contornos de linha neste ContourSet(que herda desta classe mixin).

Parâmetros :

níveis tipo array, opcional

Uma lista de valores de nível, que devem ser rotulados. A lista deve ser um subconjunto de cs.levels. Se não fornecido, todos os níveis são rotulados.

fontsize str ou float, padrão: rcParams["font.size"](padrão: 10.0)

Tamanho em pontos ou tamanho relativo, por exemplo, 'menor', 'ex-grande'. Consulte Text.set_sizeos valores de string aceitos.

cores cor ou cores ou Nenhum, padrão: Nenhum

As cores da etiqueta:

• Se None , a cor de cada rótulo corresponde à cor do contorno correspondente.

• Se uma cor de string, por exemplo, colors = 'r' ou colors = 'red', todos os rótulos serão plotados nesta cor.

• Se for uma tupla de cores (string, float, rgb, etc), rótulos diferentes serão plotados em cores diferentes na ordem especificada.

bool embutido , padrão: True

Se Trueo contorno subjacente for removido onde o rótulo é colocado.

flutuante inline_spacing , padrão: 5

Espaço em pixels a ser deixado em cada lado da etiqueta ao colocar em linha.

Este espaçamento será exato para etiquetas em locais onde o contorno é reto, menos para etiquetas em contornos curvos.

fmt Formatterou str ou callable ou dict, opcional

Como os níveis são formatados:

• Se for Formatter, ele é usado para formatar todos os níveis de uma vez, usando seu Formatter.format_ticksmétodo.

• Se for uma str, ela será interpretada como uma string de formato de estilo %.

• Se for callable, é chamado com um nível de cada vez e deve retornar o rótulo correspondente.

• Se for um ditado, ele deve mapear diretamente os níveis para os rótulos.

O padrão é usar um arquivo ScalarFormatter.

manual bool ou iterável, padrão: False

Se True, os rótulos de contorno serão inseridos manualmente usando cliques do mouse. Clique no primeiro botão perto de um contorno para adicionar um rótulo, clique no segundo botão (ou possivelmente em ambos os botões do mouse ao mesmo tempo) para terminar de adicionar rótulos. O terceiro botão pode ser usado para remover o último rótulo adicionado, mas apenas se os rótulos não estiverem embutidos. Como alternativa, o teclado pode ser usado para selecionar os locais dos rótulos (enter para terminar o posicionamento do rótulo, excluir ou retroceder como o terceiro botão do mouse e qualquer outra tecla selecionará um local do rótulo).

manual também pode ser um objeto iterável de tuplas (x, y). Os rótulos de contorno serão criados como se o mouse fosse clicado em cada posição (x, y).

rightside_up bool, padrão: True

Se True, as rotações do rótulo sempre serão mais ou menos 90 graus do nível.

use_clabeltext bool, padrão: Falso

Se True, ClabelTexta classe (em vez de Text) é usada para criar rótulos. ClabelTextrecalcula os ângulos de rotação dos textos durante o tempo de desenho, portanto, isso pode ser usado se o aspecto dos eixos mudar.

zorder float ou None, padrão:(2 + contour.get_zorder())

ordem z dos rótulos de contorno.

Devoluções :

rótulos

Uma lista de Textinstâncias para os rótulos.

get_label_width ( lev , fmt , fsize )

[ Obsoleto ] Retorna a largura do rótulo em pontos.

Notas

Obsoleto desde a versão 3.5.

get_text ( lev , fmt )

Obtenha o texto do rótulo.

rótulos ( inline , inline_spacing )

location_label ( linecontour , labelwidth )

Encontre um bom lugar para desenhar um rótulo (parte relativamente plana do contorno).

pop_label ( índice = -1 )

O padrão é remover o último rótulo, mas qualquer índice pode ser fornecido

print_label ( linecontour , labelwidth )

Retorna se um contorno é longo o suficiente para conter um rótulo.

set_label_props ( label , texto , cor )

Defina as propriedades do rótulo - cor, tamanho da fonte, texto.

too_close ( x , y , lw )

Retorna se um rótulo já está próximo a este local.

classe matplotlib.contour. ContourSet ( ax , * args , levels = Nenhum , preenchido = False , linewidths = Nenhum , estilos de linha = Nenhum , hachuras = (Nenhum,) , alpha = Nenhum , origem = Nenhum , extensão = Nenhum , cmap = Nenhum , cores = Nenhum , norma =None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs )

Bases: ScalarMappable,ContourLabeler

Armazene um conjunto de linhas de contorno ou regiões preenchidas.

Método chamado pelo usuário:clabel

Parâmetros :

machadoAxes

níveis [level0, level1, ..., leveln]

Uma lista de números de ponto flutuante indicando os níveis de contorno.

allsegs [level0segs, level1segs, ...]

Lista de todos os segmentos de polígonos para todos os níveis . Para linhas de contorno e para regiões de contorno preenchidas . As listas devem se parecer comlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

todos os tipos Noneou [level0kinds, level1kinds, ...]

Lista opcional de todos os tipos de vértices de polígonos (tipos de código), conforme descrito e usado em Path. Isso é usado para permitir caminhos multiplamente conectados, como buracos dentro de polígonos preenchidos. Se não None, . As listas devem se parecer comlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds não for None, geralmente todos os polígonos para um determinado nível de contorno são agrupados de modo que e .level0segs = [polygon0]level0kinds = [polygon0kinds]

** kwargs

Os argumentos de palavra-chave são descritos na docstring de contour.

Atributos :

machadoAxes

O objeto Axes no qual os contornos são desenhados.

coleções silent_listde PathCollections

Os Artists representam o contorno. Esta é uma lista de PathCollections para linhas e contornos preenchidos.

matriz de níveis

Os valores dos níveis de contorno.

matriz de camadas

Igual aos níveis para contornos de linha; a meio caminho entre os níveis para contornos preenchidos. Veja ContourSet._process_colors.

Desenhe linhas de contorno ou regiões preenchidas , dependendo se a palavra-chave arg fill é False(padrão) ou True.

Assinatura de chamada:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parâmetros :

machadoAxes

O Axesobjeto a ser desenhado.

níveis [level0, level1, ..., leveln]

Uma lista de números de ponto flutuante indicando os níveis de contorno.

allsegs [level0segs, level1segs, ...]

Lista de todos os segmentos de polígonos para todos os níveis . Para linhas de contorno e para regiões de contorno preenchidas . As listas devem se parecer comlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds [level0kinds, level1kinds, ...], opcional

Lista opcional de todos os tipos de vértices de polígonos (tipos de código), conforme descrito e usado em Path. Isso é usado para permitir caminhos multiplamente conectados, como buracos dentro de polígonos preenchidos. Se não None, . As listas devem se parecer comlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds não for None, geralmente todos os polígonos para um determinado nível de contorno são agrupados de modo que e .level0segs = [polygon0]level0kinds = [polygon0kinds]

** kwargs

Os argumentos de palavra-chave são descritos na docstring de contour.

mudou ( )

Chame isso sempre que o mapeável for alterado para notificar todos os ouvintes de callbackSM sobre o sinal 'alterado'.

find_nearest_contour ( x , y , índices = Nenhum , pixel = True )

Encontre o ponto no gráfico de contorno que está mais próximo de .(x, y)

Este método não suporta contornos preenchidos.

Parâmetros :

x, y flutuam

O ponto de referência.

lista de índices de int ou None, padrão: None

Índices de níveis de contorno a considerar. Se Nenhum (o padrão), todos os níveis são considerados.

pixel bool, padrão: True

Se True , mede a distância em espaço de pixel (tela), o que é útil para rotulagem de contorno manual; caso contrário, meça a distância no espaço dos eixos.

Devoluções :

contornoCollection

O contorno que está mais próximo de .(x, y)

segmento int

O índice do Pathcontorno que está mais próximo de .(x, y)

index int

O índice do segmento de caminho no segmento que está mais próximo de .(x, y)

xmin, ymin flutuante

O ponto no gráfico de contorno que está mais próximo de .(x, y)

d2 flutuante

A distância ao quadrado de a .(xmin, ymin)(x, y)

get_alpha ( )

Alfa de retorno a ser aplicado a todos os artistas do ContourSet.

get_transform ( )

Retorna a Transforminstância usada por este ContourSet.

legend_elements ( variables_name='x' , str_format=<class 'str'> )

Retorna uma lista de artistas e rótulos adequados para passagem legendque representam este ContourSet.

Os rótulos têm a forma "0 < x <= 1" informando os intervalos de dados que os artistas representam.

Parâmetros :

variável_nome str

A string usada dentro da desigualdade usada nos rótulos.

função str_format : float -> str

Função utilizada para formatar os números nas etiquetas.

Devoluções :

lista de artistas [ Artist]

Uma lista dos artistas.

lista de marcadores [str]

Uma lista dos rótulos.

set_alpha ( alpha )

Defina o valor de mistura alfa para todos os artistas ContourSet. alfa deve estar entre 0 (transparente) e 1 (opaco).

classe matplotlib.contour. QuadContourSet ( ax , * args , níveis = Nenhum , preenchido = False , linewidths = Nenhum , estilos de linha = Nenhum , hachuras = (Nenhum,) , alfa = Nenhum , origem = Nenhum , extensão = Nenhum , cmap = Nenhum , cores = Nenhum , norma =None , vmin = None , vmax = None , extend = 'neither' , antialiased = None , nchunk = 0 , locator = None , transform = None , negative_linestyles = None , ** kwargs )

Bases:ContourSet

Crie e armazene um conjunto de linhas de contorno ou regiões preenchidas.

Essa classe normalmente não é instanciada diretamente pelo usuário, mas por contoure contourf.

Atributos :

machadoAxes

O objeto Axes no qual os contornos são desenhados.

coleções silent_listde PathCollections

Os Artists representam o contorno. Esta é uma lista de PathCollections para linhas e contornos preenchidos.

matriz de níveis

Os valores dos níveis de contorno.

matriz de camadas

Igual aos níveis para contornos de linha; a meio caminho entre os níveis para contornos preenchidos. Veja ContourSet._process_colors.

Desenhe linhas de contorno ou regiões preenchidas , dependendo se a palavra-chave arg fill é False(padrão) ou True.

Assinatura de chamada:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Parâmetros :

machadoAxes

O Axesobjeto a ser desenhado.

níveis [level0, level1, ..., leveln]

Uma lista de números de ponto flutuante indicando os níveis de contorno.

allsegs [level0segs, level1segs, ...]

Lista de todos os segmentos de polígonos para todos os níveis . Para linhas de contorno e para regiões de contorno preenchidas . As listas devem se parecer comlen(allsegs) == len(levels)len(allsegs) = len(levels)-1

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds [level0kinds, level1kinds, ...], opcional

Lista opcional de todos os tipos de vértices de polígonos (tipos de código), conforme descrito e usado em Path. Isso é usado para permitir caminhos multiplamente conectados, como buracos dentro de polígonos preenchidos. Se não None, . As listas devem se parecer comlen(allkinds) == len(allsegs)

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Se allkinds não for None, geralmente todos os polígonos para um determinado nível de contorno são agrupados de modo que e .level0segs = [polygon0]level0kinds = [polygon0kinds]

** kwargs

Os argumentos de palavra-chave são descritos na docstring de contour.