Skip to main content

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:

  1. instantiate a Camera from a figure
import matplotlib.pyplot as plt
from mplcamera import Camera
fig = plt.figure()
cam = Camera(fig)
  1. After each step of plotting take snapshots of the figure
cam.snap()
  1. 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)

gif

Project details


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

mplcamera-0.0.2-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

Details for the file mplcamera-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: mplcamera-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 3.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.6.1 requests/2.25.1 setuptools/45.2.0.post20200210 requests-toolbelt/0.9.1 tqdm/4.55.0 CPython/3.7.3

File hashes

Hashes for mplcamera-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0a328f6540162281d5d1ccce182271e3c714cf2581472c1d8b6bffed82b39d9a
MD5 a139aa6d1e5b617d9ea106350b391ff2
BLAKE2b-256 68f6db71c25cc185952e6141f36702a6890e42e3c339688ddc2de269d8c2ed05

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page