matplotlib.category

Использование графика для данных "категория" типа строка: plot(['d', 'f', 'a'], [1, 2, 3]) построит три точки с значениями оси x 'd', 'f', 'a'.

См. Построение категориальных переменных для примера.

Модуль использует механизм Matplotlib matplotlib.units для преобразования строк в целые числа и предоставляет локатор делений, форматер делений и класс UnitData, который создаёт и сохраняет отображение строк в целые числа.

classmatplotlib.category.StrCategoryConverter[source]

Основывается на ConversionInterface

staticaxisinfo(unit, axis)[source]

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

Параметры:

unitUnitData

объект с информацией о единицах измерения строк для значения

axisAxis

ось, для которой устанавливается информация

Примечание

axis не используется

Возвращает:

AxisInfo

Информация для поддержки стандартного отображения делений

staticconvert(value, unit, axis)[source]

Преобразование строк в value в числа с помощью информации сопоставления, хранящейся в объекте unit.

Параметры:

valuestr или итерируемый объект

Значение или список значений для преобразования.

unitUnitData

Объект, сопоставляющий строки целым числам.

axisAxis

Ось, на которой отображается преобразованное значение.

Примечание

axis не используется.

Возвращает:

число с плавающей точкой или ndarray чисел с плавающей точкой

staticdefault_units(data, axis)[source]

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

Параметры:

dataстрока или итерируемый объект строк

axisAxis

ось, на которой отображаются данные

Возвращает:

UnitData

объект, хранящий отображение строк в целые числа

classmatplotlib.category.StrCategoryFormatter(units_mapping)[source]

Основывается на Formatter

Строковое представление данных на каждом делении.

Параметры:

units_mappingdict

Отображение категорийных имен (str) на индексы (int).

format_ticks(values)[source]

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

classmatplotlib.category.StrCategoryLocator(units_mapping)[source]

Основывается на Locator

Деление на каждый целочисленный элемент отображения данных строк.

Параметры:

units_mappingdict

Отображение категорийных имен (str) на индексы (int).

tick_values(vmin, vmax)[source]

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

Примечание

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

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

classmatplotlib.category.UnitData(data=None)[source]

Основание: object

Создать отображение между уникальными категориальными значениями и целочисленными идентификаторами.

Параметры:

dataiterable

последовательность строковых значений

update(data)[source]

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

Параметры:

dataiterable of str or bytes

Исключения:

TypeError

Если элементы в data не являются ни строками, ни байтами.