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]

Устанавливает значения по умолчанию для тиков и меток осей.

Parameters:

unitUnitData

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

axisAxis

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

Примечание

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

Returns:

AxisInfo

Информация для поддержки меток тиков по умолчанию

staticconvert(value, unit, axis)[source]

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

Parameters:

valuestr или iterable

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

unitUnitData

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

axisAxis

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

Примечание

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

Returns:

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

staticdefault_units(data, axis)[source]

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

Parameters:

dataстрока или iterable из строк

axisAxis

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

Returns:

UnitData

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

classmatplotlib.category.StrCategoryFormatter(units_mapping)[source]

Базовый класс: Formatter

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

Parameters:

units_mappingdict

Отображение имён категорий (строки) на индексы (целые числа).

format_ticks(values)[source]

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

classmatplotlib.category.StrCategoryLocator(units_mapping)[source]

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

Тик на каждом целочисленном отображении данных строки.

Parameters:

units_mappingdict

Отображение имён категорий (строки) на индексы (целые числа).

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]

Bases: object

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

Параметры:

dataiterable

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

update(data)[source]

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

Параметры:

dataiterable of str or bytes

Исключения:

TypeError

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