Skip to main content

Stable version Latest version Documentation Status Continuous integration status Coverage conda Conda Upload PyPI Upload LICENSE

NAPS (NAPS is ArUco Plus SLEAP)

NAPS is a tool for researchers with two goals: (1) to quantify animal behavior over a long timescale and high resolution, with minimal human bias, and (2) to track the behavior of individuals with a high level of identity-persistence. This could be of use to researchers studying social network analysis, animal communication, task specialization, or gene-by-environment interactions. By combining deep-learning based pose estimation software with easily read and minimally invasive fiducial markers (“tags”), we provide an easy-to-use solution for producing high-quality, high-dimensional behavioral data.

Example usage of NAPS to track a colony of common eastern bumblebees.

Documentation

NAPS documentation can be found at naps.rtfd.io.

Features

  • Easy, direct installation across platforms

  • Built directly on top of OpenCV and SLEAP with a modular, extensible codebase

  • Flexible API that allows drop in of different methods for marker identification

Getting NAPS

Easy install

conda (Windows/Linux):

conda create -n naps naps-track -c kocherlab -c sleap -c nvidia -c conda-forge

pip (any OS):

pip install naps-track

References

Manuscript: https://doi.org/10.1101/2022.12.07.518416

If you use NAPS in your research, please cite:

BibTeX:

@article{wolf2022naps,
   title={NAPS: Integrating pose estimation and tag-based tracking},
   author={Wolf, Scott W and Ruttenberg, Dee M and Knapp, Daniel Y and Webb, Andrew E and Traniello, Ian M and McKenzie-Smith, Grace C and Leheny, Sophie A and Shaevitz, Joshua W and Kocher, Sarah D},
   journal={bioRxiv},
   year={2022},
   publisher={Cold Spring Harbor Laboratory}
}

Issues

Issues with NAPS?

  1. Check the docs.

  2. Search the issues on GitHub or open a new one.

Contributors

  • Scott Wolf, Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Dee Ruttenberg, Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Daniel Knapp, Department of Physics, Princeton University

  • Andrew Webb, Department of Ecology and Evolutionary Biology and Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Ian Traniello, Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Grace McKenzie-Smith, Department of Physics and Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Sophie Leheny, Department of Molecular Biology, Princeton University

  • Joshua Shaevitz, Department of Physics and Lewis-Sigler Institute for Integrative Genomics, Princeton University

  • Sarah Kocher, Department of Ecology and Evolutionary Biology and Lewis-Sigler Institute for Integrative Genomics, Princeton University

NAPS was created in the Kocher and Shaevitz labs at Princeton University.

License

NAPS is licensed under the MIT license. See the LICENSE file for details.

Acknowledgements

Much of the structure and content of the README and the documentation is borrowed from the SLEAP repository.

Metadata

Release files for naps-track 1.0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for naps-track 1.0.9
File Size Uploaded
naps-track-1.0.9.tar.gz 21.4 kB Details

Release files / naps-track-1.0.9.tar.gz

Download URL naps-track-1.0.9.tar.gz
Size 21.4 kB
Tags Source
SHA-256 checksum
How to use checksums
c7610b11d0c284c94d6c542dac71be95bfe467ab85bcd0268977dcd75dfe4d1d
BLAKE2b-256 checksum
How to use checksums
3161201f00fed2f07d16daddeed86af4f92f60a09ccc3ac6927ab0dd35af9066
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.9.20

Release history Release notifications | RSS feed

This release

1.0.9 This release

1 release file

1.0.7

1 release file

1.0.6

1 release file

1.0.5

1 release file

1.0.2

1 release file

1.0.0

1 release file

0.1.15

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page