Record and playback matplotlib figures
Project description
- Generate and playback recordings of user interactions with matplotlib figures.
- Integrates with sphinx gallery to automatically embed interactions in the docs without needing to manually generate gifs.
See https://mpl-playback.readthedocs.io/en/latest/gallery/index.html for an example of this in action.
Directly inspired by https://github.com/matplotlib/matplotlib/issues/19222
Command Line Usage
recording interactions To record a json file for later playback:
python -m mpl_playback.record example_file.py -figures fig --output example_playback.json
This will launch example_file.py and record any interactions with the object named fig
. Then it will be saved to example_playback.json
. However, the output argument is optional, if not given then the name will be example_file-playback.json
playback interactions in a gif
To play back the file you must pass both the original python file and the recording json file. You can optionally pass names for the output gif(s) with the --output
argument, or allow the names to be chosen automatically. 1 gif will be created for each figure that was recorded.
python -m mpl_playback.playback example_file.py example_playback.json
Q: Should you use this?
A: Depends on what you want. For one off gifs of interactions it's almost certainly easier to just record your screen to make a gif. But if you want integration with sphinx-gallery
then this is currently the only option.
Example of a rendered gif:
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 Distribution
Built Distribution
Hashes for mpl_playback-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b553e8aa5778bc5aebd167c7ba6c032d88ae7c2ce11dfa2bf8015eebe3c99ab |
|
MD5 | 3f300727035b3c3f1b08c712788fa641 |
|
BLAKE2b-256 | 805d9285568f8a294361a9c8fa18637b93d2d18d73064118d71d005a6ac324c3 |