matplotlib.animación.Animación #

clase matplotlib.animación. Animación ( fig , event_source = None , blit = False ) [fuente] #

Una clase base para animaciones.

Esta clase no se puede usar tal como está y debe subclasificarse para proporcionar el comportamiento necesario.

Nota

Debe almacenar la Animación creada en una variable que viva mientras la animación deba ejecutarse. De lo contrario, el objeto Animation se recolectará como basura y la animación se detendrá.

Parámetros :

higoFigure

El objeto de figura se utiliza para obtener los eventos necesarios, como dibujar o cambiar el tamaño.

objeto event_source , opcional

Una clase que puede ejecutar una devolución de llamada cuando se generan los eventos deseados, así como detenerse e iniciarse.

Los ejemplos incluyen temporizadores (consulte TimedAnimation) y notificaciones del sistema de archivos.

blit bool, predeterminado: Falso

Si se usa blitting para optimizar el dibujo.

Ver también

FuncAnimation,ArtistAnimation

__init__ ( fig , event_source = Ninguno , blit = Falso ) [fuente] #

Métodos

`__init__`(higo[, origen_del_evento, blit])
`new_frame_seq`()	Devuelve una nueva secuencia de información de cuadro.
`new_saved_frame_seq`()	Devuelve una nueva secuencia de información de fotogramas guardados/almacenados.
`pause`()	Pausa la animación.
`resume`()	Reanuda la animación.
`save`(nombre de archivo [, escritor, fps, dpi, códec, ...])	Guarde la animación como un archivo de película dibujando cada cuadro.
`to_html5_video`([incrustar_límite])	Convierta la animación en una etiqueta HTML5 `<video>`.
`to_jshtml`([fps, incrustar_fotogramas, modo_predeterminado])	Genere una representación HTML de la animación.

new_frame_seq ( ) [fuente] #: Devuelve una nueva secuencia de información de cuadro.

new_saved_frame_seq ( ) [fuente] #: Devuelve una nueva secuencia de información de fotogramas guardados/almacenados.

pausa ( ) [fuente] #: Pausa la animación.

currículum ( ) [fuente] #: Reanuda la animación.

guardar ( nombre de archivo , escritor = Ninguno , fps = Ninguno , dpi = Ninguno , códec = Ninguno , tasa de bits = Ninguno , extra_args = Ninguno , metadatos = Ninguno , extra_anim = Ninguno , savefig_kwargs = Ninguno , * , Progress_callback = Ninguno ) [fuente] #

Guarde la animación como un archivo de película dibujando cada cuadro.

Parámetros :

nombre de archivo str

El nombre del archivo de salida, por ejemplo, mymovie.mp4.

escritor MovieWritero cadena, predeterminado: rcParams["animation.writer"](predeterminado: 'ffmpeg')

Una MovieWriterinstancia para usar o una clave que identifica una clase para usar, como 'ffmpeg'.

fps int, opcional

Velocidad de fotogramas de la película (por segundo). Si no se establece, la velocidad de fotogramas del intervalo de fotogramas de la animación.

dpi flotante, predeterminado: rcParams["savefig.dpi"](predeterminado: 'figure')

Controla los puntos por pulgada de los fotogramas de la película. Junto con el tamaño de la figura en pulgadas, esto controla el tamaño de la película.

códec str, predeterminado: rcParams["animation.codec"](predeterminado: 'h264').

El códec de video a usar. No todos los códecs son compatibles con un determinado MovieWriter.

bitrate int, predeterminado: rcParams["animation.bitrate"](predeterminado: -1)

La tasa de bits de la película, en kilobits por segundo. Los valores más altos significan películas de mayor calidad, pero aumentan el tamaño del archivo. Un valor de -1 permite que el codificador de películas subyacente seleccione la tasa de bits.

lista extra_args de str o None, opcional

Argumentos adicionales de la línea de comandos que se pasan al codificador de películas subyacente. El valor predeterminado, Ninguno, significa usar rcParams["animation.[name-of-encoder]_args"]para los escritores incorporados.

dictado de metadatos [str, str], predeterminado: {}

Diccionario de claves y valores de metadatos para incluir en el archivo de salida. Algunas claves que pueden ser de utilidad incluyen: título, artista, género, tema, derechos de autor, srcform, comentario.

lista extra_anim , por defecto: []

Objetos adicionales Animationque deben incluirse en el archivo de película guardado. Estos deben ser de la misma matplotlib.figure.Figureinstancia. Además, los cuadros de animación simplemente se combinarán, por lo que debe haber una correspondencia 1:1 entre los cuadros de las diferentes animaciones.

dictado savefig_kwargs , predeterminado: {}

Argumentos de palabras clave pasados a cada savefigllamada utilizada para guardar los marcos individuales.

función de devolución de llamada de progreso , opcional

Una función de devolución de llamada que se llamará para cada cuadro para notificar el progreso de guardado. Debe tener la firma

def func(current_frame: int, total_frames: int) -> Any

donde cuadro_actual es el número de cuadro actual y cuadro_total es el número total de cuadros que se guardarán. total_frames se establece en Ninguno, si no se puede determinar el número total de fotogramas. Los valores devueltos pueden existir pero se ignoran.

Código de ejemplo para escribir el progreso en stdout:

progress_callback =                    lambda i, n: print(f'Saving frame {i} of {n}')

notas

fps , codec , bitrate , extra_args y metadatos se usan para construir una MovieWriterinstancia y solo se pueden pasar si el escritor es una cadena. Si se pasan como no - Ninguno y el escritor es un MovieWriter, RuntimeErrorse generará un.

to_html5_video ( embed_limit = Ninguno ) [fuente] #

Convierta la animación en una etiqueta HTML5 <video>.

Esto guarda la animación como un video h264, codificado en base64 directamente en la etiqueta de video HTML5. Esto respeta rcParams["animation.writer"](predeterminado: 'ffmpeg') y rcParams["animation.bitrate"](predeterminado: -1). Esto también hace uso de intervalpara controlar la velocidad y usa el repeat parámetro para decidir si hacer un bucle.

Parámetros :

embed_limit flotante, opcional: Límite, en MB, de la animación devuelta. No se crea ninguna animación si se supera el límite. El valor predeterminado es rcParams["animation.embed_limit"](predeterminado: 20.0) = 20.0.

Devoluciones :

calle: Una etiqueta de video HTML5 con la animación incrustada como video h264 codificado en base64. Si se excede el embed_limit , esto devuelve la cadena "Video demasiado grande para incrustar".

to_jshtml ( fps = Ninguno , embed_frames = True , default_mode = Ninguno ) [fuente] #

Genere una representación HTML de la animación.

Parámetros :

fps int, opcional: Velocidad de fotogramas de la película (por segundo). Si no se establece, la velocidad de fotogramas del intervalo de fotogramas de la animación.
embed_frames booleano , opcional
default_mode str, opcional: Qué hacer cuando termina la animación. Debe ser uno de . El valor predeterminado es si es verdadero, de lo contrario .{'loop', 'once', 'reflect'}'loop'self.repeat'once'