matplotlib.axes.Axes.set_prop_cycle

Axes.set_prop_cycle(self, *args, **kwargs)

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

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

Вызовы:

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).

Параметры:

cycler : Cycler Установить заданный цикл. None сбрасывает цикл до определения, заданного текущим стилем. label : str Ключ свойства. Должен быть допустимым свойством Artist. Например, 'color' или 'linestyle'. Разрешены псевдонимы, такие как 'c' для 'color' и 'lw' для 'linewidth'. values : iterable Итерируемый объект конечной длины значений свойства. Эти значения проверяются, и при неверном значении будет вызвано исключение 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

Стиль с помощью cycler

Стиль с помощью cycler