Skip to main content

Analysis package for actigraphy data

Project description


Open-source python package for actigraphy data visualization and analysis.

This package is meant to provide a comprehensive set of tools to:

  • read native actigraphy data files with various formats:

    • Actigraph: wGT3X-BT

    • Condor Instrument: ActTrust 2

    • CamNtech: Actiwatch 4 and MotionWatch 8

    • Respironics: Actiwatch 2 and Actiwatch Spectrum (plus)

    • Daqtix: Daqtometer

  • clean the raw data and mask spurious periods of inactivity

  • produce activity profile plots

  • visualize sleep agendas and compute summary statistics

  • calculate typical wake/sleep cycle-related variables:

    • Non-parametric rest-activity variables: IS(m), IV(m), RA

    • Activity or Rest fragmentation: kRA, kAR

    • Sleep regularity index (SRI)

  • automatically detect rest periods using various algorithms (Cole-Kripke, Sadeh, …, Crespo, Roenneberg)

  • perform complex analyses:

    • Cosinor analysis

    • Detrended Fluctuation Analysis (DFA)

    • Functional Linear Modelling (FLM)

    • Locomotor Inactivity During Sleep (LIDS)

    • Singular Spectrum Analysis (SSA)

    • and much more…

Code and documentation

The pyActigraphy package is open-source and its source code is accessible online.

An online documentation of the package is also available here. It contains notebooks illustrating various functionalities of the package.


In a (bash) shell, simply type:

  • For users:

pip3 install pyActigraphy

To update the package:

pip3 install -U pyActigraphy

It is strongly recommended to use the latest version of the pyActigraphy package.

  • For developers:

git clone
cd pyActigraphy/
git checkout develop
pip3 install -e .

Quick start

The following example illustrates how to calculate the interdaily stability with the pyActigraphy package:

>>> import pyActigraphy
>>> rawAWD ='/path/to/your/favourite/file.AWD')
>>> rawAWD.IS()
>>> rawAWD.IS(freq='30min', binarize=True, threshold=4)
>>> rawAWD.IS(freq='1H', binarize=False)


There are plenty of ways to contribute to this package, including (but not limiting to):

  • report bugs (and, ideally, how to reproduce the bug)

  • suggest improvements

  • improve the documentation


See also the list of contributors who participated in this project.


This project is licensed under the GNU GPL-3.0 License - see the LICENSE file for details


  • Aubin Ardois @aardoi developed the first version of the MTN class during his internship at the CRC, in May-August 2018.

  • The CRC colleagues for their support, ideas, etc.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyActigraphy-1.0rc1.tar.gz (800.0 kB view hashes)

Uploaded source

Built Distribution

pyActigraphy-1.0rc1-py3-none-any.whl (849.1 kB view hashes)

Uploaded py3

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