neuroinformatics-unit/movement: v0.11.0

Summary

movement v0.11.0 redefines displacement vectors, simplifies installation via pip and uv, and introduces multi-version documentation. It also brings support for 3D DeepLabCut files and welcomes many new contributors 🎉.

What's changed

↗️ Refined displacement vectors

@carlocastoldi has overhauled how movement computes displacement vectors, making the definitions more explicit, flexible, and intuitive for users. You can read all about these changes in our latest blog post, written by Carlo.

• improve resulting displacement vectors by @carlocastoldi in https://github.com/neuroinformatics-unit/movement/pull/657
• Add blog post about displacement's API changes by @carlocastoldi in https://github.com/neuroinformatics-unit/movement/pull/688

<img width="1120" height="452" alt="displacement_old_vs_new" src="https://github.com/user-attachments/assets/61d29480-a1c1-4956-ab9f-9b760e58e3d3" />

⚡️ Simplified installation via pip and uv

We've streamlined the dependency setup so that movement can now be installed directly with pip or uv—no extra steps required.

Early adopters can try:

uv pip install movement

See our updated installation guide for full details.

• Enable pure pip/uv installations by @niksirbi in https://github.com/neuroinformatics-unit/movement/pull/683

📚 Multi-version documentation

Thanks to @animeshsasan, the documentation now includes a version switcher! This means that, going forward, you will be able to browse docs for multiple versions of movement, making it much easier to follow along with future updates and interface changes.

• Changes for multi-version docs by @animeshsasan in https://github.com/neuroinformatics-unit/movement/pull/668

📂 Improved handling of DeepLabCut files

Through a collaboration between @Akseli-Ilmanen and @lochhh, movement can now load and save DeepLabCut files with 3D coordinates (x, y, z).

In addition, @CeliaLrt clarified the documentation to make explicit that movement currently requires all keypoints to be shared across individuals.

• Support loading and saving 3D DeepLabCut poses by @lochhh in https://github.com/neuroinformatics-unit/movement/pull/686
• Add documentation to specify Movement require identical keypoints (#150) by @CeliaLrt in https://github.com/neuroinformatics-unit/movement/pull/658

🧹 Housekeeping

• Update links to SLEAP docs by @niksirbi in https://github.com/neuroinformatics-unit/movement/pull/681
• [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in https://github.com/neuroinformatics-unit/movement/pull/682
• Update links to animovement by @niksirbi in https://github.com/neuroinformatics-unit/movement/pull/684
• Pin netcdf<1.7.3 to fix failing integration tests by @niksirbi in https://github.com/neuroinformatics-unit/movement/pull/685
• [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci[bot] in https://github.com/neuroinformatics-unit/movement/pull/692
• Contributors-Readme-Action: Update contributors list by @github-actions[bot] in https://github.com/neuroinformatics-unit/movement/pull/690
• Bump actions/download-artifact from 5 to 6 by @dependabot[bot] in https://github.com/neuroinformatics-unit/movement/pull/691

🧑‍💻 New Contributors

• @carlocastoldi made their first contribution in https://github.com/neuroinformatics-unit/movement/pull/657
• @CeliaLrt made their first contribution in https://github.com/neuroinformatics-unit/movement/pull/658
• @animeshsasan made their first contribution in https://github.com/neuroinformatics-unit/movement/pull/66
• @Akseli-Ilmanen made their first contribution by co-authoring https://github.com/neuroinformatics-unit/movement/pull/686

Full Changelog: https://github.com/neuroinformatics-unit/movement/compare/v0.10.0...v0.11.0