matplotlib.artist.setp #

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

Defina uma ou mais propriedades em um Artistou liste os valores permitidos.

Parâmetros :
obj Artistou lista deArtist

O(s) artista(s) cujas propriedades estão sendo definidas ou consultadas. Ao definir as propriedades, todos os artistas são afetados; ao consultar os valores permitidos, apenas a primeira instância da sequência é consultada.

Por exemplo, duas linhas podem ficar mais grossas e vermelhas com uma única chamada:

>>> x = arange(0, 1, 0.01)
>>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x))
>>> setp(lines, linewidth=2, color='r')
arquivo semelhante a um arquivo, padrão:sys.stdout

Where setpgrava sua saída quando solicitado a listar os valores permitidos.

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

O padrão, None, significa sys.stdout.

*args, **kwargs

As propriedades a serem definidas. As seguintes combinações são suportadas:

  • Defina o estilo de linha de uma linha a ser tracejada:

    >>> line, = plot([1, 2, 3])
    >>> setp(line, linestyle='--')
    
  • Defina várias propriedades de uma só vez:

    >>> setp(line, linewidth=2, color='r')
    
  • Liste os valores permitidos para o estilo de linha de uma linha:

    >>> setp(line, 'linestyle')
    linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
    
  • Liste todas as propriedades que podem ser definidas e seus valores permitidos:

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

setptambém suporta pares string/valor no estilo MATLAB. Por exemplo, os seguintes são equivalentes:

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

Veja também

getp