matplotlib.axes.Axes.set_prop_cycle

Axes.set_prop_cycle(*args, **kwargs)[исходный код]

Задать цикл свойств объекта Axes.

Цикл свойств управляет свойствами стиля, такими как цвет, маркер и стиль линии, для последующих команд построения графиков. Свойства стиля данных, уже добавленных в Axes, не изменяются.

Сигнатуры вызова:

set_prop_cycle(cycler)
set_prop_cycle(label=values, label2=values2, ...)
set_prop_cycle(label, values)

Форма 1 задаёт указанный объект Cycler.

Форма 2 создаёт объект Cycler, который одновременно перебирает значения одного или нескольких свойств, и задаёт его в качестве цикла свойств объекта Axes. Если указано несколько свойств, списки их значений должны иметь одинаковую длину. Это всего лишь сокращённая запись для явного создания cycler и передачи его функции, то есть эквивалент set_prop_cycle(cycler(label=values, label2=values2, ...)).

Форма 3 создаёт объект Cycler для одного свойства и задаёт его в качестве цикла свойств объекта Axes. Эта форма сохранена для совместимости с исходным интерфейсом cycler.cycler. Её использование не рекомендуется; предпочтительна форма с именованными аргументами, то есть set_prop_cycle(label=values).

Параметры:

cyclerCycler или None

Задать указанный 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