matplotlib.artist.setp

matplotlib.artist.setp(obj, *args, file=None, **kwargs)[source]

Устанавливает одно или несколько свойств для Artist, или список допустимых значений.

Параметры:

objArtist или список Artist

Объект(ы) художника, чьи свойства нужно установить или запросить. При установке свойств затрагиваются все объекты; при запросе допустимых значений запрашивается только первый экземпляр в последовательности.

Например, две линии можно сделать толще и красного цвета одним вызовом:

>>> x = arange(0, 1, 0.01)
>>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x))
>>> setp(lines, linewidth=2, color='r')

fileобъект-поток, по умолчанию: sys.stdout

Куда setp записывает свой вывод, когда его просят вывести допустимые значения.

>>> with open('output.log') as file:
...     setp(line, file=file)

По умолчанию, None, это sys.stdout.

*args, **kwargs

Свойства для установки. Поддерживаются следующие комбинации:

• Установить стиль линии для линии пунктирным:

  >>> line, = plot([1, 2, 3])
  >>> setp(line, linestyle='--')
  

• Установить несколько свойств сразу:

  >>> setp(line, linewidth=2, color='r')
  

• Вывести допустимые значения для стиля линии:

  >>> setp(line, 'linestyle')
  linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
  

• Вывести все свойства, которые можно установить, и их допустимые значения:

  >>> setp(line)
  agg_filter: a filter function, ...
  [long output listing omitted]
  

setp также поддерживает пары «строка/значение» в стиле MATLAB. Например, следующие варианты эквивалентны:

>>> setp(lines, 'linewidth', 2, 'color', 'r')  # MATLAB style
>>> setp(lines, linewidth=2, color='r')        # Python style

См. также

getp