Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/muschellij2/gt3x


https://github.com/muschellij2/gt3x

Last synced: 20 days ago
JSON representation

Awesome Lists containing this project

README

        

# PLEASE SEE
Actigraph has released its pygt3x package at https://github.com/actigraph/pygt3x. This is likely going to be better maintained than this repo and will likely update with different changes to GT3X format.

# Read Raw GT3X file
An implementation of extract raw acceleration data from .gt3x files.

This package was extracted and expanded upon from the work of Shaheen Syed and his repositories https://github.com/shaheen-syed/CNN-Non-Wear-Time-Algorithm and https://github.com/shaheen-syed/ActiGraph-ActiWave-Analysis. They are instrumental in this module creation.

The script gt3x_functions.py contains code to extract raw acceleration data from .gt3x files. Each .gt3x file is basically a zip file containing a log.bin and a info.txt file. The log.bin is a binary file which contains the actual acceleration values. The info.txt file contains the meta-data in text form. When the script is executed, it will create a numpy file that contains the raw data and a time vector.

### Usage

The `gt3x` module needs to be first installed. The most up-to-date one is:

```bash
pip install --upgrade git+https://github.com/muschellij2/gt3x.git#egg=gt3x
````

But can also be installed via `pip` from [PyPi](https://pypi.org/project/gt3x/):

```bash
pip install gt3x
```

```bash
import gt3x
actigraph_acc, actigraph_time, meta_data = gt3x.read_gt3x('AI9_NEO1F16120039_2017-06-27.gt3x')
```

## Installation

```bash
pip3 install -r requirements.txt
```