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 or iterable

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

unitUnitData

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

axisAxis

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

Примечание

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

Возвращает:

float or ndarray of float

staticdefault_units(data, axis)[source]

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

Параметры:

datastr or iterable of str

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 не являются ни str, ни bytes.