PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

1.0.4

PyPI

acti-data-analyzer

A library for processing and analyzing actigraphic data.

actigraphycircadianrhythmssleep
Published5 Oct 2026
Direct dependencies20
Transitive dependenciesNot calculated

README

Version 1.0.4 documentation

ADA – Actigraphic Data Analyzer

ADA stands for Actigraphic Data Analyzer, coincidentally being also the name of the first programmer in the world. It is an open source Python module for processing, analyzing and visualizing actigraphic data, with the main focus on bedtime sleep/wake classification and circadian rhythms analysis. ADA is usable in the form of a python package, and in the form of a standalone application with graphical interface (GUI).

Installation

Python 3.11 or higher is required. To install the Python package use pip:

pip install acti-data-analyzer

GUI version of ADA can be installed and run on any system as a Python script, best within a venv. To do use following commands:

pip install 'acti-data-analyzer[gui]'
python -m ada_gui

The GUI for Windows 10 and Windows 11 is available also as a standalone executable. It can be downloaded from the Releases tab, available also under the link, as an ADA.exe file.

Citation

When using the ADA software in research, please cite:

Biegański, P., Tutaj, M., Duszyk-Bogorodzka, A. et al. Introducing Actigraphic Data Analyzer (ADA), an open source software for sleep/wake scoring and circadian rhythm analysis with graphical interface. Sci Rep 16, 30148 (2026). https://doi.org/10.1038/s41598-026-59007-7

Main features

  • Reading and writing data from:
    • GENEActiv .bin and .csv files
    • Actigraph Corp .gt3x and .csv files
    • The MESA dataset.
  • Converting data to native .ada format (much more efficient in terms of disk space and reading speed).
  • Multiple algorithms allowing collapsing into epochs:
    • MIMS
    • ActivityIndex
    • ENMO
    • Resampling
  • Sleep/wake scoring using multiple algorithms:
    • Cole-Kripke
    • Webster
    • Scripps Clinic
    • UCSD
    • Sazonov
    • Unified Filter, with possibility of custom filter construction.
  • Estimating multiple sleep metrics:
    • Sleep efficiency
    • Sleep fragmentation index
    • Sleep onset latency
    • Wake after sleep onset
    • And more.
  • Assessing circadian rhythms:
    • Single and multi-component cosinor in linear and nonlinear variants
    • Sigmoidally-transformed cosinor
    • Spectrum estimator using autoregressive model
    • Detrended Fluctuation Analysis
    • Nonparametric measures: Interdaily Stability, Intradaily Variability, M10, L5.
  • Easy to read and analyze summaries of sleep/wake and circadian assessments for multiple subjects (in a form of comma-separated CSV).
  • Automatic and customizable synchronization of actigraphic data with PSG staging.
  • Plotting of all analysis steps.

Documentation

Full documentation together with tutorial providing basic insight into functionalities of ADA as a Python package can be found under the link.

Example data

Sample dataset, consisting of 87 weekly recordings of healthy subjects, can be found under the link. Do not hesitate to test the package capabilities using this data!

Acknowledgments

pygt3x source code included in ADA is developed under the GPL-3.0 license by the Actigraph team. The original repository can be found under the link.

Funding

Study financed from the state budget within the program of the Polish Minister of Education and Science under the name ”Perły Nauki”, project number PN/01/0111/2022, funding value 239 998.00 zł, total value 239 998.00 zł

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 20

Native requirements
20 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
numpy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
numpy~=2.3.0runtime
tqdm
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
tqdm~=4.67.1runtime
ciso8601
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
ciso8601~=2.3.1runtime
multiprocess
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
multiprocess~=0.70.16runtime
scipy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
scipy~=1.16.0runtime
piecewise-regression
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
piecewise-regression~=1.5.0runtime
matplotlib
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
matplotlib~=3.10.7runtime
pandas
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pandas~=2.3.3runtime
dearpygui
Environment
{
  "extras": "",
  "marker": "extra == \"gui\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
dearpygui~=2.1.1; extra == "gui"runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pytest~=9.0.0; extra == "test"runtime
pytest-order
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pytest-order; extra == "test"runtime
pytest-randomly
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
pytest-randomly; extra == "test"runtime
flake8
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
flake8~=7.0.0; extra == "test"runtime
flake8-pyproject
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
flake8-pyproject; extra == "test"runtime
mypy
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
mypy~=1.18.2; extra == "test"runtime
mypy_extensions
Environment
{
  "extras": "",
  "marker": "extra == \"test\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
mypy_extensions; extra == "test"runtime
sphinx
Environment
{
  "extras": "",
  "marker": "extra == \"docs\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
sphinx~=8.2; extra == "docs"runtime
sphinx-autoapi
Environment
{
  "extras": "",
  "marker": "extra == \"docs\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
sphinx-autoapi~=3.6; extra == "docs"runtime
sphinx-book-theme
Environment
{
  "extras": "",
  "marker": "extra == \"docs\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
sphinx-book-theme~=1.1; extra == "docs"runtime
commonmark
Environment
{
  "extras": "",
  "marker": "extra == \"docs\"",
  "requires_python": ">=3.11",
  "evaluation": "NOT_EVALUATED"
}
commonmark~=0.9.1; extra == "docs"runtime

Distribution files

2 collected
acti_data_analyzer-1.0.4-py3-none-any.whl

bdist_wheel · 5,872.22 KB · Python py3

Source file
acti_data_analyzer-1.0.4.tar.gz

sdist · 5,751.1 KB · Python source

Source file

Repository

ACCESSIBLE
fuw_software/aktygrafy

Shared repository data · GitLab

License detected in repository
GNU Affero General Public License v3.0
License branch / ref
main
Contributor identities
7 · complete API traversal
License file
Contributors · showing 7 of 7 collected
ContributorContributions
Piotr Biegański142
pbieganski40
unknown11
Piotr Durka9
LaiRMaSTeR2
LaiRMaSTeR2
Monika Tutaj1

Default-branch author identities; GitLab commit counts exclude merge commits.

Public sponsor counts have not been collected. These signals belong to the repository owner.

Downloads & popularity

7identities
Gauge · observed snapshots24 Oct 2026
73.50
2026-10-20: 7 · observed 2026-10-20T21:57:01.3035287Z2026-10-21: 7 · observed 2026-10-21T21:57:32.2835049Z2026-10-23: 7 · observed 2026-10-23T07:36:16.4189868Z2026-10-24: 7 · observed 2026-10-24T09:01:10.9635737Z
20 Oct24 Oct

gitlab · 4 observations shown. Missing days are unknown.

View observed values
Date / source periodValueObserved at
2026-10-2472026-10-24T09:01:10.9635737Z
2026-10-2372026-10-23T07:36:16.4189868Z
2026-10-2172026-10-21T21:57:32.2835049Z
2026-10-2072026-10-20T21:57:01.3035287Z

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 18:30 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:80c4e685de429ecfc08f69d59a4dd36d00ce20d5f410ba3c1a84ae0e9e886099

Other collected versions

View all collected versions →