matplotlib.ticker

Marque a localização e formatação

Este módulo contém classes para configurar a localização e formatação de ticks. Localizadores de ticks e formatadores genéricos são fornecidos, bem como personalizados específicos de domínio.

Embora os localizadores não saibam nada sobre marcas principais ou secundárias, eles são usados ​​pela classe Axis para oferecer suporte à localização e formatação de marcas principais e secundárias.

Marque a localização

A classe Locator é a classe base para todos os localizadores de ticks. Os localizadores lidam com o escalonamento automático dos limites de exibição com base nos limites de dados e na escolha de locais de marcação. Um localizador de ticks semiautomático útil é MultipleLocator. Ele é inicializado com uma base, por exemplo, 10, e escolhe limites de eixo e escalas que são múltiplos dessa base.

As subclasses Locator definidas aqui são:

AutoLocator	MaxNLocatorcom padrões simples. Este é o localizador de escala padrão para a maioria das plotagens.
MaxNLocator	Localiza até um número máximo de intervalos com carrapatos em locais agradáveis.
LinearLocator	O espaço marca uniformemente do mínimo ao máximo.
LogLocator	O espaço marca logaritmicamente do mínimo ao máximo.
MultipleLocator	Ticks e alcance são múltiplos da base; inteiro ou flutuante.
FixedLocator	Os locais dos ticks são fixos.
IndexLocator	Localizador para plotagens de índice (por exemplo, where ).x = range(len(y))
NullLocator	Sem carrapatos.
SymmetricalLogLocator	Localizador para uso com a norma symlog; funciona como LogLocatorpara a parte fora do limite e adiciona 0 se estiver dentro dos limites.
AsinhLocator	Localizador para uso com a norma asinh, tentando espaçar os ticks de maneira aproximadamente uniforme.
LogitLocator	Localizador para escala logit.
AutoMinorLocator	Localizador para marcações secundárias quando o eixo é linear e as marcas principais são espaçadas uniformemente. Subdivide o intervalo de marcação principal em um número especificado de intervalos menores, padronizando para 4 ou 5, dependendo do intervalo principal.

Existem vários localizadores especializados em localização de datas - veja o datesmódulo.

Você pode definir seu próprio localizador derivando de Locator. Você deve substituir o __call__método, que retorna uma sequência de locais, e provavelmente desejará substituir o método autoscale para definir os limites de exibição dos limites de dados.

Se você deseja substituir o localizador padrão, use um dos acima ou um localizador personalizado e passe-o para a instância do eixo x ou y. Os métodos relevantes são:

ax.xaxis.set_major_locator(xmajor_locator)
ax.xaxis.set_minor_locator(xminor_locator)
ax.yaxis.set_major_locator(ymajor_locator)
ax.yaxis.set_minor_locator(yminor_locator)

O localizador secundário padrão é NullLocator, ou seja, nenhum sinal secundário ativado por padrão.

Observação

Locatoras instâncias não devem ser usadas com mais de um Axisou Axes. Então ao invés de:

locator = MultipleLocator(5)
ax.xaxis.set_major_locator(locator)
ax2.xaxis.set_major_locator(locator)

em vez disso, faça o seguinte:

ax.xaxis.set_major_locator(MultipleLocator(5))
ax2.xaxis.set_major_locator(MultipleLocator(5))

Marque a formatação

A formatação do Tick é controlada por classes derivadas do Formatter. O formatador opera em um único valor de tick e retorna uma string para o eixo.

NullFormatter	Sem rótulos nos carrapatos.
FixedFormatter	Defina as strings manualmente para os rótulos.
FuncFormatter	A função definida pelo usuário define os rótulos.
StrMethodFormatter	Use o método string format.
FormatStrFormatter	Use uma string de formato sprintf de estilo antigo.
ScalarFormatter	Formatador padrão para escalares: escolha automaticamente a string de formato.
LogFormatter	Formatador para eixos de log.
LogFormatterExponent	Formate os valores para o eixo de log usando .exponent = log_base(value)
LogFormatterMathtext	Formate os valores para o eixo de log usando o texto Math.exponent = log_base(value)
LogFormatterSciNotation	Formate valores para o eixo logarítmico usando notação científica.
LogitFormatter	Formatador de probabilidade.
EngFormatter	Formate rótulos em notação de engenharia.
PercentFormatter	Formate os rótulos como uma porcentagem.

Você pode derivar seu próprio formatador da classe base Formatter simplesmente substituindo o __call__método. A classe do formatador tem acesso à visualização do eixo e aos limites de dados.

Para controlar os formatos de rótulo de escala maior e menor, use um dos seguintes métodos:

ax.xaxis.set_major_formatter(xmajor_formatter)
ax.xaxis.set_minor_formatter(xminor_formatter)
ax.yaxis.set_major_formatter(ymajor_formatter)
ax.yaxis.set_minor_formatter(yminor_formatter)

Além de uma Formatterinstância, set_major_formattertambém set_minor_formatteraceita uma strfunção ou. strinput será substituído internamente por um gerado automaticamente StrMethodFormattercom o input str. Para entrada de função, um FuncFormattercom a função de entrada será gerado e usado.

Consulte Marcações principais e secundárias para obter um exemplo de configuração de marcações principais e secundárias. Consulte o matplotlib.datesmódulo para obter mais informações e exemplos de uso de localizadores e formatadores de data.

classe matplotlib.ticker. AsinhLocator ( linear_width , numticks = 11 , symthresh = 0.2 , base = 10 , subs = None )

Bases:Locator

Um localizador de carrapatos de eixo especializado para a escala sinh inversa

É muito improvável que isso tenha qualquer uso além da AsinhScaleclasse.

Observação

Esta API é provisória e pode ser revisada no futuro com base nos primeiros comentários dos usuários.

Parâmetros :

linear_width flutuante

O parâmetro de escala que define a extensão da região quase linear.

numticks int, padrão: 11

O número aproximado de marcações principais que caberão ao longo de todo o eixo

flutuação do symthresh , padrão: 0,2

O limite fracionário abaixo do qual os dados que cobrem um intervalo aproximadamente simétrico em relação a zero terão marcas que são exatamente simétricas.

base int, padrão: 10

A base numérica usada para arredondar os locais dos ticks em uma escala logarítmica. Se for menor que um, o arredondamento será para o múltiplo inteiro mais próximo de potências de dez.

sub tupla, padrão: Nenhum

Múltiplos da base numérica, normalmente usados ​​para os ticks menores, por exemplo (2, 5) quando base=10.

set_params ( numticks = Nenhum , symthresh = Nenhum , base = Nenhum , subs = Nenhum )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. Localizador Automático

Bases:MaxNLocator

Encontre dinamicamente as principais posições dos ticks. Na verdade, é uma subclasse de MaxNLocator, com parâmetros nbins = 'auto' e steps = [1, 2, 2.5, 5, 10] .

Para saber os valores dos parâmetros não públicos, dê uma olhada nos padrões de MaxNLocator.

classe matplotlib.ticker. AutoMinorLocator ( n = Nenhum )

Bases:Locator

Encontre dinamicamente posições de ticks menores com base nas posições dos ticks principais. A escala deve ser linear com marcas principais uniformemente espaçadas.

n é o número de subdivisões do intervalo entre os ticks principais; por exemplo, n=2 colocará um único tique menor no meio do caminho entre os tiques maiores.

Se n for omitido ou Nenhum, será definido como 5 ou 4.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. EngFormatter ( unidade = '' , lugares = Nenhum , sep = ' ' , * , usetex = Nenhum , useMathText = Nenhum )

Bases:Formatter

Formate os valores do eixo usando prefixos de engenharia para representar potências de 1000, mais uma unidade especificada, por exemplo, 10 MHz em vez de 1e7.

Parâmetros :

unidade str, padrão: ""

Símbolo de unidade a ser usado, adequado para uso com representações de potências de 1000 com uma única letra. Por exemplo, 'Hz' ou 'm'.

coloca int, padrão: Nenhum

Precisão com que exibir o número, especificado em dígitos após a vírgula (haverá entre um e três dígitos antes da vírgula). Se for Nenhum, a formatação volta para o formato de ponto flutuante '%g', que exibe até 6 dígitos significativos , ou seja, o valor equivalente para casas varia entre 0 e 5 (inclusive).

sep str, padrão: " "

Separador usado entre o valor e o prefixo/unidade. Por exemplo, obtém-se '3,14 mV' se sepfor " " (padrão) e '3,14mV' se sepfor "". Além do comportamento padrão, algumas outras opções úteis podem ser:

• sep=""para anexar diretamente o prefixo/unidade ao valor;

• sep="\N{THIN SPACE}"( U+2009);

• sep="\N{NARROW NO-BREAK SPACE}"( U+202F);

• sep="\N{NO-BREAK SPACE}"( U+00A0).

usetex bool, padrão: rcParams["text.usetex"](padrão: False)

Ativar/desativar o uso do modo matemático do TeX para renderizar os números no formatador.

useMathText bool, padrão: rcParams["axes.formatter.use_mathtext"](padrão: False)

Para ativar/desativar, use o mathtext para renderizar os números no formatador.

POR_PREFIXES = {-24: 'y', -21: 'z', -18: 'a', -15: 'f', -12: 'p', -9: 'n', -6: 'µ ', -3: 'm', 0: '', 3: 'k', 6: 'M', 9: 'G', 12: 'T', 15: 'P', 18: 'E', 21: 'Z', 24: 'Y'}

format_eng ( num )

Formate um número em notação de engenharia, acrescentando uma letra que representa a potência de 1000 do número original. Alguns exemplos:

>>> format_eng(0)        # for self.places = 0
'0'

>>> format_eng(1000000)  # for self.places = 1
'1.0 M'

>>> format_eng("-1e-6")  # for self.places = 2
'-1.00 µ'

get_useMathText ( )

get_usetex ( )

set_useMathText ( val )

set_usetex ( val )

propriedade useMathText

propriedade usetex

classe matplotlib.ticker. FixedFormatter ( seq )

Bases:Formatter

Retorne strings fixas para rótulos de escala com base apenas na posição, não no valor.

Observação

FixedFormattersó deve ser usado em conjunto com FixedLocator. Caso contrário, as etiquetas podem ficar em posições inesperadas.

Defina a sequência seq de strings que serão usadas para rótulos.

get_offset ( )

set_offset_string ( ofs )

classe matplotlib.ticker. FixedLocator ( locs , nbins = None )

Bases:Locator

Os locais dos ticks são fixos. Se nbins não for None, a matriz de posições possíveis será subamostrada para manter o número de ticks <= nbins +1. A subamostragem será feita de forma a incluir o menor valor absoluto; por exemplo, se zero for incluído na matriz de possibilidades, é garantido que seja um dos ticks escolhidos.

set_params ( nbins = Nenhum )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os locais dos carrapatos.

Observação

Como os valores são fixos, vmin e vmax não são usados ​​neste método.

classe matplotlib.ticker. FormatStrFormatter ( fmt )

Bases:Formatter

Use uma string de formato de estilo antigo (operador '%') para formatar o tick.

A string de formato deve ter um único formato de variável (%) nela. Será aplicado ao valor (não à posição) do tick.

Valores numéricos negativos usarão um traço, não um sinal de menos Unicode; use mathtext para obter um Unicode menos envolvendo o especificador de formato com $ (por exemplo, "$%g$").

classe matplotlib.ticker. Formatador

Bases:TickHelper

Crie uma string com base em um valor e local de marcação.

static fix_minus ( s )

Algumas classes podem querer substituir um hífen para menos pelo símbolo Unicode adequado (U+2212) para correção tipográfica. Este é um método auxiliar para realizar tal substituição quando habilitado via rcParams["axes.unicode_minus"](padrão: True).

format_data ( valor )

Retorna a representação de string completa do valor com a posição não especificada.

format_data_short ( valor )

Retorna uma versão de string curta do valor do tick.

O padrão é o valor longo independente da posição.

format_ticks ( valores )

Retorne os rótulos dos ticks para todos os ticks de uma vez.

get_offset ( )

locais = []

set_locs ( locs )

Defina os locais dos carrapatos.

Este método é chamado antes de computar os rótulos dos ticks porque alguns formatadores precisam conhecer todos os locais dos ticks para fazer isso.

classe matplotlib.ticker. FuncFormatter ( func )

Bases:Formatter

Use uma função definida pelo usuário para formatação.

A função deve receber duas entradas (um valor de tick xe uma posição pos) e retornar uma string contendo o rótulo de tick correspondente.

get_offset ( )

set_offset_string ( ofs )

classe matplotlib.ticker. IndexLocator ( base , offset )

Bases:Locator

Coloque uma marca em cada múltiplo de algum número base de pontos plotados, por exemplo, em cada 5 pontos. Presume-se que você esteja fazendo a plotagem de índice; ou seja, o eixo é 0, len(dados). Isso é útil principalmente para x ticks.

Coloque marcas em cada ponto de dados base , começando no deslocamento .

set_params ( base = Nenhum , deslocamento = Nenhum )

Definir parâmetros dentro deste localizador

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. LinearLocator ( numticks = None , presets = None )

Bases:Locator

Determine os locais dos ticks

A primeira vez que esta função é chamada, ela tentará definir o número de ticks para fazer um bom particionamento de ticks. Posteriormente, o número de ticks será corrigido para que a navegação interativa seja agradável

Use predefinições para definir locs com base em lom. Um mapeamento dict vmin, vmax->locs

propriedade numticks

set_params ( numticks = Nenhum , presets = Nenhum )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Tente escolher os limites de visualização de forma inteligente.

classe matplotlib.ticker. Localizador

Bases:TickHelper

Determine os locais dos carrapatos;

Observe que o mesmo localizador não deve ser usado em vários Axisporque o localizador armazena referências aos dados do eixo e limites de exibição.

MAXTICKS = 1000

não singular ( v0 , v1 )

Ajuste um intervalo conforme necessário para evitar singularidades.

Este método é chamado durante o escalonamento automático, com os limites de dados definidos nos eixos se os eixos contiverem quaisquer dados ou não.(v0, v1)(-inf, +inf)

• Se (possivelmente até algum slop de ponto flutuante), esse método retorna um intervalo expandido em torno desse valor.v0 == v1

• Se , esse método retorna os limites de exibição padrão apropriados.(v0, v1) == (-inf, +inf)

• Caso contrário, é retornado sem modificação.(v0, v1)

raise_if_exceeds ( locs )

Registre no nível WARNING se locs for maior que Locator.MAXTICKS.

Destina-se a ser chamado imediatamente antes de retornar locs__call__ para informar os usuários caso seu localizador retorne um grande número de tiques, fazendo com que o Matplotlib fique sem memória.

O nome "estranho" desse método remonta a quando ele gerava uma exceção em vez de emitir um log.

set_params ( ** kwargs )

Não faça nada e dê um aviso. Qualquer classe de localizador que não suporte a função set_params() chamará isso.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Selecione uma escala para o intervalo de vmin a vmax.

As subclasses devem substituir esse método para alterar o comportamento do localizador.

classe matplotlib.ticker. LogFormatter ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Bases:Formatter

Classe base para formatação de ticks em uma escala de log ou symlog.

Pode ser instanciado diretamente ou subclasse.

Parâmetros :

flutuação base , padrão: 10.

Base do logaritmo usado em todos os cálculos.

labelOnlyBase bool, padrão: Falso

Se True, o rótulo marcará apenas em potências de base inteiras. Isso normalmente é Verdadeiro para tiques principais e Falso para tiques menores.

minor_thresholds (subconjunto, todos), padrão: (1, 0,4)

Se labelOnlyBase for False, esses dois números controlam a rotulagem de ticks que não estão em potências inteiras de base; normalmente estes são os carrapatos menores. O parâmetro de controle é o log da faixa de dados do eixo. No caso típico em que a base é 10, é o número de décadas abrangidas pelo eixo, portanto podemos chamá-lo de 'numdec'. Se , todos os ticks menores serão rotulados. Se , então apenas um subconjunto de ticks menores será rotulado, para evitar aglomeração. Se então, nenhum carrapato menor será rotulado.numdec <= allall < numdec <= subsetnumdec > subset

linthresh Nenhum ou flutuante, padrão: Nenhum

Se uma escala logarítmica simétrica estiver em uso, seu linthresh parâmetro deve ser fornecido aqui.

Notas

O set_locsmétodo deve ser chamado para habilitar a lógica de subconjunto controlada pelo minor_thresholdsparâmetro.

Em alguns casos, como na barra de cores, não há distinção entre marcações principais e secundárias; os locais dos ticks podem ser definidos manualmente ou por um localizador que coloca os ticks em potências inteiras de base e em locais intermediários. Para esta situação, desative a lógica minor_thresholds usando , para que todos os ticks sejam rotulados.minor_thresholds=(np.inf, np.inf)

Para desabilitar a rotulagem de ticks secundários quando 'labelOnlyBase' for False, use . Este é o padrão para o estilo "clássico".minor_thresholds=(0, 0)

Exemplos

Para rotular um subconjunto de marcações secundárias quando os limites de exibição abrangem até 2 décadas e todas as marcações quando ampliadas para 0,5 décadas ou menos, use .minor_thresholds=(2, 0.5)

Para rotular todos os ticks menores quando os limites de exibição abrangem até 1,5 décadas, use .minor_thresholds=(1.5, 1.5)

base ( base )

[ Obsoleto ] Altere a base para rotulagem.

Aviso

Deve sempre corresponder à base utilizada paraLogLocator

Notas

Obsoleto desde a versão 3.6: Use set_base() em vez disso.

format_data ( valor )

Retorna a representação de string completa do valor com a posição não especificada.

format_data_short ( valor )

Retorna uma versão de string curta do valor do tick.

O padrão é o valor longo independente da posição.

label_minor ( labelOnlyBase )

[ Obsoleto ] Ativar ou desativar a rotulagem de escala secundária.

Parâmetros :

labelOnlyBase bool

Se True, o rótulo marcará apenas em potências de base inteiras.

Notas

Obsoleto desde a versão 3.6: Use set_label_minor() em vez disso.

set_base ( base )

Altere a base para rotulagem.

Aviso

Deve sempre corresponder à base utilizada paraLogLocator

set_label_minor ( labelOnlyBase )

Ativar ou desativar a rotulagem de marca secundária.

Parâmetros :

labelOnlyBase bool

Se True, o rótulo marcará apenas em potências de base inteiras.

set_locs ( locs = Nenhum )

Use limites de exibição de eixo para controlar quais marcações são rotuladas.

O parâmetro locs é ignorado no presente algoritmo.

classe matplotlib.ticker. LogFormatterExponent ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Bases:LogFormatter

Formate os valores para o eixo de log usando .exponent = log_base(value)

classe matplotlib.ticker. LogFormatterMathtext ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Bases:LogFormatter

Formate os valores para o eixo de log usando .exponent = log_base(value)

classe matplotlib.ticker. LogFormatterSciNotation ( base = 10.0 , labelOnlyBase = False , minor_thresholds = Nenhum , linthresh = Nenhum )

Bases:LogFormatterMathtext

Formate os valores seguindo a notação científica em um eixo logarítmico.

classe matplotlib.ticker. LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = None )

Bases:Locator

Determinar os locais de marcação para eixos de log

Coloque marcas nos locais: subs[j] * base**i

Parâmetros :

flutuação base , padrão: 10.0

A base do log usado, portanto, os principais ticks são colocados em base**n, n integer.

subs Nenhum ou str ou sequência de float, padrão: (1.0,)

Fornece os múltiplos de potências inteiras da base na qual colocar os ticks. O padrão coloca os ticks apenas em potências inteiras da base. Os valores de sequência permitidos são 'auto'e 'all', sendo que ambos usam um algoritmo baseado nos limites de visualização do eixo para determinar se e como colocar tiques entre as potências inteiras da base. Com 'auto', os ticks são colocados apenas entre potências inteiras; com 'all', as potências inteiras são incluídas. Um valor de None é equivalente a 'auto'.

numticks Nenhum ou int, padrão: Nenhum

O número máximo de tiques a serem permitidos em um determinado eixo. O padrão de Nonetentará escolher de forma inteligente, desde que este Localizador já tenha sido atribuído a um eixo usando get_tick_space, mas, caso contrário, cairá para 9.

base ( base )

[ Obsoleto ] Defina a base de log (marca principal a cada base**i, i inteiro).

Notas

Obsoleto desde a versão 3.6: Em vez disso, use set_params(base=...).

não singular ( vmin , vmax )

Ajuste um intervalo conforme necessário para evitar singularidades.

Este método é chamado durante o escalonamento automático, com os limites de dados definidos nos eixos se os eixos contiverem quaisquer dados ou não.(v0, v1)(-inf, +inf)

• Se (possivelmente até algum slop de ponto flutuante), esse método retorna um intervalo expandido em torno desse valor.v0 == v1

• Se , esse método retorna os limites de exibição padrão apropriados.(v0, v1) == (-inf, +inf)

• Caso contrário, é retornado sem modificação.(v0, v1)

set_params ( base = Nenhum , subs = Nenhum , numdecs = Nenhum , numticks = Nenhum )

Defina os parâmetros neste localizador.

subs ( subs )

[ Descontinuado ] Defina os tiques secundários para o dimensionamento de log a cada base**i*subs[j].

Notas

Obsoleto desde a versão 3.6: Use set_params(subs=...) em vez disso.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Tente escolher os limites de visualização de forma inteligente.

classe matplotlib.ticker. LogitFormatter ( * , use_overline = False , one_half = '\\frac{1}{2}' , minor = False , minor_threshold = 25 , minor_number = 6 )

Bases:Formatter

Formatador de probabilidade (usando texto matemático).

Parâmetros :

use_overline bool, padrão: Falso

Se x > 1/2, com x = 1-v, indique se x deve ser exibido como $overline{v}$. O padrão é exibir $1-v$.

one_half str, padrão: r"frac{1}{2}"

A string usada para representar 1/2.

bool menor , padrão: False

Indique se o formatador está formatando ticks menores ou não. Basicamente, os ticks menores não são rotulados, exceto quando apenas alguns ticks são fornecidos, os ticks com mais espaço com os ticks vizinhos são rotulados. Consulte outros parâmetros para alterar o comportamento padrão.

minor_threshold int, padrão: 25

Número máximo de locs para rotular alguns ticks menores. Este parâmetro não tem efeito se minor for False.

minor_number int, padrão: 6

Número de tiques que são rotulados quando o número de tiques está abaixo do limite.

format_data_short ( valor )

Retorna uma versão de string curta do valor do tick.

O padrão é o valor longo independente da posição.

set_locs ( locs )

Defina os locais dos carrapatos.

Este método é chamado antes de computar os rótulos dos ticks porque alguns formatadores precisam conhecer todos os locais dos ticks para fazer isso.

set_minor_number ( minor_number )

Defina o número de marcas secundárias a serem rotuladas quando algumas marcas secundárias forem rotuladas.

Parâmetros :

minor_number int

Número de tiques que são rotulados quando o número de tiques está abaixo do limite.

set_minor_threshold ( minor_threshold )

Defina o limite para rotular ticks menores.

Parâmetros :

minor_threshold int

Número máximo de locais para rotular alguns ticks menores. Este parâmetro não tem efeito se minor for False.

set_one_half ( one_half )

Defina a forma como a metade é exibida.

one_half str, padrão: r"frac{1}{2}"

A string usada para representar 1/2.

use_overline ( use_overline )

Mude o modo de exibição com overline para rotular p>1/2.

Parâmetros :

use_overline bool, padrão: Falso

Se x > 1/2, com x = 1-v, indique se x deve ser exibido como $overline{v}$. O padrão é exibir $1-v$.

classe matplotlib.ticker. LogitLocator ( minor = False , * , nbins = 'auto' )

Bases:MaxNLocator

Determinar os locais de marcação para eixos logit

Coloque carrapatos nos locais logit

Parâmetros :

nbins int ou 'auto', opcional

Número de tiques. Usado apenas se menor for False.

bool menor , padrão: False

Indique se este localizador é para carrapatos menores ou não.

propriedade menor

não singular ( vmin , vmax )

Ajuste um intervalo conforme necessário para evitar singularidades.

Este método é chamado durante o escalonamento automático, com os limites de dados definidos nos eixos se os eixos contiverem quaisquer dados ou não.(v0, v1)(-inf, +inf)

• Se (possivelmente até algum slop de ponto flutuante), esse método retorna um intervalo expandido em torno desse valor.v0 == v1

• Se , esse método retorna os limites de exibição padrão apropriados.(v0, v1) == (-inf, +inf)

• Caso contrário, é retornado sem modificação.(v0, v1)

set_params ( menor = Nenhum , ** kwargs )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

classe matplotlib.ticker. MaxNLocator ( nbins = None , ** kwargs )

Bases:Locator

Encontre bons locais de marcação com não mais do que N dentro dos limites de exibição. Os locais além dos limites são adicionados para dar suporte ao escalonamento automático.

Parâmetros :

nbins int ou 'auto', padrão: 10

Número máximo de intervalos; um a menos que o número máximo de ticks. Se a string for 'auto', o número de compartimentos será determinado automaticamente com base no comprimento do eixo.

passos como array, opcional

Sequência de belos números começando com 1 e terminando com 10; por exemplo, [1, 2, 4, 5, 10], onde os valores são múltiplos de ticks aceitáveis. ou seja, para o exemplo, 20, 40, 60 seriam um conjunto aceitável de ticks, assim como 0,4, 0,6, 0,8, porque são múltiplos de 2. No entanto, 30, 60, 90 não seriam permitidos porque 3 não aparece em a lista de passos.

inteiro bool, padrão: Falso

Se for True, os ticks terão apenas valores inteiros, desde que pelo menos min_n_ticks inteiros sejam encontrados dentro dos limites da exibição.

bool simétrico , padrão: Falso

Se for True, o dimensionamento automático resultará em um intervalo simétrico em torno de zero.

ameixa {'inferior', 'superior', 'ambos', Nenhum}, padrão: Nenhum

Remover marcas de aresta -- útil para plotagens empilhadas ou agrupadas em que a marca superior de um eixo se sobrepõe à marca inferior dos eixos acima dele, principalmente quando rcParams["axes.autolimit_mode"](padrão: 'data') é 'round_numbers'. Se prune=='lower', o menor carrapato será removido. Se , o maior carrapato será removido. Se , os maiores e menores carrapatos serão removidos. Se prune for None , nenhum tique será removido.prune == 'upper'prune == 'both'

min_n_ticks int, padrão: 2

Relaxe nbins e restrições de número inteiro , se necessário, para obter esse número mínimo de tiques.

default_params = {'integer': Falso, 'min_n_ticks': 2, 'nbins': 10, 'prune': Nenhum, 'passos': Nenhum, 'simétrico': Falso}

set_params ( ** kwargs )

Defina os parâmetros para este localizador.

Parâmetros :

nbins int ou 'auto', opcional

VejoMaxNLocator

passos como array, opcional

VejoMaxNLocator

inteiro bool, opcional

VejoMaxNLocator

bool simétrico , opcional

VejoMaxNLocator

ameixa {'inferior', 'superior', 'ambos', Nenhum}, opcional

VejoMaxNLocator

min_n_ticks int, opcional

VejoMaxNLocator

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

Selecione uma escala para o intervalo de vmin a vmax.

As subclasses devem substituir esse método para alterar o comportamento do localizador.

classe matplotlib.ticker. MultipleLocator ( base = 1.0 )

Bases:Locator

Defina um tick em cada múltiplo inteiro de uma base dentro do intervalo de exibição.

set_params ( base )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( dmin , dmax )

Defina os limites de visualização para os múltiplos de base mais próximos que contêm os dados.

classe matplotlib.ticker. NullFormatter

Bases:Formatter

Sempre retorne a string vazia.

classe matplotlib.ticker. NullLocator

Bases:Locator

Sem marcas

tick_values ​​( vmin , vmax )

Retorne os locais dos carrapatos.

Observação

Como os valores são nulos, vmin e vmax não são usados ​​neste método.

classe matplotlib.ticker. PercentFormatter ( xmax = 100 , decimals = None , symbol = '%' , is_latex = False )

Bases:Formatter

Formate os números como uma porcentagem.

Parâmetros :

flutuação máxima

Determina como o número é convertido em uma porcentagem. xmax é o valor dos dados que corresponde a 100%. As porcentagens são calculadas como . Portanto, se os dados já estiverem dimensionados para porcentagens, xmax será 100. Outra situação comum é onde xmax é 1,0.x / xmax * 100

decimais Nenhum ou int

O número de casas decimais a serem colocadas após o ponto. Se Nenhum (o padrão), o número será calculado automaticamente.

símbolo str ou nenhum

Uma string que será anexada ao rótulo. Pode ser Nenhum ou vazio para indicar que nenhum símbolo deve ser usado. Os caracteres especiais do LaTeX são escapados no símbolo sempre que o modo látex está ativado, a menos que is_latex seja True .

is_latex bool

Se False , os caracteres LaTeX reservados no símbolo serão escapados.

convert_to_pct ( x )

format_pct ( x , display_range )

Formate o número como um número de porcentagem com o número correto de casas decimais e adicione o símbolo de porcentagem, se houver.

Se self.decimalsfor None, o número de dígitos após o ponto decimal é definido com base no display_range do eixo da seguinte forma:

display_range	decimais	amostra
>50	0	x = 34.5=> 35%
>5	1	x = 34.5=> 34,5%
>0,5	2	x = 34.5=> 34,50%
...	...	...

Este método não será muito bom para intervalos de eixos minúsculos ou extremamente grandes. Ele assume que os valores no gráfico são porcentagens exibidas em uma escala razoável.

símbolo de propriedade

O símbolo de porcentagem configurado como uma string.

Se o LaTeX estiver habilitado via rcParams["text.usetex"](padrão: False), os caracteres especiais são automaticamente escapados na string.{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}

classe matplotlib.ticker. ScalarFormatter ( useOffset = Nenhum , useMathText = Nenhum , useLocale = Nenhum )

Bases:Formatter

Formate os valores dos ticks como um número.

Parâmetros :

useOffset bool ou float, padrão: rcParams["axes.formatter.useoffset"](padrão: True)

Se deve usar a notação de deslocamento. Veja set_useOffset.

useMathText bool, padrão: rcParams["axes.formatter.use_mathtext"](padrão: False)

Se deve usar formatação matemática sofisticada. Veja set_useMathText.

useLocale bool, padrão: rcParams["axes.formatter.use_locale"](padrão: False).

Se deve usar configurações de localidade para sinal decimal e sinal positivo. Veja set_useLocale.

Notas

Além dos parâmetros acima, a formatação da representação científica versus ponto flutuante pode ser configurada por meio de set_scientific e set_powerlimits).

Notação offset e notação científica

A notação offset e a notação científica parecem bastante semelhantes à primeira vista. Ambos dividem algumas informações dos valores de escala formatados e as exibem no final do eixo.

• A notação científica divide a ordem de grandeza, ou seja, um fator de escala multiplicativo, por exemplo 1e6.

• A notação de deslocamento separa uma constante aditiva, por exemplo, +1e6. O rótulo de notação de deslocamento é sempre prefixado com um sinal +ou -e, portanto, é distinguível do rótulo de ordem de magnitude.

O gráfico a seguir com limites x 1_000_000para 1_000_010ilustrar as diferentes formatações. Observe os rótulos na borda direita do eixo x.

( Código fonte , png )

format_data ( valor )

Retorna a representação de string completa do valor com a posição não especificada.

format_data_short ( valor )

Retorna uma versão de string curta do valor do tick.

O padrão é o valor longo independente da posição.

get_offset ( )

Retorna a notação científica, mais o deslocamento.

get_useLocale ( )

Retorna se as configurações de localidade são usadas para formatação.

Veja também

ScalarFormatter.set_useLocale

get_useMathText ( )

Retornar se deseja usar formatação matemática sofisticada.

Veja também

ScalarFormatter.set_useMathText

get_useOffset ( )

Retorna se o modo automático para notação de deslocamento está ativo.

Isso retorna True se set_useOffset(True); ele retorna False se um deslocamento explícito foi definido, por exemplo set_useOffset(1000).

Veja também

ScalarFormatter.set_useOffset

set_locs ( locs )

Defina os locais dos carrapatos.

Este método é chamado antes de computar os rótulos dos ticks porque alguns formatadores precisam conhecer todos os locais dos ticks para fazer isso.

set_powerlimits ( lims )

Definir limites de tamanho para notação científica.

Parâmetros :

lims (int, int)

Uma tupla (min_exp, max_exp) contendo as potências de 10 que determinam o limite de alternância. Para um número representável como \(a \times 10^\mathrm{exp}\)com\(1 <= |a| < 10\), a notação científica será usada se ou .exp <= min_expexp >= max_exp

Os limites padrão são controlados por rcParams["axes.formatter.limits"](padrão: ).[-5, 6]

Em particular, números com exp igual aos limiares são escritos em notação científica.

Normalmente, min_exp será negativo e max_exp será positivo.

Por exemplo, fornecerá a seguinte formatação: formatter.set_powerlimits((-3, 4))\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).

Veja também

ScalarFormatter.set_scientific

set_cientific ( b )

Ativar ou desativar a notação científica.

Veja também

ScalarFormatter.set_powerlimits

set_useLocale ( val )

Defina se deseja usar configurações de localidade para sinal decimal e sinal positivo.

Parâmetros :

val bool ou nenhum

Nenhum redefine para rcParams["axes.formatter.use_locale"](padrão: False).

set_useMathText ( val )

Defina se deseja usar formatação matemática sofisticada.

Se ativa, a notação científica é formatada como\(1.2 \times 10^3\).

Parâmetros :

val bool ou nenhum

Nenhum redefine para rcParams["axes.formatter.use_mathtext"](padrão: False).

set_useOffset ( val )

Defina se deseja usar a notação de deslocamento.

Ao formatar um conjunto de números cujo valor é grande em comparação com seu intervalo, o formatador pode separar uma constante aditiva. Isso pode encurtar os números formatados para que eles tenham menos probabilidade de se sobrepor quando desenhados em um eixo.

Parâmetros :

val bool ou float

• Se False, não use a notação de deslocamento.

• Se True (=modo automático), use a notação de deslocamento se ela puder tornar os números residuais significativamente mais curtos. O comportamento exato é controlado por rcParams["axes.formatter.offset_threshold"](padrão: 4).

• Se for um número, força um deslocamento do valor fornecido.

Exemplos

Com a notação de deslocamento ativo, os valores

100_000, 100_002, 100_004, 100_006, 100_008

será formatado como mais um offset , que é escrito na borda do eixo.0, 2, 4, 6, 8+1e5

propriedade useLocale

Retorna se as configurações de localidade são usadas para formatação.

Veja também

ScalarFormatter.set_useLocale

propriedade useMathText

Retornar se deseja usar formatação matemática sofisticada.

Veja também

ScalarFormatter.set_useMathText

propriedade useOffset

Retorna se o modo automático para notação de deslocamento está ativo.

Isso retorna True se set_useOffset(True); ele retorna False se um deslocamento explícito foi definido, por exemplo set_useOffset(1000).

Veja também

ScalarFormatter.set_useOffset

classe matplotlib.ticker. StrMethodFormatter ( fmt )

Bases:Formatter

Use uma string de formato de novo estilo (como usado por str.format) para formatar o tick.

O campo usado para o valor do tick deve ser rotulado x e o campo usado para a posição do tick deve ser rotulado como pos .

classe matplotlib.ticker. SymmetricalLogLocator ( transform = None , subs = None , linthresh = None , base = None )

Bases:Locator

Determine os locais de tique para eixos logarítmicos simétricos.

Parâmetros :

transformar SymmetricalLogTransform, opcional

Se definido, define a base e o linthresh da transformação symlog.

base, flutuador linthresh , opcional

A base e o linthresh da transformação symlog, conforme documentado para SymmetricalLogScale. Esses parâmetros são usados ​​apenas se a transformação não estiver definida.

subs sequência de float, padrão: [1]

Os múltiplos de potências inteiras da base onde os ticks são colocados, ou seja, os ticks são colocados em .[sub * base**i for i in ... for sub in subs]

Notas

Tanto transform , quanto base e linthresh , devem ser informados.

set_params ( subs = Nenhum , numticks = Nenhum )

Defina os parâmetros neste localizador.

tick_values ​​( vmin , vmax )

Retorne os valores dos ticks localizados dados vmin e vmax .

Observação

Para obter as localizações dos ticks com os valores vmin e vmax definidos automaticamente para o associado, axisbasta chamar a instância Locator:

>>> print(type(loc))
<type 'Locator'>
>>> print(loc())
[1, 2, 3, 4]

view_limits ( vmin , vmax )

Tente escolher os limites de visualização de forma inteligente.

classe matplotlib.ticker. TickHelper

Bases:object

eixo = Nenhum

create_dummy_axis ( ** kwargs )

set_axis ( eixo )

set_bounds ( vmin , vmax )

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.5: Use Axis.set_view_intervale Axis.set_data_intervalem seu lugar.

set_data_interval ( vmin , vmax )

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.5: Use Axis.set_data_intervalem seu lugar.

set_view_interval ( vmin , vmax )

[ Descontinuado ]

Notas

Obsoleto desde a versão 3.5: Use Axis.set_view_intervalem seu lugar.