matplotlib.artist.setp#

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

Setzt eine oder mehrere Eigenschaften eines Artist oder listet zulässige Werte auf.

Parameter:
objArtist oder Liste von Artist

Der/die Künstler, deren Eigenschaften gesetzt oder abgefragt werden. Beim Setzen von Eigenschaften werden alle Künstler beeinflusst; beim Abfragen der zulässigen Werte wird nur die erste Instanz in der Sequenz abgefragt.

Zwei Linien können beispielsweise mit einem einzigen Aufruf dicker und rot gemacht werden

>>> x = arange(0, 1, 0.01)
>>> lines = plot(x, sin(2*pi*x), x, sin(4*pi*x))
>>> setp(lines, linewidth=2, color='r')
fileDatei-ähnlich, Standard: sys.stdout

Wo setp seine Ausgabe schreibt, wenn aufgefordert wird, zulässige Werte aufzulisten.

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

Der Standardwert None bedeutet sys.stdout.

*args, **kwargs

Die zu setzenden Eigenschaften. Die folgenden Kombinationen werden unterstützt

  • Setzt den Linienstil einer Linie auf gestrichelt

    >>> line, = plot([1, 2, 3])
    >>> setp(line, linestyle='--')
    
  • Setzt mehrere Eigenschaften gleichzeitig

    >>> setp(line, linewidth=2, color='r')
    
  • Listet zulässige Werte für den Linienstil einer Linie auf

    >>> setp(line, 'linestyle')
    linestyle: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
    
  • Listet alle Eigenschaften auf, die gesetzt werden können, und ihre zulässigen Werte

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

setp unterstützt auch Zeichenketten/Wert-Paare im MATLAB-Stil. Zum Beispiel sind die folgenden äquivalent

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

Siehe auch

getp