matplotlib.ticker

Расположение и форматирование делений шкалы

Этот модуль содержит классы для поддержки полностью настраиваемого расположения и форматирования делений шкалы. Хотя локейторы не знают ничего о основных или второстепенных делениях, они используются классом Axis для поддержки расположения и форматирования основных и второстепенных делений. Предоставляются универсальные локейторы и форматировщики делений, а также специализированные для конкретной области.

Форматировщик по умолчанию

Форматировщик по умолчанию определяет, когда данные x, которые отображаются, представляют собой небольшой диапазон поверх большого смещения. Для уменьшения вероятности перекрытия меток делений, деления маркируются как дельты от фиксированного смещения. Например:

ax.plot(np.arange(2000, 2010), range(10))

будут иметь деления от 0 до 9 со смещением +2e3. Если этого не нужно, отключите использование смещения в форматировщике по умолчанию:

ax.get_xaxis().get_major_formatter().set_useOffset(False)

установите параметр rcParam axes.formatter.useoffset=False для его глобального отключения или установите другой форматировщик.

Расположение делений

Класс Locator является базовым классом для всех локейторов делений. Локейторы обрабатывают автоматическое масштабирование пределов отображения на основе пределов данных и выбор расположения делений. Полезным полуавтоматическим локейтором является MultipleLocator. Он инициализируется основанием, например, 10, и выбирает пределы и деления осей, которые являются кратными этому основанию.

Подклассы Locator, определённые здесь:

AutoLocator: MaxNLocator с простыми значениями по умолчанию. Это локейтор делений по умолчанию для большинства графиков.
MaxNLocator: Находит до максимального числа интервалов с делениями в удобных местах.
LinearLocator: Располагает деления равномерно от min до max.
LogLocator: Располагает деления логарифмически от min до max.
MultipleLocator: Деления и диапазон являются кратными основанию; целые или вещественные числа.
FixedLocator: Расположение делений фиксировано.
IndexLocator: Локейтор для графиков индексов (например, где x = range(len(y))).
NullLocator: Нет делений.
SymmetricalLogLocator: Локейтор для использования с нормами symlog; работает как LogLocator для части вне порога и добавляет 0, если значения лежат в пределах пределов.
LogitLocator: Локейтор для логит-шкалы.
OldAutoLocator: Выбирает MultipleLocator и динамически переназначает его для интеллектуального расположения делений во время навигации.
AutoMinorLocator: Локейтор для второстепенных делений, когда ось линейная, а основные деления расположены равномерно. Разделяет интервал между основными делениями на заданное количество второстепенных интервалов, по умолчанию 4 или 5 в зависимости от интервала основных делений.

Существует ряд локейторов, специализированных для дат — см. модуль dates.

Вы можете определить свой собственный локейтор, унаследовав от Locator. Вам необходимо переопределить метод __call__, который возвращает последовательность местоположений, и, вероятно, вам захочется переопределить метод autoscale для задания пределов отображения по пределу данных.

Если вы хотите переопределить локейтор по умолчанию, используйте один из вышеперечисленных или настраиваемый локейтор и передайте его экземпляру оси x или y. Соответствующие методы:

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)

Локейтор второстепенных делений по умолчанию — NullLocator, т.е. второстепенных делений по умолчанию нет.

Форматирование делений

Форматирование делений контролируется классами, полученными от Formatter. Форматировщик работает с одним значением деления и возвращает строку оси.

NullFormatter: Нет меток на делениях.
IndexFormatter: Устанавливает строки из списка меток.
FixedFormatter: Ручное задание строк для меток.
FuncFormatter: Метки задаются пользовательской функцией.
StrMethodFormatter: Используется метод форматирования строк format.
FormatStrFormatter: Использование строки форматирования в старом стиле sprintf.
ScalarFormatter: Форматировщик по умолчанию для скалярных значений: автоматически выбирается строка форматирования.
LogFormatter: Форматировщик для логарифмических осей.
LogFormatterExponent: Форматирование значений для логарифмической оси с использованием exponent = log_base(value).
LogFormatterMathtext: Форматирование значений для логарифмической оси с использованием exponent = log_base(value) с использованием математического текста.
LogFormatterSciNotation: Форматирование значений для логарифмической оси с использованием научной записи.
LogitFormatter: Форматировщик вероятностей.
EngFormatter: Форматирование меток в инженерной нотации.
PercentFormatter: Форматирование меток в виде процента

Вы можете создать свой собственный форматировщик, унаследовав от базового класса Formatter, просто переопределив метод __call__. Класс форматировщика имеет доступ к пределам отображения и данных оси.

Для управления форматированием меток основных и второстепенных делений используйте один из следующих методов:

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)

См. Основные и второстепенные деления для примера установки основных и второстепенных делений. См. модуль matplotlib.dates для получения дополнительной информации и примеров использования локейторов и форматировщиков дат.

class matplotlib.ticker.AutoLocator [source]

Bases: matplotlib.ticker.MaxNLocator

Динамическое определение местоположений основных делений. Фактически это подкласс MaxNLocator с параметрами nbins = 'auto' и steps = [1, 2, 2.5, 5, 10].

Чтобы узнать значения непубличных параметров, обратитесь к значениям по умолчанию для MaxNLocator.

class matplotlib.ticker.AutoMinorLocator(n=None) [source]

Bases: matplotlib.ticker.Locator

Динамическое определение местоположений второстепенных делений на основе местоположений основных делений. Масштаб должен быть линейным, а основные деления — равномерно расположенными.

n — число подразделений интервала между основными делениями; например, n=2 разместит одно второстепенное деление посередине между основными делениями.

Если n опущено или равно None, оно будет установлено в 5 или 4.

tick_values(self, vmin, vmax) [source]

Возвращает значения расположенных делений при заданных vmin и vmax.

Примечание

Чтобы получить расположения делений со значениями vmin и vmax, автоматически определёнными для соответствующей axis, просто вызовите экземпляр Locator:

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

class matplotlib.ticker.EngFormatter(unit='', places=None, sep=' ', *, usetex=None, useMathText=None) [source]

Основывается на matplotlib.ticker.Formatter

Форматирует значения осей, используя инженерные префиксы для представления степеней 1000, плюс указанный символ единицы, например, 10 МГц вместо 1e7.

Параметры:

Параметры:	`unitstr (default: "")` Символ единицы для использования, подходящий для однобуквенных представлений степеней 1000. Например, 'Гц' или 'м'. `placesint (default: None)` Точность отображения числа, заданная в цифрах после десятичной точки (будет от одной до трёх цифр перед десятичной точкой). Если это None, форматирование возвращается к плавающей точке формата '%g', который отображает до 6 значимых цифр, то есть эквивалентное значение для разрядов изменяется в пределах от 0 до 5 (включительно). `sepstr (default: " ")` Разделитель, используемый между значением и префиксом/единицей. Например, мы получим '3.14 мВ', если `sep` равен " " (по умолчанию) и '3.14мВ', если `sep` равен "". Помимо стандартного поведения, некоторые другие полезные варианты могут быть: `sep=""` для непосредственного добавления префикса/единицы к значению; `sep="\N{THIN SPACE}"` (`U+2009`); `sep="\N{NARROW NO-BREAK SPACE}"` (`U+202F`); `sep="\N{NO-BREAK SPACE}"` (`U+00A0`). `usetexbool (default: None)` Включить/выключить использование математического режима TeX для отображения чисел в форматировщике. `useMathTextbool (default: None)` Включить/выключить использование mathtext для отображения чисел в форматировщике.

unitstr (default: "")

Символ единицы для использования, подходящий для однобуквенных представлений степеней 1000. Например, 'Гц' или 'м'.

placesint (default: None)

Точность отображения числа, заданная в цифрах после десятичной точки (будет от одной до трёх цифр перед десятичной точкой). Если это None, форматирование возвращается к плавающей точке формата '%g', который отображает до 6 значимых цифр, то есть эквивалентное значение для разрядов изменяется в пределах от 0 до 5 (включительно).

sepstr (default: " ")

Разделитель, используемый между значением и префиксом/единицей. Например, мы получим '3.14 мВ', если sep равен " " (по умолчанию) и '3.14мВ', если sep равен "". Помимо стандартного поведения, некоторые другие полезные варианты могут быть:

sep="" для непосредственного добавления префикса/единицы к значению;
sep="\N{THIN SPACE}" (U+2009);
sep="\N{NARROW NO-BREAK SPACE}" (U+202F);
sep="\N{NO-BREAK SPACE}" (U+00A0).

usetexbool (default: None)

Включить/выключить использование математического режима TeX для отображения чисел в форматировщике.

useMathTextbool (default: None)

Включить/выключить использование mathtext для отображения чисел в форматировщике.

ENG_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'}

fix_minus(self, s) [source]: Заменить дефисы на минус unicode.

format_eng(self, num) [source]

Форматирует число в инженерной нотации, добавляя букву, представляющую степень 1000 исходного числа. Некоторые примеры:

>>> 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(self) [source]

get_usetex(self) [source]

set_useMathText(self, val) [source]

set_usetex(self, val) [source]

property useMathText

property usetex

class matplotlib.ticker.FixedFormatter(seq) [source]

Основывается на matplotlib.ticker.Formatter

Возвращает фиксированные строки для меток шкал, основанные только на позиции, а не на значении.

Устанавливает последовательность строк, которые будут использоваться в качестве меток.

get_offset(self) [source]

set_offset_string(self, ofs) [source]

class matplotlib.ticker.FixedLocator(locs, nbins=None) [source]

Основывается на matplotlib.ticker.Locator

Позиции делений шкалы фиксированы. Если nbins не равно None, массив возможных позиций будет подвыбран, чтобы количество делений было меньше или равно nbins +1. Подвыборка будет производиться так, чтобы включить наименьшее по абсолютному значению значение; например, если ноль включён в массив возможных значений, то он гарантированно будет одним из выбранных делений.

set_params(self, nbins=None) [source]: Устанавливает параметры локатора.

tick_values(self, vmin, vmax) [source]: Возвращает позиции делений.

Примечание

Так как значения фиксированы, vmin и vmax не используются в этом методе.

class matplotlib.ticker.FormatStrFormatter(fmt) [source]

Основывается на matplotlib.ticker.Formatter

Использует строковый формат старого стиля ('%' оператор) для форматирования деления шкалы.

Строковый формат должен содержать один формат переменной (%) в нём. Он будет применяться к значению (а не позиции) деления.

class matplotlib.ticker.Formatter [source]

Основывается на matplotlib.ticker.TickHelper

Создаёт строку на основе значения и позиции деления шкалы.

fix_minus(self, s) [source]

Некоторые классы могут захотеть заменить дефис на минус с соответствующим символом Unicode (U+2212) для типографической корректности. По умолчанию замена не выполняется.

Обратите внимание, если вы используете этот метод, например, в format_data() или в вызове, вы, вероятно, не захотите использовать его для format_data_short(), так как панель инструментов использует его для интерактивного отчёта о координатах, и маловероятно, что пользовательские интерфейсы на разных платформах будут обрабатывать Unicode корректно. Поэтому на данный момент классы, которые переопределяют fix_minus(), должны иметь явный метод format_data_short().

format_data(self, value) [source]: Возвращает полное строковое представление значения без указания позиции.

format_data_short(self, value) [source]

Возвращает короткую строковую версию значения деления.

По умолчанию использует длинное значение, независимое от позиции.

format_ticks(self, values) [source]: Возвращает метки всех делений сразу.

get_offset(self) [source]

locs = []

set_locs(self, locs) [source]

class matplotlib.ticker.FuncFormatter(func) [source]

Bases: matplotlib.ticker.Formatter

Используйте пользовательскую функцию для форматирования.

Функция должна принимать два входных значения (значение отметки x и позицию pos) и возвращать строку, содержащую соответствующую метку отметки.

class matplotlib.ticker.IndexFormatter(labels) [source]

Bases: matplotlib.ticker.Formatter

Форматирует позицию x до ближайшей i-й метки, где i = int(x + 0.5). Позиции, где i < 0 или i > len(list) отсутствуют метки отметки.

Параметры:	`labelslist` Список меток.

class matplotlib.ticker.IndexLocator(base, offset) [source]

Bases: matplotlib.ticker.Locator

Размещает отметку на каждом кратном некоторому основанию числа нарисованных точек, например, на каждой 5-й точке. Предполагается, что вы выполняете индексный график; т.е. ось составляет 0, len(данные). Это в основном полезно для меток x.

Размещает отметки через основание точек данных, начиная с смещения.

set_params(self, base=None, offset=None) [source]: Установить параметры внутри этого локета

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных отметок, заданные vmin и vmax.

Примечание

Чтобы получить позиции отметок с автоматически определенными значениями vmin и vmax для связанного axis просто вызовите экземпляр локета:

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

class matplotlib.ticker.LinearLocator(numticks=None, presets=None) [source]

Bases: matplotlib.ticker.Locator

Определите позиции отметок.

В первый раз при вызове этой функции она попытается установить количество отметок для создания красивого разбиения отметок. После этого количество отметок будет фиксированным, чтобы интерактивное навигация было удобным.

Используйте предопределенные значения для установки locs на основе lom. Словарь, отображающий vmin, vmax->locs

property numticks

set_params(self, numticks=None, presets=None) [source]: Установить параметры внутри этого локета.

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных отметок, заданные vmin и vmax.

Примечание

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

view_limits(self, vmin, vmax) [source]: Попытайтесь разумно выбрать пределы отображения.

class matplotlib.ticker.Locator [source]

Bases: matplotlib.ticker.TickHelper

Определяет позиции отметок;

Обратите внимание, что один и тот же локет не следует использовать для нескольких Axis, поскольку локет сохраняет ссылки на данные оси и пределы отображения.

MAXTICKS = 1000

autoscale(self) [source]: [Устарело] Автоматически масштабировать пределы отображения.

Примечания

Устарело начиная с версии 3.2.

nonsingular(self, v0, v1) [source]

Корректирует диапазон по необходимости, чтобы избежать особенностей.

Этот метод вызывается во время автоматического масштабирования, с (v0, v1) установленными на пределы данных на осях, если оси содержат какие-либо данные, или (-inf, +inf) в противном случае.

Если v0 == v1 (возможно, с некоторой погрешностью с плавающей точкой), этот метод возвращает расширенный интервал вокруг этого значения.
Если (v0, v1) == (-inf, +inf), этот метод возвращает соответствующие пределы отображения по умолчанию.
В противном случае (v0, v1) возвращается без изменений.

pan(self, numsteps) [source]: Панорамирование numticks (может быть положительным или отрицательным)

raise_if_exceeds(self, locs) [source]

Записывает сообщение WARNING, если locs длиннее, чем Locator.MAXTICKS.

Этот метод предназначен для вызова непосредственно перед возвращением locs из __call__ для информирования пользователей в случае, если их локет возвращает огромное количество отметок, из-за чего у Matplotlib может закончится память.

«Странное» имя этого метода восходит к времени, когда он вместо этого генерировал исключение.

refresh(self) [source]: Обновить внутреннюю информацию на основе текущих пределов.

set_params(self, **kwargs) [source]: Ничего не делает и выводит предупреждение. Любой класс локета, не поддерживающий функцию set_params(), вызовет это.

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных отметок, заданные vmin и vmax.

Примечание

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

view_limits(self, vmin, vmax) [source]

Выберите масштаб для диапазона от vmin до vmax.

Подклассы должны переопределять этот метод, чтобы изменить поведение локета.

zoom(self, direction) [source]: Увеличить/уменьшить масштаб оси; если направление >0, увеличить, в противном случае уменьшить

class matplotlib.ticker.LogFormatter(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None) [source]

Базовый класс для форматирования делений на логарифмической или симметрично-логарифмической шкале.

Он может быть создан напрямую или унаследован.

Параметры:

Параметры:	`basefloat, optional, default: 10.` Основание логарифма, используемого во всех вычислениях. `labelOnlyBasebool, optional, default: False` Если True, метки делений ставятся только на целых степенях основания. Обычно True для основных делений и False для вспомогательных. `minor_thresholds(subset, all), optional, default: (1, 0.4)` Если labelOnlyBase — False, эти два числа управляют метками делений, которые не являются целыми степенями основания; обычно это вспомогательные метки. Управляющим параметром является логарифм диапазона данных оси. В типичном случае, когда основание равно 10, это количество десятичных разрядов, охватываемых осью, поэтому мы можем назвать его 'numdec'. Если `numdec <= all`, все вспомогательные метки будут помечены. Если `all < numdec <= subset`, то будет помечена только часть вспомогательных меток, чтобы избежать перегрузки. Если `numdec > subset`, то вспомогательные метки не будут помечены. `linthreshNone or float, optional, default: None` Если используется симметричная логарифмическая шкала, её параметр `linthresh` должен быть указан здесь.

basefloat, optional, default: 10.: Основание логарифма, используемого во всех вычислениях.
labelOnlyBasebool, optional, default: False: Если True, метки делений ставятся только на целых степенях основания. Обычно True для основных делений и False для вспомогательных.
minor_thresholds(subset, all), optional, default: (1, 0.4): Если labelOnlyBase — False, эти два числа управляют метками делений, которые не являются целыми степенями основания; обычно это вспомогательные метки. Управляющим параметром является логарифм диапазона данных оси. В типичном случае, когда основание равно 10, это количество десятичных разрядов, охватываемых осью, поэтому мы можем назвать его 'numdec'. Если numdec <= all, все вспомогательные метки будут помечены. Если all < numdec <= subset, то будет помечена только часть вспомогательных меток, чтобы избежать перегрузки. Если numdec > subset, то вспомогательные метки не будут помечены.
linthreshNone or float, optional, default: None: Если используется симметричная логарифмическая шкала, её параметр linthresh должен быть указан здесь.

Примечания

Метод set_locs должен быть вызван для активации логики подмножества, управляемой параметром minor_thresholds.

В некоторых случаях, таких как цветовая шкала, нет различия между основными и вспомогательными делениями; расположение делений может быть задано вручную или с помощью локатора, который размещает деления на целых степенях основания и в промежуточных точках. В этой ситуации отключите логику minor_thresholds, используя minor_thresholds=(np.inf, np.inf), чтобы все деления были помечены.

Чтобы отключить маркировку вспомогательных делений, когда 'labelOnlyBase' — False, используйте minor_thresholds=(0, 0). Это значение по умолчанию для стиля "классический".

Примеры

Чтобы пометить подмножество вспомогательных делений, когда пределы отображения охватывают до 2 десятичных разрядов, и все деления при масштабировании до 0,5 десятичных разрядов или меньше, используйте minor_thresholds=(2, 0.5).

Чтобы пометить все вспомогательные деления, когда пределы отображения охватывают до 1,5 десятичных разрядов, используйте minor_thresholds=(1.5, 1.5).

base(self, base) [source]: Изменить основание для маркировки.

Предупреждение

Должно всегда соответствовать основанию, используемому для LogLocator

format_data(self, value) [source]: Возвращает полное строковое представление значения без указания позиции.

format_data_short(self, value) [source]: Возвращает короткое форматированное строковое представление числа.

label_minor(self, labelOnlyBase) [source]

Включить или отключить маркировку вспомогательных делений.

Параметры:	`labelOnlyBasebool` Если True, метки делений ставятся только на целых степенях основания.

pprint_val(self, *args, **kwargs) [source]: [Устаревшее]

Примечания

Устаревшее начиная с версии 3.1:

set_locs(self, locs=None) [source]

Используйте пределы отображения оси для управления тем, какие деления будут помечены.

Параметр locs игнорируется в текущем алгоритме.

class matplotlib.ticker.LogFormatterExponent(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None) [source]

Базовый класс: matplotlib.ticker.LogFormatter

Форматирование значений для логарифмической оси с использованием exponent = log_base(value).

class matplotlib.ticker.LogFormatterMathtext(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None) [source]

Базовый класс: matplotlib.ticker.LogFormatter

Форматирование значений для логарифмической оси с использованием exponent = log_base(value).

class matplotlib.ticker.LogFormatterSciNotation(base=10.0, labelOnlyBase=False, minor_thresholds=None, linthresh=None) [source]

Базовый класс: matplotlib.ticker.LogFormatterMathtext

Форматирование значений в формате научной записи для логарифмической оси.

class matplotlib.ticker.LogLocator(base=10.0, subs=1.0, numdecs=4, numticks=None) [source]

Базовый класс: matplotlib.ticker.Locator

Определение расположения делений для логарифмических осей.

Размещение делений на позициях: subs[j] * base**i

Параметры:

Параметры:	`subsNone, str, or sequence of float, optional, default (1.0,)` Определяет кратные целых степеней основания, на которых будут размещены деления. По умолчанию деления размещаются только на целых степенях основания. Разрешенные строковые значения: `'auto'` и `'all'`, оба из которых используют алгоритм, основанный на пределах отображения оси, чтобы определить, нужно ли и как размещать деления между целыми степенями основания. С `'auto'`, деления размещаются только между целыми степенями; с `'all'`, целые степени также включаются. Значение None эквивалентно `'auto'`.

subsNone, str, or sequence of float, optional, default (1.0,): Определяет кратные целых степеней основания, на которых будут размещены деления. По умолчанию деления размещаются только на целых степенях основания. Разрешенные строковые значения: 'auto' и 'all', оба из которых используют алгоритм, основанный на пределах отображения оси, чтобы определить, нужно ли и как размещать деления между целыми степенями основания. С 'auto', деления размещаются только между целыми степенями; с 'all', целые степени также включаются. Значение None эквивалентно 'auto'.

base(self, base) [source]: Установить основание логарифма (главное деление каждые base**i, i — целое число).

nonsingular(self, vmin, vmax) [source]

Корректировка диапазона для избежания особенностей.

Этот метод вызывается во время автоматического масштабирования, при этом (v0, v1) устанавливается в пределы данных на осях, если оси содержат данные, или (-inf, +inf) в противном случае.

Если v0 == v1 (возможно, с погрешностью плавающей точки), этот метод возвращает расширенный интервал вокруг этого значения.
Если (v0, v1) == (-inf, +inf), этот метод возвращает соответствующие пределы отображения по умолчанию.
В противном случае, (v0, v1) возвращается без изменений.

set_params(self, base=None, subs=None, numdecs=None, numticks=None) [source]: Установить параметры внутри этого локатора.

subs(self, subs) [source]: Установить вспомогательные деления для логарифмической шкалы каждые base**i*subs[j].

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных делений, заданные vmin и vmax.

Примечание

Чтобы получить расположение делений со значениями vmin и vmax, определёнными автоматически для связанной axis, просто вызовите экземпляр Локатора:

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

view_limits(self, vmin, vmax) [source]: Попытка разумно выбрать пределы отображения.

END_OF_DOCUMENT_MARKER ```

class matplotlib.ticker.LogitFormatter(*, use_overline=False, one_half='\x0crac{1}{2}', minor=False, minor_threshold=25, minor_number=6) [source]

Базовые классы: matplotlib.ticker.Formatter

Форматирование вероятностей (используя математический текст).

Параметры:

Параметры:	`use_overlinebool, default: False` Если x > 1/2, при x = 1-v, указывает, должен ли x отображаться как $overline{v}$. По умолчанию отображается $1-v$. `one_halfstr, default: r"frac{1}{2}"` Строка, используемая для представления 1/2. `minorbool, default: False` Указывает, форматирует ли форматировщик малые метки или нет. В основном малые метки не подписываются, за исключением случаев, когда предоставлено лишь несколько меток, подписываются метки с наибольшим пространством с соседними метками. См. другие параметры для изменения поведения по умолчанию. `minor_thresholdint, default: 25` Максимальное количество меток для подписания некоторых малых меток. Этот параметр не имеет эффекта, если minor = False. `minor_numberint, default: 6` Количество меток, которые подписываются, когда количество меток ниже порога.

use_overlinebool, default: False: Если x > 1/2, при x = 1-v, указывает, должен ли x отображаться как $overline{v}$. По умолчанию отображается $1-v$.
one_halfstr, default: r"frac{1}{2}": Строка, используемая для представления 1/2.
minorbool, default: False: Указывает, форматирует ли форматировщик малые метки или нет. В основном малые метки не подписываются, за исключением случаев, когда предоставлено лишь несколько меток, подписываются метки с наибольшим пространством с соседними метками. См. другие параметры для изменения поведения по умолчанию.
minor_thresholdint, default: 25: Максимальное количество меток для подписания некоторых малых меток. Этот параметр не имеет эффекта, если minor = False.
minor_numberint, default: 6: Количество меток, которые подписываются, когда количество меток ниже порога.

format_data_short(self, value) [source]: Возвращает короткое отформатированное строковое представление числа.

set_locs(self, locs) [source]

set_minor_number(self, minor_number) [source]

Устанавливает количество малых меток для подписания, когда некоторые малые метки подписываются.

Параметры:	`minor_numberint` Количество меток, которые подписываются, когда количество меток ниже порога.

set_minor_threshold(self, minor_threshold) [source]

Устанавливает порог для подписания малых меток.

Параметры:	`minor_thresholdint` Максимальное количество местоположений для подписания некоторых малых меток. Этот параметр не имеет эффекта, если minor = False.

set_one_half(self, one_half) [source]

Устанавливает способ отображения одной половины.

one_halfstr, default: r"frac{1}{2}": Строка, используемая для представления 1/2.

use_overline(self, use_overline) [source]

Переключает режим отображения с надстрочной чертой для подписания p>1/2.

Параметры:	`use_overlinebool, default: False` Если x > 1/2, при x = 1-v, указывает, должен ли x отображаться как $overline{v}$. По умолчанию отображается $1-v$.

class matplotlib.ticker.LogitLocator(minor=False, *, nbins='auto') [source]

Базовые классы: matplotlib.ticker.MaxNLocator

Определение местоположений меток для логарифмических осей.

Размещение меток в логарифмических местоположениях.

Параметры:	`nbinsint or 'auto', optional` Количество меток. Используется только если minor = False. `minorbool, default: False` Указывает, является ли этот локатор для малых меток или нет.

property minor

nonsingular(self, vmin, vmax) [source]

Настройка диапазона при необходимости для предотвращения особенностей.

Этот метод вызывается во время автоматического масштабирования с (v0, v1) установленными в пределы данных на осях, если оси содержат данные, или (-inf, +inf) в противном случае.

Если v0 == v1 (возможно, с некоторыми погрешностями с плавающей запятой), этот метод возвращает расширенный интервал вокруг этого значения.
Если (v0, v1) == (-inf, +inf), этот метод возвращает соответствующие пределы просмотра по умолчанию.
В противном случае (v0, v1) возвращается без изменений.

set_params(self, minor=None, **kwargs) [source]: Установка параметров в этом локаторе.

tick_values(self, vmin, vmax) [source]

Возвращает значения размеченных меток, заданных vmin и vmax.

Примечание

Чтобы получить местоположения меток с автоматически определенными значениями vmin и vmax для связанных axis просто вызовите экземпляр локатора:

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

class matplotlib.ticker.MaxNLocator(*args, **kwargs) [source]

Основывается на matplotlib.ticker.Locator

Выбирает не более N интервалов в удобных местах.

Параметры:

Параметры:	`nbinsint or 'auto', optional, default: 10` Максимальное количество интервалов; на один меньше, чем максимальное количество делений. Если строка `'auto'`, количество бинов будет определяться автоматически на основе длины оси. `stepsarray-like, optional` Последовательность удобных чисел, начинающаяся с 1 и заканчивающаяся 10; например, [1, 2, 4, 5, 10], где значения являются допустимыми кратными делений. Т.е. для примера 20, 40, 60 были бы допустимыми значениями делений, как и 0.4, 0.6, 0.8, потому что они являются кратными 2. Однако 30, 60, 90 не будут разрешены, потому что 3 не входит в список шагов. `integerbool, optional, default: False` Если True, деления будут принимать только целые значения, при условии, что по крайней мере `min_n_ticks` целых чисел найдено в пределах пределов отображения. `symmetricbool, optional, default: False` Если True, автоматическое масштабирование приведет к диапазону, симметричному относительно нуля. `prune{'lower', 'upper', 'both', None}, optional, default: None` Удалить крайние деления — полезно для наложенных или связанных графиков, где верхнее деление одной оси перекрывается нижним делением оси над ней, в основном, когда `rcParams["axes.autolimit_mode"]` (по умолчанию: 'data') является `'round_numbers'`. Если `prune=='lower'`, будет удалено наименьшее деление. Если `prune == 'upper'`, будет удалено наибольшее деление. Если `prune == 'both'`, будут удалены наибольшее и наименьшее деления. Если `prune == None`, никакие деления не будут удалены. `min_n_ticksint, optional, default: 2` Смягчить ограничения nbins и integer при необходимости, чтобы получить это минимальное количество делений.

nbinsint or 'auto', optional, default: 10: Максимальное количество интервалов; на один меньше, чем максимальное количество делений. Если строка 'auto', количество бинов будет определяться автоматически на основе длины оси.
stepsarray-like, optional: Последовательность удобных чисел, начинающаяся с 1 и заканчивающаяся 10; например, [1, 2, 4, 5, 10], где значения являются допустимыми кратными делений. Т.е. для примера 20, 40, 60 были бы допустимыми значениями делений, как и 0.4, 0.6, 0.8, потому что они являются кратными 2. Однако 30, 60, 90 не будут разрешены, потому что 3 не входит в список шагов.
integerbool, optional, default: False: Если True, деления будут принимать только целые значения, при условии, что по крайней мере min_n_ticks целых чисел найдено в пределах пределов отображения.
symmetricbool, optional, default: False: Если True, автоматическое масштабирование приведет к диапазону, симметричному относительно нуля.
prune{'lower', 'upper', 'both', None}, optional, default: None: Удалить крайние деления — полезно для наложенных или связанных графиков, где верхнее деление одной оси перекрывается нижним делением оси над ней, в основном, когда rcParams["axes.autolimit_mode"] (по умолчанию: 'data') является 'round_numbers'. Если prune=='lower', будет удалено наименьшее деление. Если prune == 'upper', будет удалено наибольшее деление. Если prune == 'both', будут удалены наибольшее и наименьшее деления. Если prune == None, никакие деления не будут удалены.
min_n_ticksint, optional, default: 2: Смягчить ограничения nbins и integer при необходимости, чтобы получить это минимальное количество делений.

default_params = {'integer': False, 'min_n_ticks': 2, 'nbins': 10, 'prune': None, 'steps': None, 'symmetric': False}

set_params(self, **kwargs) [source]

Установить параметры для этого локета.

Параметры:	`nbinsint or 'auto', optional` см. `MaxNLocator` `stepsarray-like, optional` см. `MaxNLocator` `integerbool, optional` см. `MaxNLocator` `symmetricbool, optional` см. `MaxNLocator` `prune{'lower', 'upper', 'both', None}, optional` см. `MaxNLocator` `min_n_ticksint, optional` см. `MaxNLocator`

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных делений, заданные vmin и vmax.

Примечание

Для получения позиций делений со значениями vmin и vmax, автоматически определёнными для связанного axis просто вызовите экземпляр локета:

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

view_limits(self, dmin, dmax) [source]

Выбирает масштаб для диапазона от vmin до vmax.

Подклассы должны переопределять этот метод для изменения поведения локета.

class matplotlib.ticker.MultipleLocator(base=1.0) [source]

Основывается на matplotlib.ticker.Locator

Устанавливает деление на каждом целом кратном основанию в пределах интервала отображения.

set_params(self, base) [source]: Установить параметры внутри локета.

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных делений, заданные vmin и vmax.

Примечание

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

view_limits(self, dmin, dmax) [source]: Установить пределы отображения на ближайшие кратные основанию, содержащие данные.

class matplotlib.ticker.NullFormatter [source]

Основывается на matplotlib.ticker.Formatter

Всегда возвращает пустую строку.

class matplotlib.ticker.NullLocator [source]

Основывается на matplotlib.ticker.Locator

Нет делений

tick_values(self, vmin, vmax) [source]: " Возвращает позиции делений.

Примечание

Так как значения равны Null, vmin и vmax не используются в этом методе.

class matplotlib.ticker.OldAutoLocator [source]

Основывается на matplotlib.ticker.Locator

При автоматическом масштабировании этот класс выбирает лучший MultipleLocator для установки пределов отображения и позиций делений.

get_locator(self, d) [source]: Выбрать лучший локет, основываясь на расстоянии d.

refresh(self) [source]: Обновить внутреннюю информацию на основе текущих пределов.

tick_values(self, vmin, vmax) [source]

Возвращает значения размещенных делений, заданные vmin и vmax.

Примечание

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

view_limits(self, vmin, vmax) [source]: Попытаться выбрать пределы отображения интеллектуально

class matplotlib.ticker.OldScalarFormatter [source]

Основывается на matplotlib.ticker.Formatter

Позиция деления — просто обычное число.

pprint_val(self, x, d) [source]: [Устарело] Форматирует значение x, основываясь на размере диапазона оси d.

Примечания

Устарело начиная с версии 3.1.

class matplotlib.ticker.PercentFormatter(xmax=100, decimals=None, symbol='%', is_latex=False) [source]

Основы: matplotlib.ticker.Formatter

Форматирование чисел в виде процента.

Параметры:

Параметры:	`xmaxfloat` Определяет, как число преобразуется в процент. xmax — значение данных, соответствующее 100%. Проценты вычисляются как `x / xmax * 100`. Таким образом, если данные уже масштабированы до процентов, xmax будет равен 100. Другая распространенная ситуация — когда xmax равен 1,0. `decimalsNone or int` Количество знаков после запятой. Если None (по умолчанию), количество знаков вычисляется автоматически. `symbolstr or None` Строка, которая будет добавлена к метке. Может быть None или пустой, чтобы указать, что символ не должен использоваться. Специальные символы LaTeX экранируются в symbol, когда включен режим latex, если только is_latex не равно True. `is_latexbool` Если False, зарезервированные символы LaTeX в symbol будут экранированы.

xmaxfloat: Определяет, как число преобразуется в процент. xmax — значение данных, соответствующее 100%. Проценты вычисляются как x / xmax * 100. Таким образом, если данные уже масштабированы до процентов, xmax будет равен 100. Другая распространенная ситуация — когда xmax равен 1,0.
decimalsNone or int: Количество знаков после запятой. Если None (по умолчанию), количество знаков вычисляется автоматически.
symbolstr or None: Строка, которая будет добавлена к метке. Может быть None или пустой, чтобы указать, что символ не должен использоваться. Специальные символы LaTeX экранируются в symbol, когда включен режим latex, если только is_latex не равно True.
is_latexbool: Если False, зарезервированные символы LaTeX в symbol будут экранированы.

convert_to_pct(self, x) [source]

format_pct(self, x, display_range) [source]

Форматирует число как процентное значение с правильным количеством десятичных знаков и добавляет символ процента, если он есть.

Если self.decimals равно None, количество знаков после запятой устанавливается на основе display_range оси следующим образом:

Диапазон отображения	Десятичные знаки	Пример
>50	0	`x = 34.5` => 35%
>5	1	`x = 34.5` => 34,5%
>0,5	2	`x = 34.5` => 34,50%
...	...	...

Этот метод не будет очень эффективным для очень маленьких или очень больших диапазонов осей. Он предполагает, что значения на графике — это проценты, отображаемые на разумном масштабе.

property symbol

Настроенный символ процента в виде строки.

Если LaTeX включен через rcParams["text.usetex"] (по умолчанию: False), специальные символы {'#', '$', '%', '&', '~', '_', '^', '\', '{', '}'} автоматически экранируются в строке.

class matplotlib.ticker.ScalarFormatter(useOffset=None, useMathText=None, useLocale=None) [source]

Основы: matplotlib.ticker.Formatter

Форматирование значений меток в виде числа.

Значение метки интерпретируется как обычное число. Если useOffset==True и диапазон данных намного меньше среднего значения данных, то будет определен смещение, чтобы метки были осмысленными. Научная запись используется для data < 10^-n или data >= 10^m, где n и m — пределы степени, установленные с помощью set_powerlimits((n, m)). По умолчанию эти значения регулируются параметром rc axes.formatter.limits.

fix_minus(self, s) [source]: Замена тире на символ unicode минус.

format_data(self, value) [source]: Возвращает отформатированное строковое представление числа.

format_data_short(self, value) [source]: Возвращает короткое отформатированное строковое представление числа.

get_offset(self) [source]: Возвращает научную запись плюс смещение.

get_useLocale(self) [source]

get_useMathText(self) [source]

get_useOffset(self) [source]

pprint_val(self, x) [source]: [Устарело]

Примечания

Устарело начиная с версии 3.1:

set_locs(self, locs) [source]: Устанавливает позиции меток.

set_powerlimits(self, lims) [source]

Устанавливает пороговые значения размера для научной записи.

Параметры:

Параметры:	`lims(min_exp, max_exp)` Кортеж, содержащий степени 10, которые определяют порог переключения. Числа ниже `10min_exp` и выше `10max_exp` будут отображаться в научной записи. Например, `formatter.set_powerlimits((-3, 4))` устанавливает значения по умолчанию до 2007 года, в которых научная запись используется для чисел меньше 1e-3 или больше 1e4.

lims(min_exp, max_exp)

Кортеж, содержащий степени 10, которые определяют порог переключения. Числа ниже 10**min_exp и выше 10**max_exp будут отображаться в научной записи.

Например, formatter.set_powerlimits((-3, 4)) устанавливает значения по умолчанию до 2007 года, в которых научная запись используется для чисел меньше 1e-3 или больше 1e4.

См. также

ScalarFormatter.set_scientific

set_scientific(self, b) [source]

Включение или выключение научной записи.

См. также

ScalarFormatter.set_powerlimits

set_useLocale(self, val) [source]

set_useMathText(self, val) [source]

set_useOffset(self, val) [source]

property useLocale

property useMathText

property useOffset

class matplotlib.ticker.StrMethodFormatter(fmt) [source]

Основы: matplotlib.ticker.Formatter

Используйте строку форматирования нового стиля (как используется в str.format()) для форматирования метки.

Поле, используемое для значения, должно быть помечено x, а поле, используемое для позиции, — pos.

class matplotlib.ticker.SymmetricalLogLocator(transform=None, subs=None, linthresh=None, base=None) [source]

Базовое класс: matplotlib.ticker.Locator

Определение расположения делений для симметричных логарифмических осей

Размещение делений в позициях base**i*subs[j].

set_params(self, subs=None, numticks=None) [source]: Установка параметров этого локейтора.

tick_values(self, vmin, vmax) [source]

Возвращает значения делений, заданные vmin и vmax.

Примечание

Чтобы получить позиции делений с автоматически заданными значениями vmin и vmax для соответствующей axis просто вызовите экземпляр локейтора:

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

view_limits(self, vmin, vmax) [source]: Попытка определить пределы просмотра разумно

class matplotlib.ticker.TickHelper [source]

Базовое класс: object

axis = None

create_dummy_axis(self, **kwargs) [source]

set_axis(self, axis) [source]

set_bounds(self, vmin, vmax) [source]

set_data_interval(self, vmin, vmax) [source]

set_view_interval(self, vmin, vmax) [source]