Camera Class to make snapshots of a figure and save a gif from stored images
Project description
mplcamera
This package is adapted from https://github.com/jwkvam/celluloid.
Instead of capturing a figures artists like celluloid does, mplcamera takes an image snapshot of the whole figure. This has the advantage that
- all plot contents should be captured
- we have the opportunity to use savefig keyword arguments like facecolor and bbox_inches.
Further, using imageio to save a gif provides the opportunity for using mimsave_kwargs:
- to define a duration between frames in seconds, either as int, or as a list individually for each frame.
- we can set the loop to 1 (gif animation stops after 1 loop) or any other amount of loops.
Disadvantages:
- Saving the images takes a little more time than with mplcamera.
- It might be memory intensive to store a lot of images in memory.
The goal of this package is to provide a simple way to create gifs that can be used for example
- to show the creation process of a plot
- to aid visual storytelling by being able to focus longer on individual frames, which allows to show annotations only for that time (simply remove them after you snap the frame.)
Installation
pip install mplcamera
Usage
The usage remains the same as with celluloid:
- instantiate a Camera from a figure
import matplotlib.pyplot as plt
from mplcamera import Camera
fig = plt.figure()
cam = Camera(fig)
- After each step of plotting take snapshots of the figure
cam.snap()
- save the snapshots to a gif
cam.save('animation.gif')
Example:
import matplotlib.pyplot as plt
from mplcamera import Camera
fig, ax = plt.subplots()
ax.set_ylim(-0.25, 3.25)
cam = Camera(fig)
for i in range(4):
plt.plot([i] * 10)
cam.snap()
# use a different duration for frame 3. use loop=1 to not loop the gif
mimsave_kwargs = {'duration': [0.25, 0.25, 1, 0.25], 'loop': 0}
cam.save('mpl_camera_animation.gif', **mimsave_kwargs)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for mplcamera-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0a328f6540162281d5d1ccce182271e3c714cf2581472c1d8b6bffed82b39d9a |
|
MD5 | a139aa6d1e5b617d9ea106350b391ff2 |
|
BLAKE2b-256 | 68f6db71c25cc185952e6141f36702a6890e42e3c339688ddc2de269d8c2ed05 |