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