matplotlib.category

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

См. Отображение категориальных переменных для примера.

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

classmatplotlib.category.StrCategoryConverter[source]

Bases: ConversionInterface

staticaxisinfo(unit, axis)[source]

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

Parameters:

unitUnitData

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

axisAxis

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

Примечание

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

Returns:

AxisInfo

Сведения для поддержки меток делений по умолчанию

staticconvert(value, unit, axis)[source]

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

Parameters:

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

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

unitUnitData

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

axisAxis

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

Примечание

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

Returns:

число или ndarray[число]

staticdefault_units(data, axis)[source]

Устанавливает и обновляет единицы Axis.

Parameters:

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

axisAxis

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

Returns:

UnitData

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

classmatplotlib.category.StrCategoryFormatter(units_mapping)[source]

Bases: Formatter

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

Parameters:

units_mappingdict

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

format_ticks(values)[source]

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

classmatplotlib.category.StrCategoryLocator(units_mapping)[source]

Bases: Locator

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

Parameters:

units_mappingdict

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

tick_values(vmin, vmax)[source]

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

Примечание

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

>>> 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 не являются ни строками, ни байтами.