matplotlib.axes.Axes.set_prop_cycle

Axes.set_prop_cycle(*args, **kwargs)[source]

Установить цикл свойств осей.

Цикл свойств управляет такими свойствами стиля, как цвет, маркер и стиль линии будущих команд построения графиков. Свойства стиля уже добавленных на оси данных не изменяются.

Подписи вызова функций:

set_prop_cycle(cycler)
set_prop_cycle(label=values[, label2=values2[, ...]])
set_prop_cycle(label, values)

Форма 1 устанавливает заданный объект Cycler.

Форма 2 создает Cycler, который циклически перебирает одно или несколько свойств одновременно и устанавливает его как цикл свойств осей. Если задано несколько свойств, списки их значений должны иметь одинаковую длину. Это всего лишь сокращение для явного создания цикла и передачи его в функцию, т.е. это краткая запись для set_prop_cycle(cycler(label=values label2=values2, ...)).

Форма 3 создает Cycler для одного свойства и устанавливает его как цикл свойств осей. Эта форма существует для совместимости с исходным интерфейсом cycler.cycler. Ее использование не рекомендуется по сравнению с формой с ключевыми словами, т.е. set_prop_cycle(label=values).

Параметры

cyclerCycler

Установить заданный цикл. None сбрасывает до цикла, определенного текущим стилем.

labelstr

Ключ свойства. Должно быть допустимым свойством Artist. Например, 'color' или 'linestyle'. Разрешены псевдонимы, такие как 'c' для 'color' и 'lw' для 'linewidth'.

valuesiterable

Итерируемый объект конечной длины значений свойства. Эти значения проверяются и приведут к ошибке ValueError, если они некорректны.

См. также

matplotlib.rcsetup.cycler

Функция-удобство для создания проверенных циклов свойств.

cycler.cycler

Исходная функция для создания невалидируемых циклов.

Примеры

Установка цикла свойств для одного свойства:

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])

Установка цикла свойств для одновременного циклического перебора нескольких свойств (например, красный круг, зелёный плюс, синий крестик):

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'],
...                   marker=['o', '+', 'x'])

Примеры использования matplotlib.axes.Axes.set_prop_cycle