class matplotlib.animation.ArtistAnimation(fig, artists, *args, **kwargs)[source]

Animation using a fixed set of Artist objects.

Before creating an instance, all plotting should have taken place and the relevant artists saved.


You must store the created Animation in a variable that lives as long as the animation should run. Otherwise, the Animation object will be garbage-collected and the animation stops.


The figure object used to get needed events, such as draw or resize.


Each list entry is a collection of Artist objects that are made visible on the corresponding frame. Other artists are made invisible.

intervalint, default: 200

Delay between frames in milliseconds.

repeat_delayint, default: 0

The delay in milliseconds between consecutive animation runs, if repeat is True.

repeatbool, default: True

Whether the animation repeats when the sequence of frames is completed.

blitbool, default: False

Whether blitting is used to optimize drawing.

__init__(fig, artists, *args, **kwargs)[source]

Initialize self. See help(type(self)) for accurate signature.


__init__(fig, artists, *args, **kwargs) Initialize self.
new_frame_seq() Return a new sequence of frame information.
new_saved_frame_seq() Return a new sequence of saved/cached frame information.
pause() Pause the animation.
resume() Resume the animation.
save(filename[, writer, fps, dpi, codec, ...]) Save the animation as a movie file by drawing every frame.
to_html5_video([embed_limit]) Convert the animation to an HTML5 <video> tag.
to_jshtml([fps, embed_frames, default_mode]) Generate HTML representation of the animation