`matplotlib.backends.backend_pgf`#

matplotlib.backends.backend_pgf.FigureCanvas[Quelle]#: alias von FigureCanvasPgf

class matplotlib.backends.backend_pgf.FigureCanvasPgf(figure=None)[Quelle]#

Bases: FigureCanvasBase

Rendert die Figure.

Diese Methode muss den Künstlerbaum durchlaufen, auch wenn keine Ausgabe erzeugt wird, da sie verzögerte Arbeiten auslöst, auf die Benutzer möglicherweise zugreifen möchten, bevor sie Ausgabe auf die Festplatte speichern. Zum Beispiel die Berechnung von Grenzen, automatischen Grenzen und Tick-Werten.

filetypes = {'pdf': 'LaTeX kompilierte PGF Grafik', 'pgf': 'LaTeX PGF Grafik', 'png': 'Portable Network Graphics'}#

get_default_filetype()[Quelle]#

Gibt das Standardformat für die Speicherabbildung zurück, wie in rcParams["savefig.format"] (Standard: 'png') angegeben.

Der zurückgegebene String enthält keinen Punkt. Diese Methode wird in Backends überschrieben, die nur einen Dateityp unterstützen.

get_renderer()[Quelle]#

print_pdf(fname_or_fh, *, metadata=None, **kwargs)[Quelle]#: Verwendet LaTeX, um eine pgf-generierte Grafik zu PDF zu kompilieren.

print_pgf(fname_or_fh, **kwargs)[Quelle]#: Gibt pgf-Makros zum Zeichnen der Grafik aus, sodass sie in LaTeX-Dokumente eingefügt und gerendert werden kann.

print_png(fname_or_fh, **kwargs)[Quelle]#: Verwendet LaTeX, um eine pgf-Grafik zu PDF zu kompilieren und sie in PNG zu konvertieren.

exception matplotlib.backends.backend_pgf.LatexError(message, latex_output='')[Quelle]#: Bases: Exception

class matplotlib.backends.backend_pgf.LatexManager[Quelle]#

Bases: object

Der LatexManager öffnet eine Instanz der LaTeX-Anwendung zur Bestimmung der Metriken von Textelementen. Die LaTeX-Umgebung kann durch Setzen von Schriftarten und/oder einer benutzerdefinierten Präambel in rcParams modifiziert werden.

get_width_height_descent(text, prop)[Quelle]#: Ermittelt die Breite, Gesamthöhe und den Abstieg (in TeX-Punkten) für einen Text, der von der aktuellen LaTeX-Umgebung gesetzt wird.

class matplotlib.backends.backend_pgf.PdfPages(filename, *, metadata=None)[Quelle]#

Bases: object

Eine mehrseitige PDF-Datei, die das pgf-Backend verwendet

Beispiele

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

Erstellt ein neues PdfPages-Objekt.

Parameter:

filenamestr oder pfadähnlich

Grafiken, die mit PdfPages.savefig gespeichert werden, werden in eine Datei an diesem Ort geschrieben. Eine ältere Datei mit demselben Namen wird überschrieben.

metadatadict, optional

Informations-Dictionary-Objekt (siehe PDF-Referenz Abschnitt 10.2.1 'Document Information Dictionary'), z. B.: {'Creator': 'Meine Software', 'Author': 'Ich', 'Title': 'Großartig'}.

Die Standard-Schlüssel sind 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' und 'Trapped'. Für 'Creator', 'Producer' und 'CreationDate' wurden vordefinierte Werte festgelegt. Sie können entfernt werden, indem sie auf None gesetzt werden.

Beachten Sie, dass einige Versionen von LaTeX-Engines den Schlüssel 'Producer' ignorieren und stattdessen sich selbst festlegen können.

close()[Quelle]#: Finalisiert dieses Objekt, führt LaTeX in einem temporären Verzeichnis aus und verschiebt die endgültige PDF-Datei nach filename.

get_pagecount()[Quelle]#: Gibt die aktuelle Seitenzahl in der mehrseitigen PDF-Datei zurück.

savefig(figure=None, **kwargs)[Quelle]#

Speichert eine Figure als neue Seite in diese Datei.

Alle anderen Schlüsselwortargumente werden an savefig weitergeleitet.

Parameter:

figureFigure oder int, Standard: die aktive Grafik: Die Grafik oder der Index der Grafik, die bzw. der in die Datei gespeichert wird.

class matplotlib.backends.backend_pgf.RendererPgf(figure, fh)[Quelle]#

Bases: RendererBase

Erstellt einen neuen PGF-Renderer, der jede Zeichenanweisung in Textbefehle übersetzt, die in einer LaTeX-pgfpicture-Umgebung interpretiert werden können.

Attribute:

figureFigure: Matplotlib-Grafik, von der Höhe, Breite und DPI initialisiert werden.
fhdateiähnlich: Dateihandle für die Ausgabe der Zeichenbefehle.

draw_image(gc, x, y, im, transform=None)[Quelle]#

Zeichnet ein RGBA-Bild.

Parameter:

gcGraphicsContextBase: Ein Grafikkontext mit Clipping-Informationen.
xfloat: Der Abstand in physikalischen Einheiten (d. h. Punkten oder Pixeln) vom linken Rand der Zeichenfläche.
yfloat: Der Abstand in physikalischen Einheiten (d. h. Punkten oder Pixeln) vom unteren Rand der Zeichenfläche.
im(N, M, 4) Array von numpy.uint8: Ein Array von RGBA-Pixeln.
transformAffine2DBase: Wenn und nur wenn das konkrete Backend so geschrieben ist, dass option_scale_image True zurückgibt, *kann* eine affine Transformation (d. h. ein Affine2DBase) an draw_image übergeben werden. Der Translationsvektor der Transformation ist in physikalischen Einheiten (d. h. Punkten oder Pixeln) angegeben. Beachten Sie, dass die Transformation x und y nicht überschreibt und *vor* dem Übersetzen des Ergebnisses um x und y angewendet werden muss (dies kann durch Addition von x und y zum Translationsvektor erreicht werden, der durch transform definiert ist).

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[Quelle]#

Zeichnet eine Markierung an jeder der path-Scheitelpunkte (außer Kontrollpunkte).

Die Basis-(Fallback-)Implementierung führt mehrere Aufrufe von draw_path durch. Backends möchten diese Methode möglicherweise überschreiben, um den Marker nur einmal zu zeichnen und ihn mehrmals wiederzuverwenden.

Parameter:

gcGraphicsContextBase: Der Grafikkontext.
marker_pathPath: Der Pfad für die Markierung.
marker_transTransform: Eine affine Transformation, die auf die Markierung angewendet wird.
pathPath: Die Orte, an denen die Markierungen gezeichnet werden sollen.
transTransform: Eine affine Transformation, die auf den Pfad angewendet wird.
rgbFacecolor, optional

draw_path(gc, path, transform, rgbFace=None)[Quelle]#: Zeichnet eine Path-Instanz mit der gegebenen affinen Transformation.

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[Quelle]#

Zeichnet eine TeX-Instanz.

Parameter:

gcGraphicsContextBase: Der Grafikkontext.
xfloat: Die x-Koordinate des Textes in Anzeigekoordinaten.
yfloat: Die y-Koordinate der Textbasislinie in Anzeigekoordinaten.
sstr: Der TeX-Textstring.
propFontProperties: Die Schrifteigenschaften.
anglefloat: Der Rotationswinkel in Grad gegen den Uhrzeigersinn.
mtextText: Das ursprüngliche Textobjekt, das gerendert werden soll.

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[Quelle]#

Zeichnet eine Textinstanz.

Parameter:

gcGraphicsContextBase: Der Grafikkontext.
xfloat: Die x-Koordinate des Textes in Anzeigekoordinaten.
yfloat: Die y-Koordinate der Textbasislinie in Anzeigekoordinaten.
sstr: Der Textstring.
propFontProperties: Die Schrifteigenschaften.
anglefloat: Der Rotationswinkel in Grad gegen den Uhrzeigersinn.
ismathbool oder "TeX": Wenn True, verwende den mathtext-Parser.
mtextText: Das ursprüngliche Textobjekt, das gerendert werden soll.

Anmerkungen

Hinweise für Backend-Implementierer

RendererBase.draw_text unterstützt auch die Übergabe von "TeX" an den Parameter *ismath*, um TeX-Rendering zu verwenden, dies ist jedoch für tatsächliche Rendering-Backends nicht erforderlich, und viele integrierte Backends unterstützen dies nicht. Vielmehr wird TeX-Rendering von draw_tex bereitgestellt.

flipy()[Quelle]#

Gibt zurück, ob die y-Werte von oben nach unten zunehmen.

Beachten Sie, dass dies nur das Zeichnen von Texten beeinflusst.

get_canvas_width_height()[Quelle]#: Gibt die Breite und Höhe der Leinwand in Anzeigekoordinaten zurück.

get_text_width_height_descent(s, prop, ismath)[Quelle]#

Gibt die Breite, Höhe und den Abstieg (Offset von unten zur Basislinie) in Anzeigekoordinaten des Strings s mit FontProperties prop zurück.

Leerzeichen am Anfang und Ende von s sind in der gemeldeten Breite enthalten.

option_image_nocomposite()[Quelle]#

Gibt zurück, ob die Bildkomposition durch Matplotlib übersprungen werden soll.

Raster-Backends sollten normalerweise False zurückgeben (damit der C-Level-Rasterer die Bildkomposition übernimmt); Vektor-Backends sollten normalerweise not rcParams["image.composite_image"] zurückgeben.

option_scale_image()[Quelle]#: Gibt zurück, ob beliebige affine Transformationen in draw_image unterstützt werden (True für die meisten Vektor-Backends).

points_to_pixels(points)[Quelle]#

Konvertiert Punkte in Anzeigeeinheiten.

Sie müssen diese Funktion überschreiben (es sei denn, Ihr Backend hat keinen DPI-Wert, z. B. PostScript oder SVG). Einige Bildsysteme nehmen einen bestimmten Wert für Pixel pro Zoll an.

points to pixels = points * pixels_per_inch/72 * dpi/72

Parameter:

pointsfloat oder array-ähnlich

Gibt zurück:

Punkte, konvertiert in Pixel

matplotlib.backends.backend_pgf.make_pdf_to_png_converter()[Quelle]#: Gibt eine Funktion zurück, die eine PDF-Datei in eine PNG-Datei konvertiert.

matplotlib.backends.backend_pgf#

`matplotlib.backends.backend_pgf`#