matplotlib.artist.setp

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

Устанавливает свойство объекта художника.

matplotlib поддерживает использование setp() ("установить свойство") и getp() для установки и получения свойств объекта, а также для интроспекции объекта. Например, чтобы установить стиль линии для линии штриховой, можно сделать так:

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

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

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

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

>>> setp(line)
    ... long output listing omitted

По умолчанию setp выводит в sys.stdout, но это можно изменить, используя ключевой аргумент file:

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

setp() работает с одним экземпляром или итерируемым набором экземпляров. Если вы находитесь в режиме запроса, инспектируя возможные значения, используется только первый экземпляр в последовательности. При фактической установке значений будут установлены все экземпляры. Например, предположим, что у вас есть список из двух линий, следующее сделает обе линии толще и красными:

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

setp() работает с парами "строка/значение" в стиле MATLAB или с python kwargs. Например, следующие варианты эквивалентны:

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