ticker

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

Bases: object

axis = None

create_dummy_axis(**kwargs) [source]

set_axis(axis) [source]

set_bounds(vmin, vmax) [source]

set_data_interval(vmin, vmax) [source]

set_view_interval(vmin, vmax) [source]

class matplotlib.ticker.Formatter [source]

Базы: matplotlib.ticker.TickHelper

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

fix_minus(s) [source]

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

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

format_data(value) [source]

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

format_data_short(value) [source]

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

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

get_offset() [source]

locs = []

set_locs(locs) [source]

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

Базы: matplotlib.ticker.Formatter

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

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

get_offset() [source]

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

Замена тире на минус-символ Unicode.

format_data(value) [source]

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

format_data_short(value) [source]

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

get_offset() [source]

Возвращает научную запись плюс смещение.

get_useLocale() [source]

get_useMathText() [source]

get_useOffset() [source]

pprint_val(x) [source]

set_locs(locs) [source]

Установка расположения меток.

set_powerlimits(lims) [source]

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

Параметры:

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

set_scientific(b) [source]

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

См. также

Метод set_powerlimits()

set_useLocale(val) [source]

set_useMathText(val) [source]

set_useOffset(val) [source]

useLocale

useMathText

useOffset

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

Bases: 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(base) [source]

Изменение основания для вывода.

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

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

format_data(value) [source]

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

format_data_short(value) [source]

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

label_minor(labelOnlyBase) [source]

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

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

pprint_val(x, d) [source]

set_locs(locs=None) [source]

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

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

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

Bases: matplotlib.ticker.LogFormatter

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

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

Bases: matplotlib.ticker.LogFormatter

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

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

Bases: matplotlib.ticker.Formatter

Форматирование позиции x до ближайшей i-й метки, где i=int(x+0.5)

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

Bases: matplotlib.ticker.LogFormatterMathtext

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

class matplotlib.ticker.LogitFormatter [source]

Bases: matplotlib.ticker.Formatter

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

format_data_short(value) [source]

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

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

Bases: matplotlib.ticker.Formatter

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

Параметры:

unit : str (default: "") Символ единицы для использования, подходящий для односимвольных представлений степеней 1000. Например, 'Hz' или 'm'. places : int (default: None) Точность отображения числа, заданная количеством цифр после десятичной точки (будет от одной до трех цифр перед десятичной точкой). Если None, форматирование возвращается к плавающей точке '%g', которая отображает до 6 значимых цифр, т.е. эквивалентное значение для places меняется от 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).

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

format_eng(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 μ'

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 в symbol экранируются, когда включен LaTeX-режим, если is_latex не равно True. is_latex : bool Если False, экранируются зарезервированные символы LaTeX в symbol.

convert_to_pct(x) [source]

format_pct(x, display_range) [source]

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

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

display_range	decimals	пример
>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]

Bases: matplotlib.ticker.TickHelper

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

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

MAXTICKS = 1000

autoscale() [source]

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

pan(numsteps) [source]

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

raise_if_exceeds(locs) [source]

вызвать RuntimeError, если Locator пытается создать более MAXTICKS loc

refresh() [source]

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

set_params(**kwargs) [source]

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

view_limits(vmin, vmax) [source]

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

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

zoom(direction) [source]

Увеличение/уменьшение масштаба оси; если направление >0, увеличение, в противном случае уменьшение

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

Bases: matplotlib.ticker.Locator

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

Помещение делений на i-й точках данных, где (i-offset)%base==0

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

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

tick_values(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]

Bases: matplotlib.ticker.Locator

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

set_params(nbins=None) [source]

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

tick_values(vmin, vmax) [source]

" Возвращает позиции делений.

Примечание

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

class matplotlib.ticker.NullLocator [source]

Bases: matplotlib.ticker.Locator

Нет делений

tick_values(vmin, vmax) [source]

" Возвращает позиции делений.

Примечание

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

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

Bases: matplotlib.ticker.Locator

Определяет расположение делений шкалы

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

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

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

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

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

Устанавливает основание логарифмической шкалы (главное деление на каждом base**i, i целое число).

nonsingular(vmin, vmax) [source]

set_params(base=None, subs=None, numdecs=None, numticks=None) [source]

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

subs(subs) [source]

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

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

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

view_limits(dmin, dmax) [source]

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

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

Основание: matplotlib.ticker.Locator

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

Ключевые аргументы:

nbins

Максимальное количество интервалов; на один меньше максимального числа делений. Если строка 'auto', количество интервалов будет определяться автоматически на основе длины оси.

steps

Последовательность удобных чисел, начинающихся с 1 и заканчивающихся 10; например, [1, 2, 4, 5, 10], где значения являются допустимыми кратными для делений. Т.е. для примера 20, 40, 60 будут приемлемым набором делений, как и 0.4, 0.6, 0.8, потому что они являются кратными 2. Однако 30, 60, 90 не будут разрешены, потому что 3 не входит в список шагов.

integer

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

symmetric

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

prune

['нижний' | 'верхний' | 'оба' | None] Удалить крайние деления — полезно для стопки или связанных графиков, где верхнее деление одной оси перекрывается с нижним делением оси над ней, в основном когда rcParams["axes.autolimit_mode"] равно 'round_numbers'. Если prune=='lower', будет удалено наименьшее деление. Если prune == 'upper', будет удалено наибольшее деление. Если prune == 'both', будут удалены наибольшее и наименьшее деления. Если prune == None, деления не будут удаляться.

min_n_ticks

Смягчить nbins и integer ограничения при необходимости, чтобы получить это минимальное количество делений.

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

set_params(**kwargs) [source]

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

view_limits(dmin, dmax) [source]

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

Как правило, этот метод переопределяется подклассами для изменения поведения локатора.

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

Основание: matplotlib.ticker.Locator

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

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

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

tick_values(vmin, vmax) [source]

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

Примечание

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

>>> 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(subs=None, numticks=None) [source]

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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

view_limits(vmin, vmax) [source]

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

class matplotlib.ticker.LogitLocator(minor=False) [source]

Основание: matplotlib.ticker.Locator

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

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

nonsingular(vmin, vmax) [source]

set_params(minor=None) [source]

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

tick_values(vmin, vmax) [source]

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

Примечание

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

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