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

END_OF_DOCUMENT_MARKER

class matplotlib.ticker.Formatter [source]

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

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

fix_minus(s) [source]

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

Обратите внимание, если вы используете этот метод, например, в format_data() или вызываете его, вероятно, не стоит использовать его для format_data_short(), поскольку панель инструментов использует его для интерактивного отображения координат, и маловероятно, что интерфейсы пользователя на разных платформах будут правильно обрабатывать символ минуса. Поэтому на данный момент классы, которые переопределяют 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, которые определяют порог переключения. Числа ниже `10min_exp` и выше `10max_exp` будут отображаться в научной записи. Например, `formatter.set_powerlimits((-3, 4))` устанавливает значение по умолчанию до 2007 года, в котором научная запись используется для чисел меньше 1e-3 или больше 1e4. .. seealso:: Метод :meth:`set_scientific`

lims : (min_exp, max_exp)

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

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

.. seealso:: Метод :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` должен быть задан здесь.

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. Например, «Гц» или «м». `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`).

unit : str (default: "")

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

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
u'-1.00 μ'

num может быть числовым значением или строкой, которая может быть преобразована в числовое значение с помощью float(num).

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

Основы: 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 будут экранироваться.

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]

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

Определение позиций делений;

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

MAXTICKS = 1000

autoscale() [source]: Автомасштабирование пределов просмотра

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

raise_if_exceeds(locs) [source]: Выброс исключения RuntimeError, если Locator пытается создать более MAXTICKS позиций делений

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]

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

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

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

set_params(base=None, offset=None) [source]: Установка параметров в пределах этого локатора

tick_values(vmin, vmax) [source]

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

Примечание

>>> 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(nbins=None) [source]: Установка параметров в пределах этого локатора.

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

Примечание

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

class matplotlib.ticker.NullLocator [source]

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

Нет делений

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

Примечание

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

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

Bases: matplotlib.ticker.Locator

Определение позиций делений

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

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

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'`.

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.

Примечание

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

Примечание

>>> 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: ['lower' | 'upper' | 'both' | 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.

Примечание

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

Примечание

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

Примечание

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