backend_pdf

Un backend PDF Matplotlib.

Autor: Jouni K Seppänen < jks @ iki . fi > y otros.

matplotlib.backends.backend_pdf. FigureCanvas

alias deFigureCanvasPdf

clase matplotlib.backends.backend_pdf. FigureCanvasPdf ( figura = Ninguno )

Bases:FigureCanvasBase

dibujar ( )

Renderizar el Figure.

Este método debe recorrer el árbol del artista, incluso si no se produce ningún resultado, ya que activa el trabajo diferido al que los usuarios pueden querer acceder antes de guardar el resultado en el disco. Por ejemplo, calcular límites, límites automáticos y valores de marca.

tipos de archivo = {'pdf': ' Formato de documento portátil'}

fijo_ppp = 72

get_default_filetype ( )

Devuelve el formato de archivo savefig predeterminado como se especifica en rcParams["savefig.format"](predeterminado: 'png').

La cadena devuelta no incluye un punto. Este método se anula en los backends que solo admiten un único tipo de archivo.

print_pdf ( nombre de archivo , * , bbox_inches_restore = Ninguno , metadatos = Ninguno )

clase matplotlib.backends.backend_pdf. GraphicsContextPdf ( archivo )

Bases:GraphicsContextBase

alpha_cmd ( alfa , forzado , eficaz_alfas )

capstyle_cmd ( estilo )

capstyles = {'trasero': 0, 'proyectando': 2, 'redondo': 1}

clip_cmd ( cliprect , clippath )

Establecer rectángulo de recorte. Llamadas pop()y push().

comandos = ((('_cliprect', '_clippath'), <función GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effect_alphas'), <función GraphicsContextPdf.alpha_cmd>), (('_capstyle' ,), <función GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <función GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <función GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',) , <función GraphicsContextPdf.linewidth_cmd>), (('_guiones',), <función GraphicsContextPdf.dash_cmd>), (('_rgb',), <función GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <función GraphicsContextPdf.hatch_cmd>))

copy_properties ( otro )

Copiar propiedades de otros en uno mismo.

dash_cmd ( guiones )

delta ( otro )

Copie las propiedades de otro en uno mismo y devuelva los comandos PDF necesarios para transformarse en otro.

llenar ( * argumentos )

Predicado: ¿es necesario llenar el camino?

Se puede usar un argumento opcional para especificar un _fillcolor alternativo, según lo necesite RendererPdf.draw_markers.

fillcolor_cmd ( rgb )

finalizar ( )

Asegúrese de que todos los estados de gráficos empujados aparezcan.

hatch_cmd ( escotilla , hatch_color )

joinstyle_cmd ( estilo )

joinstyles = {'bisel': 2, 'inglete': 0, 'redondo': 1}

linewidth_cmd ( ancho )

pintura ( )

Devuelva el operador de pdf apropiado para hacer que la ruta se trace, rellene o ambas cosas.

pop ( )

empujar ( )

rgb_cmd ( rgb )

trazo ( )

Predicado: ¿es necesario trazar el camino (dibujar su contorno)? Esto prueba las diversas condiciones que inhabilitan el recorrido del camino, en cuyo caso, presumiblemente, estaría lleno.

clase matplotlib.backends.backend_pdf. Nombre ( nombre )

Bases:object

Objeto de nombre de PDF.

hexify estático ( coincidencia )

[ Obsoleto ]

notas

En desuso desde la versión 3.6:

nombre

pdfRepr ( )

clase matplotlib.backends.backend_pdf. Op ( valor )

Bases:Enum

Operadores de PDF (no es una lista exhaustiva).

begin_text = b'BT'

clip = b'W'

close_fill_stroke = b'b'

close_stroke = b's'

closepath = b'h'

concat_matrix = b'cm'

curveto = b'c'

end_text = b'ET'

endpath = b'n'

relleno = b'f'

fill_stroke = b'B'

grestore = b'Q'

gsave = b'q'

lineto = b'l '

moveto = b'm'

propiedad op

classmethod paint_path ( relleno , trazo )

Devuelve el operador de PDF para pintar una ruta.

Parámetros :

llenar bool

Rellena el camino con el color de relleno.

trazo bool

Traza el contorno del camino con el color de la línea.

pdfRepr ( )

rectángulo = b're'

seleccionar fuente = b'Tf '

setcolor_nonstroke = b'scn'

setcolor_stroke = b'SCN'

setcolorspace_nonstroke = b'cs'

setcolorspace_stroke = b'CS'

setdash = b'd'

setgray_nonstroke = b'g'

setgray_stroke = b'G'

setgstate = b'gs'

setlinecap = b'J'

setlinejoin = b'j'

setlinewidth = b'w'

setrgb_nonstroke = b'rg'

setrgb_stroke = b'RG'

sombreado = b'sh'

mostrar = b'Tj'

showkern = b'TJ'

trazo = b'S'

matriz de texto = b'Tm '

textpos = b'Td'

use_xobject = b'Do'

clase matplotlib.backends.backend_pdf. Operador ( op )

Bases:object

[ Obsoleto ]

notas

En desuso desde la versión 3.6:

de operación

pdfRepr ( )

clase matplotlib.backends.backend_pdf. PdfFile ( nombre de archivo , metadatos = Ninguno )

Bases:object

Objeto de archivo PDF.

Parámetros :

nombre de archivo str o similar a una ruta o similar a un archivo

Destino de salida; si es una cadena, se abrirá un archivo para escritura.

dictado de metadatos de cadenas a cadenas y fechas

Objeto de diccionario de información (consulte la sección de referencia de PDF 10.2.1 'Diccionario de información del documento'), por ejemplo: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Las claves estándar son 'Título', 'Autor', 'Asunto', 'Palabras clave', 'Creador', 'Productor', 'Fecha de creación', 'Fecha de modificación' y 'Atrapado'. Se han predefinido valores para 'Creador', 'Productor' y 'CreationDate'. Se pueden eliminar configurándolos en None.

addGouraudTriangles ( puntos , colores )

Agregue un sombreado triangular de Gouraud.

Parámetros :

puntos np.ndarray

Vértices de triángulo, forma (n, 3, 2) donde n = número de triángulos, 3 = vértices, 2 = x, y.

colores np.ndarray

Colores de vértice, forma (n, 3, 1) o (n, 3, 4) como con los puntos, pero la última dimensión es (gris) o (r, g, b, alfa).

Devoluciones :

Nombre, Referencia

estado alfa ( alfa )

Devuelve el nombre de un ExtGState que establece alfa en el valor dado.

beginStream ( id , len , extra = Ninguno , png = Ninguno )

cerrar ( )

Vacíe todos los búferes y libere todos los recursos.

createType1Descriptor ( t1font , fontfile )

dviFontName ( dvifont )

Dado un objeto de fuente dvi, devuelva un nombre adecuado para Op.selectfont. Esto registra la información de la fuente self.dviFontInfosi aún no está registrada.

incrustarTTF ( nombre de archivo , caracteres )

Incruste la fuente TTF del archivo mencionado en el documento.

endStream ( )

finalizar ( )

Escriba los diversos objetos diferidos y el asunto final del pdf.

fontName ( fontprop )

Seleccione una fuente basada en fontprop y devuelva un nombre adecuado para Op.selectfont. Si fontprop es una cadena, se interpretará como el nombre de archivo de la fuente.

hatchPattern ( hatch_style )

imageObject ( imagen )

Devuelve el nombre de una imagen XObject que representa la imagen dada.

markerObject ( ruta , trans , relleno , trazo , lw , joinstyle , capstyle )

Devuelve el nombre de un marcador XObject que representa la ruta dada.

newPage ( ancho , alto )

newTextnote ( texto , positionRect = [-100, -100, 0, 0] )

salida ( * datos )

outputStream ( ref , datos , * , extra = Ninguno )

pathCollectionObject ( gc , ruta , trans , relleno , relleno , trazo )

static pathOperations ( ruta , transformar , recortar = Ninguno , simplificar = Ninguno , boceto = Ninguno )

recordXref ( id )

reserveObject ( nombre = '' )

Reserve un ID para un objeto indirecto.

El nombre se usa para la depuración en caso de que olvidemos imprimir el objeto con writeObject.

escribir ( datos )

writeExtGSTates ( )

escribirFuentes ( )

escribirGouraudTriangles ( )

writeHatches ( )

escribirImagenes ( )

escribirInfoDict ( )

Escriba el diccionario de información, comprobando que esté en buen estado

escribirMarcadores ( )

writeObject ( objeto , contenido )

writePath ( ruta , transformación , clip = Falso , boceto = Ninguno )

writePathCollectionTemplates ( )

escribirTrailer ( )

Escribe el tráiler en PDF.

escribirrefX ( )

Escriba la tabla de referencias externas.

clase matplotlib.backends.backend_pdf. PdfPages ( nombre de archivo , keep_empty = True , metadatos = Ninguno )

Bases:object

Un archivo PDF de varias páginas.

notas

En realidad, PdfPageses un envoltorio delgado PdfFilepara evitar confusiones al usar savefigy olvidar el argumento de formato.

Ejemplos

>>> 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()

Cree un nuevo objeto PdfPages.

Parámetros :

nombre de archivo str o similar a una ruta o similar a un archivo

Los gráficos que utilicen PdfPages.savefigse escribirán en un archivo en esta ubicación. El archivo se abre de inmediato y se sobrescribe cualquier archivo anterior con el mismo nombre.

keep_empty booleano , opcional

Si se establece en Falso, los archivos PDF vacíos se eliminarán automáticamente cuando se cierren.

dictado de metadatos , opcional

Objeto de diccionario de información (consulte la sección de referencia de PDF 10.2.1 'Diccionario de información del documento'), por ejemplo: .{'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}

Las claves estándar son 'Título', 'Autor', 'Asunto', 'Palabras clave', 'Creador', 'Productor', 'Fecha de creación', 'Fecha de modificación' y 'Atrapado'. Se han predefinido valores para 'Creador', 'Productor' y 'CreationDate'. Se pueden eliminar configurándolos en None.

adjuntar_nota ( texto , posiciónRect = [-100, -100, 0, 0] )

Agregue una nueva nota de texto a la página que se guardará a continuación. El positionRect opcional especifica la posición de la nueva nota en la página. Está fuera de la página por defecto para asegurarse de que sea invisible en las impresiones.

cerrar ( )

Finalice este objeto, convirtiendo el archivo subyacente en un archivo PDF completo.

get_pagecount ( )

Devuelve el número actual de páginas en el archivo pdf de varias páginas.

infodict ( )

Devuelve un objeto de diccionario de información modificable (consulte la sección de referencia de PDF 10.2.1 'Diccionario de información del documento').

mantener_vacío

savefig ( figura = Ninguno , ** kwargs )

Guarde un Figureen este archivo como una página nueva.

Cualquier otro argumento de palabra clave se pasa a savefig.

Parámetros :

figura Figureo int, por defecto: la figura activa

La figura, o el índice de la figura, que se guarda en el archivo.

clase matplotlib.backends.backend_pdf. Referencia ( id )

Bases:object

Objeto de referencia PDF.

Utilice PdfFile.reserveObject() para crear referencias.

pdfRepr ( )

escribir ( contenido , archivo )

clase matplotlib.backends.backend_pdf. RendererPdf ( archivo , image_dpi , alto , ancho )

Bases:RendererPDFPSBase

check_gc ( gc , color de relleno = Ninguno )

draw_gouraud_triangle ( gc , puntos , colores , trans )

Dibuja un triángulo sombreado de Gouraud.

Parámetros :

gcGraphicsContextBase

El contexto gráfico.

puntos (3, 2) en forma de matriz

Matriz de (x, y) puntos para el triángulo.

colores (3, 4) en forma de matriz

Colores RGBA para cada punto del triángulo.

transformarmatplotlib.transforms.Transform

Una transformación afín para aplicar a los puntos.

draw_gouraud_triangles ( gc , puntos , colores , trans )

Dibuja una serie de triángulos de Gouraud.

Parámetros :

puntos (N, 3, 2) en forma de matriz

Matriz de N (x, y) puntos para los triángulos.

colores (N, 3, 4) en forma de matriz

Matriz de N colores RGBA para cada punto de los triángulos.

transformarmatplotlib.transforms.Transform

Una transformación afín para aplicar a los puntos.

draw_image ( gc , x , y , im , transform = None )

Dibujar una imagen RGBA.

Parámetros :

gcGraphicsContextBase

Un contexto gráfico con información de recorte.

x escalar

La distancia en unidades físicas (es decir, puntos o píxeles) desde el lado izquierdo del lienzo.

y escalar

La distancia en unidades físicas (es decir, puntos o píxeles) desde la parte inferior del lienzo.

im (N, M, 4) como una matriz de np.uint8

Una matriz de píxeles RGBA.

transformarmatplotlib.transforms.Affine2DBase

Si y solo si el backend concreto se escribe de tal forma que option_scale_imagedevuelve , se puede pasar Trueuna transformación afín (es decir, an Affine2DBase) a . El vector de traducción de la transformación se da en unidades físicas (es decir, puntos o píxeles). Tenga en cuenta que la transformación no anula x e y , y debe aplicarse antes de traducir el resultado por x e y (esto se puede lograr agregando x e y al vector de traducción definido por transform ).draw_image

dibujar_marcadores ( gc , marcador_ruta , marcador_trans , ruta , trans , rgbFace = Ninguno )

Dibuja un marcador en cada uno de los vértices de la ruta (excluyendo los puntos de control).

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular este método para dibujar el marcador solo una vez y reutilizarlo varias veces.

Parámetros :

gcGraphicsContextBase

El contexto gráfico.

marcador_transmatplotlib.transforms.Transform

Una transformación afín aplicada al marcador.

transmatplotlib.transforms.Transform

Una transformación afín aplicada a la ruta.

draw_mathtext ( gc , x , y , s , prop , angle )

dibujar_ruta ( gc , ruta , transformar , rgbFace = Ninguno )

Dibuja una Pathinstancia usando la transformación afín dada.

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiased , urls , offset_position )

Dibuja una colección de caminos .

Cada ruta se transforma primero por la entrada correspondiente en all_transforms (una lista de (3, 3) matrices) y luego por master_transform . Luego se traducen por la entrada correspondiente en compensaciones , que primero ha sido transformada por compensaciones_trans .

facecolors , edgecolors , linewidths , linestyles y antialiased son listas que establecen las propiedades correspondientes.

offset_position no se usa ahora, pero el argumento se mantiene por compatibilidad con versiones anteriores.

La implementación base (alternativa) realiza varias llamadas a draw_path. Es posible que los backends deseen anular esto para representar cada conjunto de datos de ruta solo una vez y luego hacer referencia a esa ruta varias veces con los diferentes desplazamientos, colores, estilos, etc. Los métodos del generador _iter_collection_raw_pathsse _iter_collectionproporcionan para ayudar con (y estandarizar) la implementación a través de backends. Se recomienda encarecidamente usar esos generadores, para que los cambios en el comportamiento draw_path_collectionse puedan realizar globalmente.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = Ninguno )

dibujar_texto ( gc , x , y , s , prop , angle , ismath = False , mtext = None )

Dibuja una instancia de texto.

Parámetros :

gcGraphicsContextBase

El contexto gráfico.

x flotador

La ubicación x del texto en las coordenadas de visualización.

flotas _

La ubicación y de la línea de base del texto en las coordenadas de visualización.

calle s

La cadena de texto.

apuntalarmatplotlib.font_manager.FontProperties

Las propiedades de la fuente.

ángulo de flotación

El ángulo de rotación en grados en sentido contrario a las agujas del reloj.

textommatplotlib.text.Text

El objeto de texto original que se representará.

notas

Nota para los implementadores de back-end:

Cuando intenta determinar si ha acertado con el cuadro delimitador (que es lo que permite que el diseño/alineación del texto funcione correctamente), es útil cambiar la línea en text.py:

if 0: bbox_artist(self, renderer)

a si 1, y luego el cuadro delimitador real se trazará junto con su texto.

encode_string ( s , tipo de fuente )

finalizar ( )

get_image_magnification ( )

Obtener el factor por el cual ampliar las imágenes pasadas a draw_image. Permite que un backend tenga imágenes a una resolución diferente a la de otros artistas.

new_gc ( )

Devolver una instancia de un GraphicsContextBase.

clase matplotlib.backends.backend_pdf. Stream ( id , len , archivo , extra = Ninguno , png = Ninguno )

Bases:object

Objeto de flujo de PDF.

Esto no tiene método pdfRepr. En su lugar, llame a begin(), luego envíe el contenido de la secuencia llamando a write() y finalmente llame a end().

Parámetros :

identificación interna

Id. de objeto de la transmisión.

len Referencia o Ninguno

Un objeto de referencia no utilizado para la longitud de la secuencia; Ninguno significa usar un búfer de memoria para que la longitud se pueda alinear.

archivo PdfArchivo

El objeto subyacente en el que escribir la transmisión.

dictado adicional de Nombre a cualquier cosa, o Ninguno

Pares clave-valor adicionales para incluir en el encabezado de flujo.

png dictado o Ninguno

Si los datos ya están codificados en png, los parámetros de decodificación.

comprimirobj

fin ( )

Finalizar transmisión.

adicional

archivo

de identificación

len

archivo pdf

posición

escribir ( datos )

Escriba algunos datos en la corriente.

clase matplotlib.backends.backend_pdf. Verbatim ( x )

Bases:object

Almacene el contenido de los comandos PDF palabra por palabra para su posterior inclusión en la transmisión.

pdfRepr ( )

matplotlib.backends.backend_pdf. llenar ( cadenas , linelen = 75 )

[ Obsoleto ]

notas

En desuso desde la versión 3.6: use una copia de proveedor de _fill en su lugar.

matplotlib.backends.backend_pdf. pdfRepr ( obj )

Asigne objetos de Python a la sintaxis de PDF.