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