matplotlib.artist.setp

matplotlib.artist.setp(obj, *args, **kwargs)

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

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

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

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

>>> setp(line, 'linestyle')
    linestyle: [ '-' | '--' | '-.' | ':' | 'steps' | 'None' ]

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

>>> 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,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