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

Располагает деления равномерно от минимального до максимального значения.

LogLocator

Располагает деления логарифмически от минимального до максимального значения.

MultipleLocator

Деления и диапазон являются кратными основанию; целые числа или числа с плавающей точкой.

FixedLocator

Местоположения делений фиксированы.

IndexLocator

Локатор для графиков индексов (например, где x = range(len(y))).

NullLocator

Нет делений.

SymmetricalLogLocator

Локатор для использования с симметричной логарифмической нормой; работает как 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

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

LogFormatterMathtext

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

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.TickHelper [source]

Bases: 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]

class matplotlib.ticker.Formatter [source]

Базы: matplotlib.ticker.TickHelper

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

fix_minus(self, s) [source]

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

Обратите внимание, если вы используете этот метод, например, в format_data() или вызовите его, то, вероятно, не стоит использовать его для format_data_short(), так как панель инструментов использует его для интерактивного отчёта о координатах, и маловероятно, что графические интерфейсы разных платформ будут правильно обрабатывать этот символ Юникода. Таким образом, на данный момент классы, переопределяющие 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.FixedFormatter(seq) [source]

Базы: matplotlib.ticker.Formatter

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

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

get_offset(self) [source]

set_offset_string(self, ofs) [source]

class matplotlib.ticker.NullFormatter [source]

Базы: matplotlib.ticker.Formatter

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

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

Базы: matplotlib.ticker.Formatter

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

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

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

Базы: matplotlib.ticker.Formatter

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

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

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

Базы: matplotlib.ticker.Formatter

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

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

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, определяющие пороговое значение переключения. Числа ниже 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]

useLocale

useMathText

useOffset

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

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

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

Можно создать экземпляр напрямую или создать подкласс.

Параметры:

base : float, optional, default: 10. Основание логарифма, используемое во всех вычислениях. labelOnlyBase : bool, 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, то вспомогательные деления не будут помечены. linthresh : None or float, optional, default: None Если используется симметричная логарифмическая шкала, её параметр linthresh должен быть передан сюда.

Примечания

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

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

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

Примеры

Чтобы отобразить подмножество вспомогательных делений, когда пределы отображения охватывают до 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]

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

Параметры:	labelOnlyBase : bool Если 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.IndexFormatter(labels) [source]

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

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

Параметры:	labels : list Список меток.

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

Основан на: matplotlib.ticker.LogFormatterMathtext

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

class matplotlib.ticker.LogitFormatter [source]

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

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

format_data_short(self, value) [source]

возвращает короткое форматированное строковое представление числа

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

Bases: matplotlib.ticker.Formatter

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

Параметры:

unit : str (default: "") Символ единицы для использования, подходящий для односимвольных представлений степеней 1000. Например, 'Гц' или 'м'. places : int (default: None) Точность отображения числа, указанная в цифрах после десятичной точки (будет от одной до трёх цифр перед десятичной точкой). Если это None, форматирование возвращается к плавающей точке формата '%g', который отображает до 6 значимых цифр, т.е. эквивалентное значение для разрядов варьируется от 0 до 5 (включительно). sep : str (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). usetex : bool (default: None) Для включения/отключения использования математического режима TeX для отображения чисел в форматировщике. useMathText : bool (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]

useMathText

usetex

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

Bases: matplotlib.ticker.Formatter

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

Параметры:

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

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%
...	...	...

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

symbol

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

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

class matplotlib.ticker.Locator [source]

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

Определение местоположения делений;

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

MAXTICKS = 1000

autoscale(self) [source]

Автомасштабирование пределов отображения

nonsingular(self, v0, v1) [source]

Расширение диапазона при необходимости для избежания особенностей.

pan(self, numsteps) [source]

Панорамирование numticks (может быть положительным или отрицательным)

raise_if_exceeds(self, locs) [source]

вызывает RuntimeError, если Locator пытается создать более MAXTICKS местоположений

refresh(self) [source]

Обновление внутренней информации на основе текущих пределов

set_params(self, **kwargs) [source]

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

tick_values(self, vmin, vmax) [source]

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

Примечание

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

>>> 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.IndexLocator(base, offset) [source]

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

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

размещение делений на i-ых точках данных, где (i-смещение)%основание==0

set_params(self, base=None, offset=None) [source]

Установка параметров внутри этого локета

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.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.NullLocator [source]

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

Нет делений

tick_values(self, vmin, vmax) [source]

Возвращает местоположения делений.

Примечание

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

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

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

Определение местоположения делений

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

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

set_params(self, numticks=None, presets=None) [source]

Установка параметров внутри этого локета.

tick_values(self, vmin, vmax) [source]

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

Примечание

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

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

view_limits(self, vmin, vmax) [source]

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

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

Bases: matplotlib.ticker.Locator

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

Расположение делений по значениям: subs[j] * base**i

Параметры:

subs : None, string, 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]

Расширение диапазона по мере необходимости для избежания особенностей.

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]

Попытка разумного выбора пределов отображения

class matplotlib.ticker.AutoLocator [source]

Bases: matplotlib.ticker.MaxNLocator

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

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

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

Bases: matplotlib.ticker.Locator

Устанавливает деление на каждом целочисленном кратном базе внутри интервала отображения.

set_params(self, base) [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, dmin, dmax) [source]

Установка пределов отображения до ближайших кратных базе, содержащих данные.

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

Базы: matplotlib.ticker.Locator

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

Параметры:

nbins : int or 'auto', optional, default: 10 Максимальное количество интервалов; на один меньше максимального количества делений. Если строка 'auto', количество интервалов будет определено автоматически на основе длины оси. steps : array-like, optional Последовательность удобных чисел, начинающихся с 1 и заканчивающихся 10; например, [1, 2, 4, 5, 10], где значения являются допустимыми кратными для делений. Например, для примера, 20, 40, 60 будут допустимым набором делений, как и 0,4, 0,6, 0,8, потому что они являются кратными 2. Однако 30, 60, 90 не будут разрешены, потому что 3 не содержится в списке шагов. integer : bool, optional, default: False Если True, деления будут принимать только целые значения, при условии, что по крайней мере min_n_ticks целых чисел найдены в пределах границ отображения. symmetric : bool, optional, default: False Если True, автоматическое масштабирование приведет к диапазону, симметричному относительно нуля. prune : {'lower', 'upper', 'both', None}, optional, default: None Убрать крайние деления — полезно для наложенных или связанных графиков, где верхнее деление одной оси перекрывается с нижним делением оси над ней, в первую очередь, когда rcParams["axes.autolimit_mode"] равно 'round_numbers'. Если prune=='lower', будет удалено наименьшее деление. Если prune == 'upper', будет удалено наибольшее деление. Если prune == 'both', будут удалены наибольшее и наименьшее деления. Если prune == None, деления не будут удалены. min_n_ticks : int, 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]

Настройка параметров этого локэтора.

Параметры:	nbins : int or 'auto', optional см. MaxNLocator steps : array-like, optional см. MaxNLocator integer : bool, optional см. MaxNLocator symmetric : bool, optional см. MaxNLocator prune : {'lower', 'upper', 'both', None}, optional см. MaxNLocator min_n_ticks : int, 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.AutoMinorLocator(n=None) [source]

Базы: matplotlib.ticker.Locator

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

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

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

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.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.LogitLocator(minor=False) [source]

Базы: matplotlib.ticker.Locator

Определение местоположений делений для лог-осей

размещает деления в лог-позициях

nonsingular(self, vmin, vmax) [source]

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

set_params(self, minor=None) [source]

Настройка параметров в этом локэторе.

tick_values(self, vmin, vmax) [source]

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

Примечание

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

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