matplotlib.axes.Axes.set_prop_cycle

Axes.set_prop_cycle(*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 Установите заданный 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