accelerometer


Nameaccelerometer JSON
Version 7.2.1.post0 PyPI version JSON
download
home_pagehttps://github.com/activityMonitoring/biobankAccelerometerAnalysis
SummaryA package to extract meaningful health information from large accelerometer datasets e.g. how much time individuals spend in sleep, sedentary behaviour, walking and moderate intensity physical activity
upload_time2024-12-18 14:21:50
maintainerShing Chan
docs_urlNone
authorAiden Doherty, Shing Chan, Rosemary Walmsley, Hang Yuan
requires_python<3.11,>=3.7
licenseSee LICENSE.md
keywords wearables accelerometer health data science human activity recognition
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![Accelerometer data processing overview](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accelerometerLogo.png)

[![Github all releases](https://img.shields.io/github/release/activityMonitoring/biobankAccelerometerAnalysis.svg)](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/releases/)
![install](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/install/badge.svg)
![flake8](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/flake8/badge.svg)
![junit](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/junit/badge.svg)
![gt3x](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/gt3x/badge.svg)
![cwa](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/cwa/badge.svg)

A tool to extract meaningful health information from large accelerometer datasets. The software generates time-series and summary metrics useful for answering key questions such as how much time is spent in sleep, sedentary behaviour, or doing physical activity.

## Install

*Minimum requirements*: Python 3.7 to 3.10, Java 8 (1.8)

The following instructions make use of Anaconda to meet the minimum requirements:

1. Download & install [Miniconda](https://docs.conda.io/en/latest/miniconda.html) (light-weight version of Anaconda).
1. (Windows) Once installed, launch the **Anaconda Prompt**.
1. Create a virtual environment:
    ```console
    $ conda create -n accelerometer python=3.9 openjdk pip
    ```
    This creates a virtual environment called `accelerometer` with Python version 3.9, OpenJDK, and Pip.
1. Activate the environment:
    ```console
    $ conda activate accelerometer
    ```
    You should now see `(accelerometer)` written in front of your prompt.
1. Install `accelerometer`:
    ```console
    $ pip install accelerometer
    ```

You are all set! The next time that you want to use `accelerometer`, open the Anaconda Prompt and activate the environment (step 4). If you see `(accelerometer)` in front of your prompt, you are ready to go!

## Usage
To extract summary movement statistics from an Axivity file (.cwa):

```console
$ accProcess data/sample.cwa.gz

 <output written to data/sample-outputSummary.json>
 <time series output written to data/sample-timeSeries.csv.gz>
```

Movement statistics will be stored in a JSON file:
```json
{
    "file-name": "sample.cwa.gz",
    "file-startTime": "2014-05-07 13:29:50",
    "file-endTime": "2014-05-13 09:49:50",
    "acc-overall-avg(mg)": 32.78149,
    "wearTime-overall(days)": 5.8,
    "nonWearTime-overall(days)": 0.04,
    "quality-goodWearTime": 1
}
```

See [Data Dictionary](https://biobankaccanalysis.readthedocs.io/en/latest/datadict.html) for the list of output variables.

Actigraph and GENEActiv files are also supported, as well as custom CSV files. See [Usage](https://biobankaccanalysis.readthedocs.io/en/latest/usage.html#basic-usage) for more details.

To plot the activity profile:
```console
$ accPlot data/sample-timeSeries.csv.gz
 <output plot written to data/sample-timeSeries-plot.png>
```
![Time series plot](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/samplePlot.png)

### Troubleshooting 
Some systems may face issues with Java when running the script. If this is your case, try fixing OpenJDK to version 8:
```console
$ conda install -n accelerometer openjdk=8
```

## Under the hood
Interpreted levels of physical activity can vary, as many approaches can be
taken to extract summary physical activity information from raw accelerometer
data. To minimise error and bias, our tool uses published methods to calibrate,
resample, and summarise the accelerometer data.

![Accelerometer data processing overview](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accMethodsOverview.png)
![Activity classification](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accClassification.png)

See [Methods](https://biobankaccanalysis.readthedocs.io/en/latest/methods.html) for more details.


## Citing our work
When using this tool, please consider the works listed in [CITATION.md](https://github.com/OxWearables/biobankAccelerometerAnalysis/blob/master/CITATION.md).
    

## Licence
See [LICENSE.md](https://github.com/OxWearables/biobankAccelerometerAnalysis/blob/master/LICENSE.md).


## Acknowledgements
We would like to thank all our code contributors and manuscript co-authors.

[Contributors Graph](https://github.com/OxWearables/biobankAccelerometerAnalysis/graphs/contributors)

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/activityMonitoring/biobankAccelerometerAnalysis",
    "name": "accelerometer",
    "maintainer": "Shing Chan",
    "docs_url": null,
    "requires_python": "<3.11,>=3.7",
    "maintainer_email": "shing.chan@ndph.ox.ac.uk",
    "keywords": "wearables, accelerometer, health data science, human activity recognition",
    "author": "Aiden Doherty, Shing Chan, Rosemary Walmsley, Hang Yuan",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/cb/e3/b9ad357a40cfd8bb44bd61fccb32b4b2519f0dee9364cf70cc44e8f56fdf/accelerometer-7.2.1.post0.tar.gz",
    "platform": null,
    "description": "![Accelerometer data processing overview](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accelerometerLogo.png)\n\n[![Github all releases](https://img.shields.io/github/release/activityMonitoring/biobankAccelerometerAnalysis.svg)](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/releases/)\n![install](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/install/badge.svg)\n![flake8](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/flake8/badge.svg)\n![junit](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/junit/badge.svg)\n![gt3x](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/gt3x/badge.svg)\n![cwa](https://github.com/activityMonitoring/biobankAccelerometerAnalysis/workflows/cwa/badge.svg)\n\nA tool to extract meaningful health information from large accelerometer datasets. The software generates time-series and summary metrics useful for answering key questions such as how much time is spent in sleep, sedentary behaviour, or doing physical activity.\n\n## Install\n\n*Minimum requirements*: Python 3.7 to 3.10, Java 8 (1.8)\n\nThe following instructions make use of Anaconda to meet the minimum requirements:\n\n1. Download & install [Miniconda](https://docs.conda.io/en/latest/miniconda.html) (light-weight version of Anaconda).\n1. (Windows) Once installed, launch the **Anaconda Prompt**.\n1. Create a virtual environment:\n    ```console\n    $ conda create -n accelerometer python=3.9 openjdk pip\n    ```\n    This creates a virtual environment called `accelerometer` with Python version 3.9, OpenJDK, and Pip.\n1. Activate the environment:\n    ```console\n    $ conda activate accelerometer\n    ```\n    You should now see `(accelerometer)` written in front of your prompt.\n1. Install `accelerometer`:\n    ```console\n    $ pip install accelerometer\n    ```\n\nYou are all set! The next time that you want to use `accelerometer`, open the Anaconda Prompt and activate the environment (step 4). If you see `(accelerometer)` in front of your prompt, you are ready to go!\n\n## Usage\nTo extract summary movement statistics from an Axivity file (.cwa):\n\n```console\n$ accProcess data/sample.cwa.gz\n\n <output written to data/sample-outputSummary.json>\n <time series output written to data/sample-timeSeries.csv.gz>\n```\n\nMovement statistics will be stored in a JSON file:\n```json\n{\n    \"file-name\": \"sample.cwa.gz\",\n    \"file-startTime\": \"2014-05-07 13:29:50\",\n    \"file-endTime\": \"2014-05-13 09:49:50\",\n    \"acc-overall-avg(mg)\": 32.78149,\n    \"wearTime-overall(days)\": 5.8,\n    \"nonWearTime-overall(days)\": 0.04,\n    \"quality-goodWearTime\": 1\n}\n```\n\nSee [Data Dictionary](https://biobankaccanalysis.readthedocs.io/en/latest/datadict.html) for the list of output variables.\n\nActigraph and GENEActiv files are also supported, as well as custom CSV files. See [Usage](https://biobankaccanalysis.readthedocs.io/en/latest/usage.html#basic-usage) for more details.\n\nTo plot the activity profile:\n```console\n$ accPlot data/sample-timeSeries.csv.gz\n <output plot written to data/sample-timeSeries-plot.png>\n```\n![Time series plot](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/samplePlot.png)\n\n### Troubleshooting \nSome systems may face issues with Java when running the script. If this is your case, try fixing OpenJDK to version 8:\n```console\n$ conda install -n accelerometer openjdk=8\n```\n\n## Under the hood\nInterpreted levels of physical activity can vary, as many approaches can be\ntaken to extract summary physical activity information from raw accelerometer\ndata. To minimise error and bias, our tool uses published methods to calibrate,\nresample, and summarise the accelerometer data.\n\n![Accelerometer data processing overview](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accMethodsOverview.png)\n![Activity classification](https://raw.githubusercontent.com/OxWearables/biobankAccelerometerAnalysis/master/docs/source/accClassification.png)\n\nSee [Methods](https://biobankaccanalysis.readthedocs.io/en/latest/methods.html) for more details.\n\n\n## Citing our work\nWhen using this tool, please consider the works listed in [CITATION.md](https://github.com/OxWearables/biobankAccelerometerAnalysis/blob/master/CITATION.md).\n    \n\n## Licence\nSee [LICENSE.md](https://github.com/OxWearables/biobankAccelerometerAnalysis/blob/master/LICENSE.md).\n\n\n## Acknowledgements\nWe would like to thank all our code contributors and manuscript co-authors.\n\n[Contributors Graph](https://github.com/OxWearables/biobankAccelerometerAnalysis/graphs/contributors)\n",
    "bugtrack_url": null,
    "license": "See LICENSE.md",
    "summary": "A package to extract meaningful health information from large accelerometer datasets e.g. how much time individuals spend in sleep, sedentary behaviour, walking and moderate intensity physical activity",
    "version": "7.2.1.post0",
    "project_urls": {
        "Download": "https://github.com/activityMonitoring/biobankAccelerometerAnalysis",
        "Homepage": "https://github.com/activityMonitoring/biobankAccelerometerAnalysis"
    },
    "split_keywords": [
        "wearables",
        " accelerometer",
        " health data science",
        " human activity recognition"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bbf5af2acb5e11de7acc51976c43f9f873388daf7c5af8f7d99c973a6f4f3152",
                "md5": "063e5bcc8b3c16f8f17647ec7cc93e8b",
                "sha256": "0b239d4c59b83727902f92d5f91051773ce6ad0038b7e543d2de740196c0ad2f"
            },
            "downloads": -1,
            "filename": "accelerometer-7.2.1.post0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "063e5bcc8b3c16f8f17647ec7cc93e8b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.11,>=3.7",
            "size": 1521368,
            "upload_time": "2024-12-18T14:21:46",
            "upload_time_iso_8601": "2024-12-18T14:21:46.512263Z",
            "url": "https://files.pythonhosted.org/packages/bb/f5/af2acb5e11de7acc51976c43f9f873388daf7c5af8f7d99c973a6f4f3152/accelerometer-7.2.1.post0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cbe3b9ad357a40cfd8bb44bd61fccb32b4b2519f0dee9364cf70cc44e8f56fdf",
                "md5": "a52e0f454de625ebe06264d7dc9eacb3",
                "sha256": "2e53448586b1dcaa4c2939fdbcf85cf3f5f73c85cebe7492eef86acfeb0c5d0b"
            },
            "downloads": -1,
            "filename": "accelerometer-7.2.1.post0.tar.gz",
            "has_sig": false,
            "md5_digest": "a52e0f454de625ebe06264d7dc9eacb3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.11,>=3.7",
            "size": 1529617,
            "upload_time": "2024-12-18T14:21:50",
            "upload_time_iso_8601": "2024-12-18T14:21:50.349013Z",
            "url": "https://files.pythonhosted.org/packages/cb/e3/b9ad357a40cfd8bb44bd61fccb32b4b2519f0dee9364cf70cc44e8f56fdf/accelerometer-7.2.1.post0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-18 14:21:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "activityMonitoring",
    "github_project": "biobankAccelerometerAnalysis",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "accelerometer"
}
        
Elapsed time: 0.48427s