matplotlib.animation.Animation #

classe matplotlib.animation. Animation ( fig , event_source = None , blit = False ) [source] #

Une classe de base pour les animations.

Cette classe n'est pas utilisable telle quelle et doit être sous-classée pour fournir le comportement nécessaire.

Noter

Vous devez stocker l'animation créée dans une variable qui vit aussi longtemps que l'animation doit s'exécuter. Sinon, l'objet Animation sera récupéré et l'animation s'arrêtera.

Paramètres :

figureFigure

L'objet figure utilisé pour obtenir les événements nécessaires, tels que dessiner ou redimensionner.

objet event_source , facultatif

Une classe qui peut exécuter un rappel lorsque les événements souhaités sont générés, ainsi qu'être arrêtée et démarrée.

Les exemples incluent les minuteries (voir TimedAnimation) et les notifications du système de fichiers.

blit booléen , par défaut : False

Si le blittage est utilisé pour optimiser le dessin.

Voir également

FuncAnimation,ArtistAnimation

__init__ ( fig , event_source = None , blit = False ) [source] #

Méthodes

`__init__`(fig[, event_source, blit])
`new_frame_seq`()	Renvoie une nouvelle séquence d'informations de trame.
`new_saved_frame_seq`()	Renvoie une nouvelle séquence d'informations de trame enregistrées / mises en cache.
`pause`()	Mettez l'animation en pause.
`resume`()	Reprenez l'animation.
`save`(nom de fichier[, écrivain, fps, dpi, codec, ...])	Enregistrez l'animation en tant que fichier vidéo en dessinant chaque image.
`to_html5_video`([embed_limit])	`<video>`Convertissez l'animation en balise HTML5 .
`to_jshtml`([fps, embed_frames, default_mode])	Générer une représentation HTML de l'animation.

new_frame_seq ( ) [source] #: Renvoie une nouvelle séquence d'informations de trame.

new_saved_frame_seq ( ) [source] #: Renvoie une nouvelle séquence d'informations de trame enregistrées / mises en cache.

pause ( ) [source] #: Mettez l'animation en pause.

reprendre ( ) [source] #: Reprenez l'animation.

save ( filename , writer = None , fps = None , dpi = None , codec = None , bitrate = None , extra_args = None , metadata = None , extra_anim = None , savefig_kwargs = None , * , progress_callback = None ) [source] #

Enregistrez l'animation en tant que fichier vidéo en dessinant chaque image.

Paramètres :

chaîne de nom de fichier

Le nom du fichier de sortie, par exemple, mymovie.mp4.

writer MovieWriterou str, par défaut : rcParams["animation.writer"](par défaut : 'ffmpeg')

Une MovieWriterinstance à utiliser ou une clé qui identifie une classe à utiliser, telle que 'ffmpeg'.

fps entier, facultatif

Fréquence d'images du film (par seconde). S'il n'est pas défini, la fréquence d'images de l'intervalle d'images de l'animation.

ppp flottant, par défaut : rcParams["savefig.dpi"](par défaut : 'figure')

Contrôle les points par pouce pour les images du film. Avec la taille de la figure en pouces, cela contrôle la taille du film.

codec str, par défaut : rcParams["animation.codec"](par défaut : 'h264').

Le codec vidéo à utiliser. Tous les codecs ne sont pas pris en charge par un fichier MovieWriter.

débit binaire entier, par défaut : rcParams["animation.bitrate"](par défaut : -1)

Le débit binaire du film, en kilobits par seconde. Des valeurs plus élevées signifient des films de meilleure qualité, mais augmentent la taille du fichier. Une valeur de -1 permet à l'encodeur vidéo sous-jacent de sélectionner le débit binaire.

extra_args liste de str ou None, facultatif

Arguments de ligne de commande supplémentaires passés à l'encodeur de film sous-jacent. La valeur par défaut, None, signifie à utiliser rcParams["animation.[name-of-encoder]_args"]pour les écrivains intégrés.

métadonnées dict[str, str], par défaut : {}

Dictionnaire des clés et des valeurs des métadonnées à inclure dans le fichier de sortie. Certaines clés pouvant être utiles incluent : titre, artiste, genre, sujet, copyright, srcform, commentaire.

liste extra_anim , par défaut : []

Objets supplémentaires Animationqui doivent être inclus dans le fichier vidéo enregistré. Ceux-ci doivent provenir de la même matplotlib.figure.Figureinstance. De plus, les images d'animation seront simplement combinées, il devrait donc y avoir une correspondance 1: 1 entre les images des différentes animations.

savefig_kwargs dict, par défaut : {}

Arguments de mot-clé passés à chaque savefigappel utilisé pour enregistrer les images individuelles.

fonction progress_callback , facultative

Une fonction de rappel qui sera appelée pour chaque image pour notifier la progression de l'enregistrement. Il doit porter la signature

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

où current_frame est le numéro de l'image actuelle et total_frames est le nombre total d'images à enregistrer. total_frames est défini sur None, si le nombre total d'images ne peut pas être déterminé. Les valeurs de retour peuvent exister mais sont ignorées.

Exemple de code pour écrire la progression sur stdout :

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

Remarques

fps , codec , bitrate , extra_args et metadata sont utilisés pour construire une MovieWriterinstance et ne peuvent être passés que si writer est une chaîne. S'ils sont passés comme non - Aucun et que l' auteur est a MovieWriter, a RuntimeErrorsera levé.

to_html5_video ( embed_limit = Aucun ) [source] #

<video>Convertissez l'animation en balise HTML5 .

Cela enregistre l'animation en tant que vidéo h264, encodée en base64 directement dans la balise vidéo HTML5. Cela respecte rcParams["animation.writer"](défaut : 'ffmpeg') et rcParams["animation.bitrate"](défaut : -1). Cela utilise également le intervalpour contrôler la vitesse et utilise le repeat paramètre pour décider de boucler ou non.

Paramètres :

flottant embed_limit , facultatif: Limite, en Mo, de l'animation renvoyée. Aucune animation n'est créée si la limite est dépassée. Par défaut à rcParams["animation.embed_limit"](par défaut : 20.0) = 20.0.

Retours :

chaîne: Une balise vidéo HTML5 avec l'animation intégrée en tant que vidéo h264 encodée en base64. Si le embed_limit est dépassé, cela renvoie la chaîne "Video too large to embed."

to_jshtml ( fps = None , embed_frames = True , default_mode = None ) [source] #

Générer une représentation HTML de l'animation.

Paramètres :

fps entier, facultatif: Fréquence d'images du film (par seconde). S'il n'est pas défini, la fréquence d'images de l'intervalle d'images de l'animation.
embed_frames booléen , facultatif
default_mode chaîne, facultatif: Que faire lorsque l'animation se termine. Doit être l'un des . La valeur par défaut est if est True, sinon .{'loop', 'once', 'reflect'}'loop'self.repeat'once'