matplotlib.category

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

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

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

classmatplotlib.category.StrCategoryConverter[source]

Основывается на matplotlib.units.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

float или ndarray[float]

staticdefault_units(data, axis)[source]

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

Parameters

datastr или iterable строк

axisAxis

Ось, на которой строятся данные.

Returns

UnitData

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

classmatplotlib.category.StrCategoryFormatter(units_mapping)[source]

Основывается на matplotlib.ticker.Formatter

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

Parameters

units_mappingdict

Сопоставление имён категорий (str) с индексами (int).

format_ticks(values)[source]

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

classmatplotlib.category.StrCategoryLocator(units_mapping)[source]

Основывается на matplotlib.ticker.Locator

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

Parameters

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

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

Parameters

dataiterable

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

update(data)[source]

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

Parameters

dataiterable строк или байтов

Raises

TypeError

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