napari-animation is a plugin for making animations in napari.
napari-animation provides a framework for the creation of animations in napari. The plugin contains:
- an easy to use GUI for creating animations interactively;
- a Python package for the programmatic creation of animations.
This plugin remains under development and contributions are very welcome, please open an issue to discuss potential improvements.
You can read the documentation at https://napari.org/napari-animation
You can install napari-animation via pip:
pip install napari-animationIf napari is not already installed, you can install napari-animation with napari and Qt via:
pip install "napari-animation[all]"`napari-animation` uses `ffmpeg` to export animations. If you are using a macOS arm64 computer (Apple Silicon e.g. M1, M2 processor)
the PyPI package does not include the needed binary for your platform. You will need to install `ffmpeg` using
`conda` from the [conda-forge channel](https://conda-forge.org/docs/#what-is-conda-forge) (`conda install -c conda-forge ffmpeg`)
or using [`homebrew`](https://brew.sh) (`brew install ffmpeg`).
napari-animation is also available for install using conda through the conda-forge channel.
conda install -c conda-forge napari-animationnapari-animation can be used interactively.
An animation is created by capturing keyframes containing the current viewer state.
To activate the GUI, select napari-animation: wizard from the plugins menu
napari-animation can also be run programatically, allowing for reproducible, scripted creation of animations.
from napari_animation import Animation
animation = Animation(viewer)
viewer.dims.ndisplay = 3
viewer.camera.angles = (0.0, 0.0, 90.0)
animation.capture_keyframe()
viewer.camera.zoom = 2.4
animation.capture_keyframe()
viewer.camera.angles = (-7.0, 15.7, 62.4)
animation.capture_keyframe(steps=60)
viewer.camera.angles = (2.0, -24.4, -36.7)
animation.capture_keyframe(steps=60)
viewer.reset_view()
viewer.camera.angles = (0.0, 0.0, 90.0)
animation.capture_keyframe()
animation.animate('demo.mov', canvas_only=False)Set canvas_only=True to export only the napari canvas, or False to include the
full viewer interface. In the GUI Save dialog this corresponds to the Canvas only
checkbox, which is enabled by default.
Examples can be found in our Examples gallery, generated from our example scripts. Simple examples for both interactive and headless use of the plugin follow.
Contributions are very welcome and a detailed contributing guide is coming soon.
In the meantime, clone this repository and install it in editable mode using pip:
pip install -e . --group dev
We recommend using a virtual environment.
Ensure you have a suitable Qt backend for napari! We recommend `PyQt6`.
For more information, see the napari [Qt backend installation guide](https://napari.org/stable/tutorials/fundamentals/installation.html#choosing-a-different-qt-backend)
To set up your development installation, clone this repository, navigate to the clone folder, and install napari-animation in editable mode using pip.
conda create -n nap-anim python=3.13
conda activate nap-anim
pip install -e . --group dev pyqt6
Tests are run with tox.
You can make sure your [dev] installation is working properly by running
tox from within the repository.
We use [`pre-commit`](https://pre-commit.com) to sort imports and lint with
[`ruff`](https://github.com/astral-sh/ruff) automatically prior to each commit.
To minmize test errors when submitting pull requests, please install `pre-commit`
in your environment as follows:
`pre-commit install`
The documentation is available at https://napari.org/napari-animation
The documentation for napari-animation is built with Sphinx and the napari Sphinx Theme.
After installing the documentation dependencies with
pip install -e . --group docyou can see a local version of the documentation by running
make docsOpen up the docs/_build/index.html file in your browser, and you'll see the home page of the docs being displayed.
The napari-animation documentation is automatically built and deployed to the website whenever the main branch is updated, or a new release is tagged. This is controlled by the deploy_docs.yml github actions script.
You can also manually trigger a documenation re-build and deployment from the github actions tab.
Distributed under the terms of the BSD-3 license, "napari-animation" is free and open source software
If you encounter any problems, please [file an issue] along with a detailed description.
Merlin Lange used napari-animation to create one of Nature's best science images for September 2022.
This plugin is built on naparimovie from @guiwitz. naparimovie was submitted to napari in PR#851 before napari plugin infrastructure existed.