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 Установите заданный цикл. 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

Стиль с циклом