matplotlib.animation.FuncAnimation #
- classe matplotlib.animation. FuncAnimation ( fig , func , frames = None , init_func = None , fargs = None , save_count = None , * , cache_frame_data = True , ** kwargs ) [source] #
Crée une animation en appelant à plusieurs reprises une fonction func .
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 :
- figure
Figure L'objet figure utilisé pour obtenir les événements nécessaires, tels que dessiner ou redimensionner.
- fonction appelable
La fonction à appeler à chaque image. Le premier argument sera la valeur suivante dans frames . Tout argument positionnel supplémentaire peut être fourni via le paramètre fargs .
La signature requise est :
def func(frame, *fargs) -> iterable_of_artists
Si , func doit retourner un itérable de tous les artistes qui ont été modifiés ou créés. Cette information est utilisée par l'algorithme de blitting pour déterminer quelles parties de la figure doivent être mises à jour. La valeur de retour est inutilisée si et peut être omise dans ce cas.
blit == Trueblit == False- frames iterable, int, fonction générateur ou None, facultatif
Source de données pour passer func et chaque image de l'animation
S'il s'agit d'un itérable, utilisez simplement les valeurs fournies. Si l'itérable a une longueur, il remplacera le save_count kwarg.
Si un entier, alors équivalent à passer
range(frames)Si une fonction de générateur, alors doit avoir la signature :
def gen_function() -> obj
Si None , alors équivalent à passer
itertools.count.
Dans tous ces cas, les valeurs dans les cadres sont simplement transmises à la fonction fournie par l'utilisateur et peuvent donc être de n'importe quel type.
- init_func appelable, facultatif
Une fonction utilisée pour dessiner un cadre clair. S'il n'est pas fourni, les résultats du dessin à partir du premier élément de la séquence d'images seront utilisés. Cette fonction sera appelée une fois avant la première image.
La signature requise est :
def init_func() -> iterable_of_artists
Si , init_func doit renvoyer un itérable d'artistes à redessiner. Cette information est utilisée par l'algorithme de blitting pour déterminer quelles parties de la figure doivent être mises à jour. La valeur de retour est inutilisée si et peut être omise dans ce cas.
blit == Trueblit == False- fargs tuple ou None, facultatif
Arguments supplémentaires à passer à chaque appel à func .
- save_count entier , par défaut : 100
Repli pour le nombre de valeurs des trames vers le cache. Ceci n'est utilisé que si le nombre de frames ne peut pas être déduit de frames , c'est-à-dire lorsqu'il s'agit d'un itérateur sans longueur ou d'un générateur.
- intervalle entier, par défaut : 200
Délai entre les images en millisecondes.
- repeat_delay entier , par défaut : 0
Délai en millisecondes entre les exécutions consécutives d'animations, si la répétition est définie sur True.
- répéter bool, par défaut : Vrai
Indique si l'animation se répète lorsque la séquence d'images est terminée.
- blit booléen , par défaut : False
Si le blittage est utilisé pour optimiser le dessin. Remarque : lors de l'utilisation du blitting, tous les artistes animés seront dessinés selon leur zorder ; cependant, ils seront dessinés au-dessus de tous les artistes précédents, quel que soit leur zorder.
- cache_frame_data booléen , par défaut : Vrai
Indique si les données de trame sont mises en cache. La désactivation du cache peut être utile lorsque les cadres contiennent des objets volumineux.
- figure
- __init__ ( fig , func , frames = None , init_func = None , fargs = None , save_count = None , * , cache_frame_data = True , ** kwargs ) [source] #
Méthodes
__init__(fig, func[, frames, init_func, ...])Renvoie une nouvelle séquence d'informations de trame.
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.