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:
|
|
Encuentra hasta un número máximo de intervalos con marcas en lugares agradables. |
|
Espacie las marcas uniformemente de min a max. |
|
Espacio ticks logarítmicamente de min a max. |
|
Las marcas y el rango son un múltiplo de la base; ya sea entero o flotante. |
|
Las ubicaciones de las marcas son fijas. |
|
Localizador de gráficas de índice (p. ej., where
). |
|
Sin garrapatas. |
|
Localizador para usar con la norma symlog; funciona como
|
|
Localizador para usar con la norma asinh, intentando espaciar las marcas de forma aproximadamente uniforme. |
|
Localizador para escalado logit. |
|
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 dates
mó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
Locator
las instancias no deben usarse con más de uno
Axis
o 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.
No hay etiquetas en las garrapatas. |
|
Configure las cadenas manualmente para las etiquetas. |
|
La función definida por el usuario establece las etiquetas. |
|
|
|
Use una cadena de formato sprintf de estilo antiguo. |
|
Formateador predeterminado para escalares: selección automática de la cadena de formato. |
|
Formateador de ejes de registro. |
|
Formatee los valores para el eje de registro usando
. |
|
Dé formato a los valores para el eje de registro
utilizando texto matemático. |
|
Dé formato a los valores para el eje logarítmico usando notación científica. |
|
Formateador de probabilidades. |
|
Formatee las etiquetas en notación de ingeniería. |
|
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 Formatter
instancia, set_major_formatter
y
set_minor_formatter
también aceptar una str
función o. str
la entrada se reemplazará internamente con una generada automáticamente StrMethodFormatter
con la entrada str
. Para FuncFormatter
la 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.dates
mó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 ) [fuente] #
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
AsinhScale
clase.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 ) [fuente] #
Establece parámetros dentro de este localizador.
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. Localizador automático [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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,
axis
simplemente 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 ) [fuente] #
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
sep
es " " (predeterminado) y ' 3,14 mV' sisep
es "". 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 ) [fuente] #
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 µ'
- propiedad useMathText #
- propiedad usetex #
- clase matplotlib.ticker. FixedFormatter ( seq ) [fuente] #
Bases:
Formatter
Devuelve cadenas fijas para etiquetas de ticks basadas solo en la posición, no en el valor.
Nota
FixedFormatter
solo debe usarse junto conFixedLocator
. De lo contrario, las etiquetas pueden terminar en posiciones inesperadas.Establezca la secuencia de secuencias de cadenas que se usarán para las etiquetas.
- clase matplotlib.ticker. FixedLocator ( locs , nbins = Ninguno ) [fuente] #
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.
- clase matplotlib.ticker. FormatStrFormatter ( fmt ) [fuente] #
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 [fuente] #
Bases:
TickHelper
Cree una cadena basada en un valor de tick y una ubicación.
- fix_minus estático ( s ) [fuente] #
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 ) [fuente] #
Devuelve la representación de cadena completa del valor con la posición sin especificar.
- format_data_short ( valor ) [fuente] #
Devuelve una versión de cadena corta del valor de marca.
El valor predeterminado es el valor largo independiente de la posición.
- locs = [] #
- clase matplotlib.ticker. FuncFormatter ( func ) [fuente] #
Bases:
Formatter
Utilice una función definida por el usuario para formatear.
La función debe tomar dos entradas (un valor de marca
x
y una posiciónpos
) y devolver una cadena que contenga la etiqueta de marca correspondiente.
- clase matplotlib.ticker. IndexLocator ( base , desplazamiento ) [fuente] #
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 ) [fuente] #
Establecer parámetros dentro de este localizador
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente 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 ) [fuente] #
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 ) [fuente] #
Establece parámetros dentro de este localizador.
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. Localizador [fuente] #
Bases:
TickHelper
Determine las ubicaciones de las garrapatas;
Tenga en cuenta que el mismo localizador no debe usarse en varios
Axis
porque el localizador almacena referencias a los límites de vista y datos de Axis.- MÁXTICKS = 1000 #
- nonsingular ( v0 , v1 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. LogFormatter ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [fuente] #
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 <= all
all < numdec <= subset
numdec > 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_locs
debe llamar al método para habilitar la lógica de creación de subconjuntos controlada por elminor_thresholds
pará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 ) [fuente] #
[ Obsoleto ] Cambiar la base para el etiquetado.
Advertencia
Siempre debe coincidir con la base utilizada para
LogLocator
notas
En desuso desde la versión 3.6: Use set_base() en su lugar.
- format_data ( valor ) [fuente] #
Devuelve la representación de cadena completa del valor con la posición sin especificar.
- format_data_short ( valor ) [fuente] #
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 ) [fuente] #
[ 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 ) [fuente] #
Cambia la base para rotular.
Advertencia
Siempre debe coincidir con la base utilizada para
LogLocator
- clase matplotlib.ticker. LogFormatterExponent ( base = 10.0 , labelOnlyBase = False , minor_thresholds = None , linthresh = None ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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
None
intentará elegir de forma inteligente siempre que este localizador ya haya sido asignado a un eje usandoget_tick_space
, pero de lo contrario vuelve a 9.
- base ( base ) [fuente] #
[ 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 ) [fuente] #
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 ) [fuente] #
Establece parámetros dentro de este localizador.
- subs ( subs ) [fuente] #
[ 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 ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. LogitFormatter ( * , use_overline = False , one_half = '\\frac{1}{2}' , minor = False , minor_threshold = 25 , minor_number = 6 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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.
- clase matplotlib.ticker. LogitLocator ( menor = Falso , * , nbins = 'auto' ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
Establece parámetros dentro de este localizador.
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. MaxNLocator ( nbins = Ninguno , ** kwargs ) [fuente] #
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'
. Siprune=='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 ) [fuente] #
Establecer parámetros para este localizador.
- Parámetros :
- nbins int o 'auto', opcional
ver
MaxNLocator
- pasos en forma de matriz, opcional
ver
MaxNLocator
- bool entero , opcional
ver
MaxNLocator
- booleano simétrico , opcional
ver
MaxNLocator
- podar {'inferior', 'superior', 'ambos', Ninguno}, opcional
ver
MaxNLocator
- min_n_ticks int, opcional
ver
MaxNLocator
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. MultipleLocator ( base = 1.0 ) [fuente] #
Bases:
Locator
Establezca una marca en cada múltiplo entero de una base dentro del intervalo de vista.
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. PercentFormatter ( xmax = 100 , decimales = Ninguno , símbolo = '%' , is_latex = False ) [fuente] #
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 .
- format_pct ( x , display_range ) [fuente] #
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.decimals
esNone
, 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 ) [fuente] #
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
_
- useOffset bool o float, predeterminado:
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
yset_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_000
La siguiente gráfica con límites x1_000_010
ilustra los diferentes formatos. Tenga en cuenta las etiquetas en el borde derecho del eje x.( Código fuente , png )
- format_data ( valor ) [fuente] #
Devuelve la representación de cadena completa del valor con la posición sin especificar.
- format_data_short ( valor ) [fuente] #
Devuelve una versión de cadena corta del valor de marca.
El valor predeterminado es el valor largo independiente de la posición.
- get_useLocale ( ) [fuente] #
Devuelve si la configuración regional se usa para formatear.
Ver también
- get_useOffset ( ) [fuente] #
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
- set_locs ( locomotoras ) [fuente] #
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 ) [fuente] #
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_exp
exp >= 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
- set_useLocale ( valor ) [fuente] #
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 ) [fuente] #
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 ) [fuente] #
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
- propiedad useMathText #
Devuelve si se debe usar un formato matemático elegante.
Ver también
- 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
- clase matplotlib.ticker. StrMethodFormatter ( fmt ) [fuente] #
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 ) [fuente] #
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]
- transformar
notas
Se debe dar transform , o base y linthresh .
- set_params ( subs = Ninguno , numticks = Ninguno ) [fuente] #
Establece parámetros dentro de este localizador.
- tick_values ( vmin , vmax ) [fuente] #
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,
axis
simplemente llame a la instancia de Locator:>>> print(type(loc)) <type 'Locator'> >>> print(loc()) [1, 2, 3, 4]
- clase matplotlib.ticker. TickHelper [fuente] #
Bases:
object
- eje = Ninguno #
- set_bounds ( vmin , vmax ) [fuente] #
[ Obsoleto ]
notas
En desuso desde la versión 3.5: Utilice
Axis.set_view_interval
yAxis.set_data_interval
en su lugar.
- set_data_interval ( vmin , vmax ) [fuente] #
[ Obsoleto ]
notas
En desuso desde la versión 3.5: Usar
Axis.set_data_interval
en su lugar.
- set_view_interval ( vmin , vmax ) [fuente] #
[ Obsoleto ]
notas
En desuso desde la versión 3.5: Usar
Axis.set_view_interval
en su lugar.
![Diagrama de herencia de matplotlib.ticker](/stable/_images/inheritance-da2055122bca38de6635478e7a4e0e847186272a.png)