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

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

Цены на акции за 32 года

Цены на акции за 32 года

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

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