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

Параметры:

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

Бакалавриат по гендерному признаку

Стилевое оформление с помощью cycler