matplotlib.ticker

Marque la ubicación y el formato

Este módulo contiene clases para configurar la ubicación y el formato de ticks. Se proporcionan formateadores y localizadores de ticks genéricos, así como personalizados específicos del dominio.

Aunque los localizadores no saben nada acerca de los ticks mayores o menores, la clase Axis los utiliza para admitir la ubicación y el formateo de ticks mayores y menores.

Marque la localización

La clase Locator es la clase base para todos los localizadores de ticks. Los localizadores manejan el ajuste de escala automático de los límites de vista en función de los límites de datos y la elección de ubicaciones de marca. Un útil localizador de garrapatas semiautomático es MultipleLocator. Se inicializa con una base, por ejemplo, 10, y selecciona los límites del eje y marca que son múltiplos de esa base.

Las subclases de Locator definidas aquí son:

AutoLocator	MaxNLocatorcon valores predeterminados simples. Este es el localizador de marcas predeterminado para la mayoría de los trazados.
MaxNLocator	Encuentra hasta un número máximo de intervalos con marcas en lugares agradables.
LinearLocator	Espacie las marcas uniformemente de min a max.
LogLocator	Espacio ticks logarítmicamente de min a max.
MultipleLocator	Las marcas y el rango son un múltiplo de la base; ya sea entero o flotante.
FixedLocator	Las ubicaciones de las marcas son fijas.
IndexLocator	Localizador de gráficas de índice (p. ej., where ).x = range(len(y))
NullLocator	Sin garrapatas.
SymmetricalLogLocator	Localizador para usar con la norma symlog; funciona como LogLocatorpara la parte fuera del umbral y suma 0 si está dentro de los límites.
AsinhLocator	Localizador para usar con la norma asinh, intentando espaciar las marcas de forma aproximadamente uniforme.
LogitLocator	Localizador para escalado logit.
AutoMinorLocator	Localizador de marcas menores cuando el eje es lineal y las marcas principales están espaciadas uniformemente. Subdivide el intervalo de tick principal en un número específico de intervalos menores, con un valor predeterminado de 4 o 5 según el intervalo principal.

Hay una serie de localizadores especializados para ubicaciones de fechas; consulte el datesmódulo.

Puede definir su propio localizador derivándolo de Localizador. Debe anular el __call__método, que devuelve una secuencia de ubicaciones, y probablemente desee anular el método de escalado automático para establecer los límites de visualización a partir de los límites de datos.

Si desea anular el localizador predeterminado, use uno de los anteriores o un localizador personalizado y páselo a la instancia del eje x o y. Los métodos relevantes son:

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)

El localizador menor por defecto es NullLocator, es decir, no hay marcas menores por defecto.

Nota

Locatorlas instancias no deben usarse con más de uno Axiso Axes. Así que en lugar de:

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

haz lo siguiente en su lugar:

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

Marque formato

El formateo de ticks está controlado por clases derivadas de Formatter. El formateador opera en un solo valor de marca y devuelve una cadena al eje.

NullFormatter	No hay etiquetas en las garrapatas.
FixedFormatter	Configure las cadenas manualmente para las etiquetas.
FuncFormatter	La función definida por el usuario establece las etiquetas.
StrMethodFormatter	formatUtilice el método de cadena .
FormatStrFormatter	Use una cadena de formato sprintf de estilo antiguo.
ScalarFormatter	Formateador predeterminado para escalares: selección automática de la cadena de formato.
LogFormatter	Formateador de ejes de registro.
LogFormatterExponent	Formatee los valores para el eje de registro usando .exponent = log_base(value)
LogFormatterMathtext	Dé formato a los valores para el eje de registro utilizando texto matemático.exponent = log_base(value)
LogFormatterSciNotation	Dé formato a los valores para el eje logarítmico usando notación científica.
LogitFormatter	Formateador de probabilidades.
EngFormatter	Formatee las etiquetas en notación de ingeniería.
PercentFormatter	Formatee las etiquetas como un porcentaje.

Puede derivar su propio formateador de la clase base Formatter simplemente anulando el __call__método. La clase formateadora tiene acceso a la vista del eje y los límites de datos.

Para controlar los formatos de etiqueta de tick mayor y menor, use uno de los siguientes 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)

Además de una Formatterinstancia, set_major_formattery set_minor_formattertambién aceptar una strfunción o. strla entrada se reemplazará internamente con una generada automáticamente StrMethodFormattercon la entrada str. Para FuncFormatterla entrada de función, se generará y utilizará un con la función de entrada.

Consulte Marcas principales y secundarias para ver un ejemplo de configuración de marcas principales y secundarias. Consulte el matplotlib.datesmódulo para obtener más información y ejemplos del uso de localizadores y formateadores de fechas.

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

Bases:Locator

Un localizador de ticks de eje especializado para la escala inversa-sinh

Es muy poco probable que esto tenga algún uso más allá de la AsinhScaleclase.

Nota

Esta API es provisional y puede revisarse en el futuro en función de los primeros comentarios de los usuarios.

Parámetros :

flotante de ancho_lineal

El parámetro de escala que define la extensión de la región cuasi lineal.

numticks int, por defecto: 11

El número aproximado de marcas principales que caben a lo largo de todo el eje

symthresh float, por defecto: 0.2

El umbral fraccionario por debajo del cual los datos que cubren un rango que es aproximadamente simétrico con respecto a cero tendrán marcas que son exactamente simétricas.

base int, por defecto: 10

La base numérica utilizada para redondear las ubicaciones de las marcas en una escala logarítmica. Si es menor que uno, entonces el redondeo es al múltiplo entero más cercano de las potencias de diez.

tupla subs , por defecto: Ninguno

Múltiplos de la base numérica, normalmente usados ​​para los ticks menores, por ejemplo (2, 5) cuando la base=10.

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

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

clase matplotlib.ticker. Localizador automático

Bases:MaxNLocator

Encuentre dinámicamente las principales posiciones de ticks. Esta es en realidad una subclase de MaxNLocator, con parámetros nbins = 'auto' y steps = [1, 2, 2.5, 5, 10] .

Para conocer los valores de los parámetros no públicos, consulte los valores predeterminados de MaxNLocator.

clase matplotlib.ticker. AutoMinorLocator ( n = Ninguno )

Bases:Locator

Encuentre dinámicamente posiciones de ticks menores en función de las posiciones de los ticks principales. La escala debe ser lineal con las marcas principales espaciadas uniformemente.

n es el número de subdivisiones del intervalo entre ticks principales; por ejemplo, n=2 colocará un solo tick menor a mitad de camino entre los ticks principales.

Si se omite n o Ninguno, se establecerá en 5 o 4.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

clase matplotlib.ticker. EngFormatter ( unidad = '' , lugares = Ninguno , sep = ' ' , * , usetex = Ninguno , useMathText = Ninguno )

Bases:Formatter

Dé formato a los valores de los ejes utilizando prefijos de ingeniería para representar potencias de 1000, más una unidad específica, por ejemplo, 10 MHz en lugar de 1e7.

Parámetros :

unidad str, por defecto: ""

Símbolo de unidad a usar, adecuado para usar con representaciones de una sola letra de potencias de 1000. Por ejemplo, 'Hz' o 'm'.

lugares int, por defecto: Ninguno

Precisión con la que mostrar el número, especificado en dígitos después del punto decimal (habrá entre uno y tres dígitos antes del punto decimal). Si es Ninguno, el formato recurre al formato de coma flotante '%g', que muestra hasta 6 dígitos significativos , es decir, el valor equivalente para los lugares varía entre 0 y 5 (ambos inclusive).

sep str, por defecto: " "

Separador utilizado entre el valor y el prefijo/unidad. Por ejemplo, se obtiene '3,14 mV' si sepes " " (predeterminado) y ' 3,14 mV' si sepes "". Además del comportamiento predeterminado, algunas otras opciones útiles pueden ser:

• sep=""para añadir directamente el prefijo/unidad al valor;

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

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

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

usetex bool, predeterminado: rcParams["text.usetex"](predeterminado: False)

Para habilitar/deshabilitar el uso del modo matemático de TeX para representar los números en el formateador.

useMathText bool, predeterminado: rcParams["axes.formatter.use_mathtext"](predeterminado: False)

Para habilitar/deshabilitar el uso de texto matemático para representar los números en el formateador.

PREFIJOS_ENG = {-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 )

Formatee un número en notación de ingeniería, agregando una letra que represente la potencia de 1000 del número original. Algunos ejemplos:

>>> 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 ( valor )

set_usetex ( valor )

propiedad useMathText

propiedad usetex

clase matplotlib.ticker. FixedFormatter ( seq )

Bases:Formatter

Devuelve cadenas fijas para etiquetas de ticks basadas solo en la posición, no en el valor.

Nota

FixedFormattersolo debe usarse junto con FixedLocator. De lo contrario, las etiquetas pueden terminar en posiciones inesperadas.

Establezca la secuencia de secuencias de cadenas que se usarán para las etiquetas.

get_offset ( )

set_offset_string ( ofs )

clase matplotlib.ticker. FixedLocator ( locs , nbins = Ninguno )

Bases:Locator

Las ubicaciones de las marcas son fijas. Si nbins no es Ninguno, la matriz de posiciones posibles se submuestreará para mantener el número de marcas <= nbins +1. El submuestreo se hará para incluir el valor absoluto más pequeño; por ejemplo, si se incluye cero en el conjunto de posibilidades, se garantiza que será uno de los ticks elegidos.

set_params ( nbins = Ninguno )

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve las ubicaciones de las garrapatas.

Nota

Debido a que los valores son fijos, vmin y vmax no se usan en este método.

clase matplotlib.ticker. FormatStrFormatter ( fmt )

Bases:Formatter

Use una cadena de formato de estilo antiguo (operador '%') para formatear la marca.

La cadena de formato debe tener un solo formato de variable (%) en ella. Se aplicará al valor (no a la posición) del tick.

Los valores numéricos negativos usarán un guión, no un Unicode menos; use mathtext para obtener un Unicode menos envolviendo el especificador de formato con $ (por ejemplo, "$%g$").

clase matplotlib.ticker. Formateador

Bases:TickHelper

Cree una cadena basada en un valor de tick y una ubicación.

fix_minus estático ( s )

Algunas clases pueden querer reemplazar un guión por menos con el símbolo Unicode adecuado (U + 2212) para la corrección tipográfica. Este es un método de ayuda para realizar dicho reemplazo cuando está habilitado a través rcParams["axes.unicode_minus"]de (predeterminado: True).

format_data ( valor )

Devuelve la representación de cadena completa del valor con la posición sin especificar.

format_data_short ( valor )

Devuelve una versión de cadena corta del valor de marca.

El valor predeterminado es el valor largo independiente de la posición.

format_ticks ( valores )

Devuelve las etiquetas de ticks para todos los ticks a la vez.

get_offset ( )

locs = []

set_locs ( locomotoras )

Establezca las ubicaciones de las garrapatas.

Se llama a este método antes de calcular las etiquetas de marca porque algunos formateadores necesitan conocer todas las ubicaciones de marca para hacerlo.

clase matplotlib.ticker. FuncFormatter ( func )

Bases:Formatter

Utilice una función definida por el usuario para formatear.

La función debe tomar dos entradas (un valor de marca xy una posición pos) y devolver una cadena que contenga la etiqueta de marca correspondiente.

get_offset ( )

set_offset_string ( ofs )

clase matplotlib.ticker. IndexLocator ( base , desplazamiento )

Bases:Locator

Coloque una marca en cada múltiplo de algún número base de puntos graficados, por ejemplo, en cada 5to punto. Se supone que está haciendo un gráfico de índice; es decir, el eje es 0, len(datos). Esto es principalmente útil para x ticks.

Coloque marcas en cada punto de datos base , comenzando en offset .

set_params ( base = Ninguno , desplazamiento = Ninguno )

Establecer parámetros dentro de este localizador

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

clase matplotlib.ticker. LinearLocator ( numticks = Ninguno , presets = Ninguno )

Bases:Locator

Determinar las ubicaciones de las garrapatas

La primera vez que se llame a esta función, intentará establecer el número de ticks para hacer una buena partición de ticks. A partir de entonces, el número de tics se fijará para que la navegación interactiva sea agradable.

Use ajustes preestablecidos para establecer locomotoras basadas en lom. Un mapeo de dictados vmin, vmax->locs

números de propiedad

set_params ( numticks = Ninguno , presets = Ninguno )

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( vmin , vmax )

Intenta elegir los límites de vista de forma inteligente.

clase matplotlib.ticker. Localizador

Bases:TickHelper

Determine las ubicaciones de las garrapatas;

Tenga en cuenta que el mismo localizador no debe usarse en varios Axisporque el localizador almacena referencias a los límites de vista y datos de Axis.

MÁXTICKS = 1000

nonsingular ( v0 , v1 )

Ajuste un rango según sea necesario para evitar singularidades.

Este método se llama durante el ajuste de escala automático, con el establecimiento de los límites de datos en los ejes si los ejes contienen datos, o si no.(v0, v1)(-inf, +inf)

• Si (posiblemente hasta alguna pendiente de coma flotante), este método devuelve un intervalo ampliado alrededor de este valor.v0 == v1

• Si , este método devuelve los límites de vista predeterminados apropiados.(v0, v1) == (-inf, +inf)

• En caso contrario, se devuelve sin modificación.(v0, v1)

raise_if_exceeds ( locs )

Regístrese en el nivel de ADVERTENCIA si locs es más largo que Locator.MAXTICKS.

Esto está destinado a llamarse inmediatamente antes de devolver las ubicaciones__call__ para informar a los usuarios en caso de que su localizador devuelva una gran cantidad de marcas, lo que hace que Matplotlib se quede sin memoria .

El nombre "extraño" de este método se remonta a cuando generaba una excepción en lugar de emitir un registro.

set_params ( ** kwargs )

No hagas nada y lanza una advertencia. Cualquier clase de localizador que no admita la función set_params() llamará a esto.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( vmin , vmax )

Seleccione una escala para el rango de vmin a vmax.

Las subclases deben anular este método para cambiar el comportamiento del localizador.

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

Bases:Formatter

Clase base para dar formato a los ticks en una escala logarítmica o simbólica.

Puede ser instanciado directamente o subclasificado.

Parámetros :

flotante base , predeterminado: 10.

Base del logaritmo utilizado en todos los cálculos.

labelOnlyBase bool, predeterminado: Falso

Si es Verdadero, la etiqueta marca solo las potencias enteras de la base. Normalmente, esto es Verdadero para las marcas principales y Falso para las marcas menores.

minor_thresholds (subconjunto, todos), predeterminado: (1, 0.4)

Si labelOnlyBase es False, estos dos números controlan el etiquetado de los ticks que no están en potencias enteras de base; normalmente estas son las garrapatas menores. El parámetro de control es el registro del rango de datos del eje. En el caso típico donde la base es 10, es el número de décadas abarcado por el eje, por lo que podemos llamarlo 'numdec'. Si , se etiquetarán todas las marcas menores. Si , solo se etiquetará un subconjunto de ticks menores, para evitar la aglomeración. Si es así, no se etiquetarán ticks menores.numdec <= allall < numdec <= subsetnumdec > subset

linthresh Ninguno o flotante, predeterminado: Ninguno

Si se utiliza una escala logarítmica simétrica, su linthresh parámetro debe proporcionarse aquí.

notas

Se set_locsdebe llamar al método para habilitar la lógica de creación de subconjuntos controlada por el minor_thresholdsparámetro.

En algunos casos, como la barra de colores, no hay distinción entre marcas mayores y menores; las ubicaciones de las marcas pueden establecerse manualmente o mediante un localizador que coloca marcas en potencias enteras de la base y en ubicaciones intermedias. Para esta situación, deshabilite la lógica minor_thresholds usando , para que se etiqueten todos los ticks.minor_thresholds=(np.inf, np.inf)

Para deshabilitar el etiquetado de marcas menores cuando 'labelOnlyBase' es falso, use . Este es el valor predeterminado para el estilo "clásico".minor_thresholds=(0, 0)

Ejemplos

Para etiquetar un subconjunto de marcas menores cuando los límites de la vista abarcan hasta 2 décadas, y todas las marcas cuando se amplía a 0,5 décadas o menos, use .minor_thresholds=(2, 0.5)

Para etiquetar todos los ticks menores cuando los límites de vista abarcan hasta 1,5 décadas, use .minor_thresholds=(1.5, 1.5)

base ( base )

[ Obsoleto ] Cambiar la base para el etiquetado.

Advertencia

Siempre debe coincidir con la base utilizada paraLogLocator

notas

En desuso desde la versión 3.6: Use set_base() en su lugar.

format_data ( valor )

Devuelve la representación de cadena completa del valor con la posición sin especificar.

format_data_short ( valor )

Devuelve una versión de cadena corta del valor de marca.

El valor predeterminado es el valor largo independiente de la posición.

label_minor ( labelOnlyBase )

[ Obsoleto ] Activa o desactiva el etiquetado de ticks menores.

Parámetros :

labelOnlyBase booleano

Si es Verdadero, la etiqueta marca solo las potencias enteras de la base.

notas

En desuso desde la versión 3.6: use set_label_minor() en su lugar.

set_base ( base )

Cambia la base para rotular.

Advertencia

Siempre debe coincidir con la base utilizada paraLogLocator

set_label_minor ( labelOnlyBase )

Active o desactive el etiquetado de ticks menores.

Parámetros :

labelOnlyBase booleano

Si es Verdadero, la etiqueta marca solo las potencias enteras de la base.

set_locs ( locs = Ninguno )

Use los límites de la vista del eje para controlar qué marcas están etiquetadas.

El parámetro locs se ignora en el presente algoritmo.

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

Bases:LogFormatter

Formatee los valores para el eje de registro usando .exponent = log_base(value)

clase matplotlib.ticker. LogFormatterMathtext ( base = 10.0 , labelOnlyBase = False , minor_thresholds = Ninguno , linthresh = Ninguno )

Bases:LogFormatter

Formatee los valores para el eje de registro usando .exponent = log_base(value)

clase matplotlib.ticker. LogFormatterSciNotation ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None )

Bases:LogFormatterMathtext

Formatee los valores siguiendo la notación científica en un eje logarítmico.

clase matplotlib.ticker. LogLocator ( base = 10.0 , subs = (1.0,) , numdecs = 4 , numticks = Ninguno )

Bases:Locator

Determinar las ubicaciones de las marcas para los ejes de registro

Coloque marcas en las ubicaciones: subs[j] * base**i

Parámetros :

flotante base , predeterminado: 10.0

La base del registro utilizado, por lo que las marcas principales se colocan en base**n, n entero.

subs Ninguno o str o secuencia de float, por defecto: (1.0,)

Da los múltiplos de las potencias enteras de la base en la que se colocan las marcas. El valor predeterminado coloca marcas solo en potencias enteras de la base. Los valores de cadena permitidos son 'auto'y 'all', los cuales usan un algoritmo basado en los límites de la vista del eje para determinar si y cómo poner marcas entre las potencias enteras de la base. Con 'auto', las marcas se colocan solo entre potencias enteras; con 'all', se incluyen las potencias enteras. Un valor de Ninguno es equivalente a 'auto'.

numticks Ninguno o int, por defecto: Ninguno

El número máximo de marcas que se permiten en un eje determinado. El valor predeterminado de Noneintentará elegir de forma inteligente siempre que este localizador ya haya sido asignado a un eje usando get_tick_space, pero de lo contrario vuelve a 9.

base ( base )

[ Obsoleto ] Establecer la base de registro (marque principal cada base**i, i entero).

notas

En desuso desde la versión 3.6: Use set_params(base=...) en su lugar.

no singular ( vmin , vmax )

Ajuste un rango según sea necesario para evitar singularidades.

Este método se llama durante el ajuste de escala automático, con el establecimiento de los límites de datos en los ejes si los ejes contienen datos, o si no.(v0, v1)(-inf, +inf)

• Si (posiblemente hasta alguna pendiente de coma flotante), este método devuelve un intervalo ampliado alrededor de este valor.v0 == v1

• Si , este método devuelve los límites de vista predeterminados apropiados.(v0, v1) == (-inf, +inf)

• En caso contrario, se devuelve sin modificación.(v0, v1)

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

Establece parámetros dentro de este localizador.

subs ( subs )

[ Obsoleto ] Establezca las marcas menores para el escalado de registros cada base**i*subs[j].

notas

En desuso desde la versión 3.6: Use set_params(subs=...) en su lugar.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( vmin , vmax )

Intenta elegir los límites de vista de forma inteligente.

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

Bases:Formatter

Formateador de probabilidad (usando texto matemático).

Parámetros :

use_overline bool, predeterminado: Falso

Si x > 1/2, con x = 1-v, indique si x debe mostrarse como $overline{v}$. El valor predeterminado es mostrar $1-v$.

una_mitad de cadena, por defecto: r"frac{1}{2}"

La cadena utilizada para representar 1/2.

bool menor , predeterminado: falso

Indique si el formateador está formateando ticks menores o no. Básicamente, los ticks menores no se etiquetan, excepto cuando solo se proporcionan unos pocos ticks, se etiquetan los ticks con más espacio con los ticks vecinos. Consulte otros parámetros para cambiar el comportamiento predeterminado.

minor_threshold int, predeterminado: 25

Número máximo de locomotoras para etiquetar algunas marcas menores. Este parámetro no tiene efecto si minor es False.

número_menor int, predeterminado: 6

Número de ticks que se etiquetan cuando el número de ticks está por debajo del umbral.

format_data_short ( valor )

Devuelve una versión de cadena corta del valor de marca.

El valor predeterminado es el valor largo independiente de la posición.

set_locs ( locomotoras )

Establezca las ubicaciones de las garrapatas.

Se llama a este método antes de calcular las etiquetas de marca porque algunos formateadores necesitan conocer todas las ubicaciones de marca para hacerlo.

set_menor_number ( menor_number )

Establezca el número de marcas menores para etiquetar cuando se etiquetan algunas marcas menores.

Parámetros :

numero_menor int

Número de ticks que se etiquetan cuando el número de ticks está por debajo del umbral.

set_minor_threshold ( minor_threshold )

Establece el umbral para etiquetar ticks menores.

Parámetros :

umbral_menor int

Número máximo de ubicaciones para etiquetar algunas marcas menores. Este parámetro no tiene efecto si minor es False.

set_one_half ( una_mitad )

Configure la forma en que se muestra una mitad.

una_mitad de cadena, por defecto: r"frac{1}{2}"

La cadena utilizada para representar 1/2.

use_overline ( use_overline )

Cambie el modo de visualización con sobrelínea para etiquetar p>1/2.

Parámetros :

use_overline bool, predeterminado: Falso

Si x > 1/2, con x = 1-v, indique si x debe mostrarse como $overline{v}$. El valor predeterminado es mostrar $1-v$.

clase matplotlib.ticker. LogitLocator ( menor = Falso , * , nbins = 'auto' )

Bases:MaxNLocator

Determinar las ubicaciones de las marcas para los ejes logit

Coloque marcas en las ubicaciones logit

Parámetros :

nbins int o 'auto', opcional

Número de garrapatas. Solo se usa si minor es Falso.

bool menor , predeterminado: falso

Indique si este localizador es para ticks menores o no.

propiedad menor

no singular ( vmin , vmax )

Ajuste un rango según sea necesario para evitar singularidades.

Este método se llama durante el ajuste de escala automático, con el establecimiento de los límites de datos en los ejes si los ejes contienen datos, o si no.(v0, v1)(-inf, +inf)

• Si (posiblemente hasta alguna pendiente de coma flotante), este método devuelve un intervalo ampliado alrededor de este valor.v0 == v1

• Si , este método devuelve los límites de vista predeterminados apropiados.(v0, v1) == (-inf, +inf)

• En caso contrario, se devuelve sin modificación.(v0, v1)

set_params ( menor = Ninguno , ** kwargs )

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

clase matplotlib.ticker. MaxNLocator ( nbins = Ninguno , ** kwargs )

Bases:Locator

Encuentre buenas ubicaciones de marca con no más de N dentro de los límites de visualización. Las ubicaciones más allá de los límites se agregan para admitir el ajuste de escala automático.

Parámetros :

nbins int o 'auto', predeterminado: 10

Número máximo de intervalos; uno menos que el número máximo de ticks. Si la cadena es 'auto', el número de contenedores se determinará automáticamente en función de la longitud del eje.

pasos en forma de matriz, opcional

Secuencia de números agradables que comienzan con 1 y terminan con 10; por ejemplo, [1, 2, 4, 5, 10], donde los valores son múltiplos aceptables. es decir, para el ejemplo, 20, 40, 60 serían un conjunto aceptable de marcas, al igual que 0,4, 0,6, 0,8, porque son múltiplos de 2. Sin embargo, 30, 60, 90 no se permitirían porque 3 no aparece en la lista de pasos.

entero bool, predeterminado: falso

Si es Verdadero, los ticks solo tomarán valores enteros, siempre que al menos min_n_ticks enteros se encuentren dentro de los límites de la vista.

booleano simétrico , predeterminado: falso

Si es Verdadero, el ajuste de escala automático dará como resultado un rango simétrico alrededor de cero.

podar {'inferior', 'superior', 'ambos', Ninguno}, predeterminado: Ninguno

Eliminar marcas de borde: útil para parcelas apiladas o agrupadas en las que la marca superior de un eje se superpone con la marca inferior de los ejes superiores, principalmente cuando rcParams["axes.autolimit_mode"](predeterminado: 'data') es 'round_numbers'. Si prune=='lower', se eliminará la marca más pequeña. Si , se eliminará la marca más grande. Si , se eliminarán las marcas más grandes y más pequeñas. Si prune es None , no se eliminarán las marcas.prune == 'upper'prune == 'both'

min_n_ticks int, predeterminado: 2

Relaje las restricciones de nbins y enteros si es necesario para obtener este número mínimo de tics.

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

set_params ( ** kwargs )

Establecer parámetros para este localizador.

Parámetros :

nbins int o 'auto', opcional

verMaxNLocator

pasos en forma de matriz, opcional

verMaxNLocator

bool entero , opcional

verMaxNLocator

booleano simétrico , opcional

verMaxNLocator

podar {'inferior', 'superior', 'ambos', Ninguno}, opcional

verMaxNLocator

min_n_ticks int, opcional

verMaxNLocator

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( dmin , dmax )

Seleccione una escala para el rango de vmin a vmax.

Las subclases deben anular este método para cambiar el comportamiento del localizador.

clase matplotlib.ticker. MultipleLocator ( base = 1.0 )

Bases:Locator

Establezca una marca en cada múltiplo entero de una base dentro del intervalo de vista.

set_params ( base )

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( dmin , dmax )

Establezca los límites de vista a los múltiplos de base más cercanos que contienen los datos.

clase matplotlib.ticker. NullFormatter

Bases:Formatter

Siempre devuelve la cadena vacía.

clase matplotlib.ticker. NullLocator

Bases:Locator

sin garrapatas

tick_values ​​( vmin , vmax )

Devuelve las ubicaciones de las garrapatas.

Nota

Debido a que los valores son nulos, vmin y vmax no se utilizan en este método.

clase matplotlib.ticker. PercentFormatter ( xmax = 100 , decimales = Ninguno , símbolo = '%' , is_latex = False )

Bases:Formatter

Da formato a los números como un porcentaje.

Parámetros :

flotador xmax

Determina cómo se convierte el número en un porcentaje. xmax es el valor de datos que corresponde al 100%. Los porcentajes se calculan como . Entonces, si los datos ya están escalados para ser porcentajes, xmax será 100. Otra situación común es donde xmax es 1.0.x / xmax * 100

decimales Ninguno o int

El número de lugares decimales para colocar después del punto. Si Ninguno (el valor predeterminado), el número se calculará automáticamente.

símbolo str o Ninguno

Una cadena que se agregará a la etiqueta. Puede ser Ninguno o estar vacío para indicar que no se debe usar ningún símbolo. Los caracteres especiales de LaTeX se escapan en el símbolo siempre que el modo latex esté habilitado, a menos que is_latex sea True .

es_latex bool

Si es False , se escaparán los caracteres LaTeX reservados en el símbolo .

convert_to_pct ( x )

format_pct ( x , display_range )

Formatee el número como un número de porcentaje con el número correcto de decimales y agregue el símbolo de porcentaje, si corresponde.

Si self.decimalses None, el número de dígitos después del punto decimal se establece en función del rango de visualización del eje de la siguiente manera:

mostrar_rango	decimales	muestra
>50	0	x = 34.5=> 35%
>5	1	x = 34.5=> 34,5%
>0,5	2	x = 34.5=> 34,50%
...	...	...

Este método no será muy bueno para rangos de ejes pequeños o extremadamente grandes. Asume que los valores en el gráfico son porcentajes que se muestran en una escala razonable.

símbolo de propiedad

El símbolo de porcentaje configurado como una cadena.

Si LaTeX está habilitado a través rcParams["text.usetex"]de (predeterminado: False), los caracteres especiales se escapan automáticamente en la cadena.{'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'}

clase matplotlib.ticker. ScalarFormatter ( useOffset = Ninguno , useMathText = Ninguno , useLocale = Ninguno )

Bases:Formatter

Formatea los valores de tick como un número.

Parámetros :

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

Ya sea para usar la notación de compensación. ver set_useOffset_

useMathText bool, predeterminado: rcParams["axes.formatter.use_mathtext"](predeterminado: False)

Ya sea para usar un formato matemático elegante. ver set_useMathText_

useLocale bool, predeterminado: rcParams["axes.formatter.use_locale"](predeterminado: False).

Si usar la configuración regional para el signo decimal y el signo positivo. ver set_useLocale_

notas

Además de los parámetros anteriores, el formato de representación científica frente a punto flotante se puede configurar a través de set_scientific y set_powerlimits).

Notación compensada y notación científica

La notación compensada y la notación científica parecen bastante similares a primera vista. Ambos dividen parte de la información de los valores de marca con formato y la muestran al final del eje.

• La notación científica divide el orden de magnitud, es decir, un factor de escala multiplicativo, por ejemplo 1e6.

• La notación de compensación separa una constante aditiva, por ejemplo, +1e6. La etiqueta de notación de desplazamiento siempre tiene como prefijo un signo +o -y, por lo tanto, se distingue de la etiqueta de orden de magnitud.

1_000_000La siguiente gráfica con límites x 1_000_010ilustra los diferentes formatos. Tenga en cuenta las etiquetas en el borde derecho del eje x.

( Código fuente , png )

format_data ( valor )

Devuelve la representación de cadena completa del valor con la posición sin especificar.

format_data_short ( valor )

Devuelve una versión de cadena corta del valor de marca.

El valor predeterminado es el valor largo independiente de la posición.

get_offset ( )

Devuelve la notación científica más el desplazamiento.

get_useLocale ( )

Devuelve si la configuración regional se usa para formatear.

Ver también

ScalarFormatter.set_useLocale

get_useMathText ( )

Devuelve si se debe usar un formato matemático elegante.

Ver también

ScalarFormatter.set_useMathText

get_useOffset ( )

Devuelve si el modo automático para la notación de compensación está activo.

Esto devuelve Verdadero si set_useOffset(True); devuelve False si se estableció un desplazamiento explícito, por ejemplo, set_useOffset(1000).

Ver también

ScalarFormatter.set_useOffset

set_locs ( locomotoras )

Establezca las ubicaciones de las garrapatas.

Se llama a este método antes de calcular las etiquetas de marca porque algunos formateadores necesitan conocer todas las ubicaciones de marca para hacerlo.

set_powerlimits ( lims )

Establecer umbrales de tamaño para la notación científica.

Parámetros :

lims (int, int)

Una tupla (min_exp, max_exp) que contiene las potencias de 10 que determinan el umbral de conmutación. Para un número representable como \(a \times 10^\mathrm{exp}\)con\(1 <= |a| < 10\), se utilizará notación científica si o .exp <= min_expexp >= max_exp

Los límites predeterminados están controlados por rcParams["axes.formatter.limits"](predeterminado: ).[-5, 6]

En particular, los números con exp igual a los umbrales se escriben en notación científica.

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

Por ejemplo, proporcionará el siguiente formato: formatter.set_powerlimits((-3, 4))\(1 \times 10^{-3}, 9.9 \times 10^{-3}, 0.01,\) \(9999, 1 \times 10^4\).

Ver también

ScalarFormatter.set_scientific

set_scientific ( b )

Activa o desactiva la notación científica.

Ver también

ScalarFormatter.set_powerlimits

set_useLocale ( valor )

Establezca si desea utilizar la configuración regional para el signo decimal y el signo positivo.

Parámetros :

val bool o Ninguno

Ninguno se restablece a rcParams["axes.formatter.use_locale"](predeterminado: False).

set_useMathText ( valor )

Establezca si desea utilizar un formato matemático elegante.

Si está activo, la notación científica se formatea como\(1.2 \times 10^3\).

Parámetros :

val bool o Ninguno

Ninguno se restablece a rcParams["axes.formatter.use_mathtext"](predeterminado: False).

set_useOffset ( valor )

Establece si usar la notación de compensación.

Al dar formato a un conjunto de números cuyo valor es grande en comparación con su rango, el formateador puede separar una constante aditiva. Esto puede acortar los números formateados para que sea menos probable que se superpongan cuando se dibujen en un eje.

Parámetros :

val bool o flotador

• Si es Falso, no use la notación de compensación.

• Si es Verdadero (=modo automático), use la notación de compensación si puede hacer que los números residuales sean significativamente más cortos. El comportamiento exacto está controlado por rcParams["axes.formatter.offset_threshold"](predeterminado: 4).

• Si es un número, fuerce una compensación del valor dado.

Ejemplos

Con la notación de compensación activa, los valores

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

se formateará como más un desplazamiento , que se escribe en el borde del eje.0, 2, 4, 6, 8+1e5

propiedad useLocale

Devuelve si la configuración regional se usa para formatear.

Ver también

ScalarFormatter.set_useLocale

propiedad useMathText

Devuelve si se debe usar un formato matemático elegante.

Ver también

ScalarFormatter.set_useMathText

propiedad useOffset

Devuelve si el modo automático para la notación de compensación está activo.

Esto devuelve Verdadero si set_useOffset(True); devuelve False si se estableció un desplazamiento explícito, por ejemplo, set_useOffset(1000).

Ver también

ScalarFormatter.set_useOffset

clase matplotlib.ticker. StrMethodFormatter ( fmt )

Bases:Formatter

Use una cadena de formato de nuevo estilo (como la que usa str.format) para formatear la marca.

El campo utilizado para el valor del tick debe tener la etiqueta x y el campo utilizado para la posición del tick debe tener la etiqueta pos .

clase matplotlib.ticker. SymmetricalLogLocator ( transformar = Ninguno , subs = Ninguno , linthresh = Ninguno , base = Ninguno )

Bases:Locator

Determine las ubicaciones de las marcas para los ejes logarítmicos simétricos.

Parámetros :

transformar SymmetricalLogTransform, opcional

Si se establece, define la base y el umbral de la transformación de registro simbólico.

base, flotador Linthresh , opcional

La base y linthresh de la transformación symlog, como se documenta para SymmetricalLogScale. Estos parámetros solo se utilizan si transform no está configurado.

secuencia de subs de float, por defecto: [1]

Los múltiplos de potencias enteras de la base donde se colocan los ticks, es decir, los ticks se colocan en .[sub * base**i for i in ... for sub in subs]

notas

Se debe dar transform , o base y linthresh .

set_params ( subs = Ninguno , numticks = Ninguno )

Establece parámetros dentro de este localizador.

tick_values ​​( vmin , vmax )

Devuelve los valores de los ticks ubicados dados vmin y vmax .

Nota

Para obtener ubicaciones de ticks con los valores vmin y vmax definidos automáticamente para el asociado, axissimplemente llame a la instancia de Locator:

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

view_limits ( vmin , vmax )

Intenta elegir los límites de vista de forma inteligente.

clase matplotlib.ticker. TickHelper

Bases:object

eje = Ninguno

create_dummy_axis ( ** kwargs )

set_axis ( eje )

set_bounds ( vmin , vmax )

[ Obsoleto ]

notas

En desuso desde la versión 3.5: Utilice Axis.set_view_intervaly Axis.set_data_intervalen su lugar.

set_data_interval ( vmin , vmax )

[ Obsoleto ]

notas

En desuso desde la versión 3.5: Usar Axis.set_data_intervalen su lugar.

set_view_interval ( vmin , vmax )

[ Obsoleto ]

notas

En desuso desde la versión 3.5: Usar Axis.set_view_intervalen su lugar.