跳转到主要内容

未提供项目描述

项目描述

actfast 快速动作描记仪数据读取器

actfast 是一个Python包,用于读取各种设备和制造商的原始动作描记仪数据。它旨在快速、轻量、内存效率高,适用于读取大数据集。

支持的格式和设备

该包目前支持以下格式

格式 制造商 设备 实施状态
GT3X Actigraph wGT3X-BT
BIN GENEActiv GENEActiv
CWA Axivity AX3, AX6
BIN Genea Genea
BIN Movisens Movisens
WAV Axivity Axivity 使用通用WAV音频文件读取器
AGD/SQLite Actigraph ActiGraph 使用通用SQLite读取器
AWD Philips Actiwatch 使用通用CSV读取器
MTN Philips Actiwatch 使用通用XML读取器
CSV 任何 任何 使用通用CSV读取器
XLS, XLSX, ODS 任何 任何 使用通用Excel读取器

本包的功能范围仅限于读取原始传感器数据。它不读取CSV或其他各种制造商常用的标准文件格式。请使用通用库读取这些文件。

本包设计为易于扩展,以支持新的格式和设备。如果您有一个尚未支持的非标准设备格式,请打开一个问题,并附加一个示例文件。我们将尽力添加对它的支持。

安装

通过PyPI安装

pip install actfast

或者,通过GitHub安装最新开发版本

pip install git+https://github.com/childmindresearch/actfast.git

测试设备

本包已与以下设备捕获的数据进行了广泛的测试

设备 固件
ActiGraph wGT3X-BT 1.9.2
GENEActiv 1.2 Ver06.17 15June23

可能还有类似的设备可以工作,但尚未经过测试。如果在遇到任何问题时,请打开一个问题并附加一个示例文件。

使用方法

该包提供了一个单一的功能,即read,它读取一个动作描记仪文件并返回一个字典

import actfast

subject1 = actfast.read("data/subject1.gt3x")

返回的字典具有以下结构

{
    "format": "Actigraph GT3X",  # file format, any of "Actigraph GT3X", "Axivity CWA", "GeneActiv BIN", "Genea BIN", "Unknown WAV", "Unknown SQLite"
    "metadata": {
        # device specific key value pairs of metadata (e.g., device model, firmware version)
    },
    "timeseries": {
        # device specific key value pairs of "timeseries name" -> {timeseries data}, e.g.:
        "high_frequency": {
            "datetime": # 1D int64 numpy array of timestamps in nanoseconds (Unix epoch time)
            # other data fields are various device specific sensor data, e.g.:
            "acceleration": # 2D numpy array (n_samples x 3) of acceleration data (x, y, z)
            "light": # 1D numpy array of light data
            "temperature": # temperature data
            # ...
        },
        "low_frequency": {
            # similar structure as high_frequency
        }
    },

架构及使用考虑

所有支持的格式似乎都是由可变长度、可变内容的记录流构成的。虽然对于制造商来说编写这样的记录流很容易,但它并不适合矢量化操作。《code>actfast收集数据到连续的数组中。

考虑一次性读取大型数据集并将其存储在更有效的格式(例如Parquet,HDF5)中,以便进行后续分析。这将始终加快数据读取速度并启用流数据处理。

许可证

本软件包采用MIT许可证。有关更多信息,请参阅许可证文件。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

actfast-1.1.0.tar.gz (85.0 kB 查看哈希值)

上传时间

构建分发

actfast-1.1.0-pp310-pypy310_pp73-musllinux_1_2_x86_64.whl (557.4 kB 查看哈希值)

上传时间 PyPy musllinux: musl 1.2+ x86-64

actfast-1.1.0-pp310-pypy310_pp73-musllinux_1_2_i686.whl (581.9 kB 查看哈希值)

上传时间 PyPy musllinux: musl 1.2+ i686

actfast-1.1.0-pp310-pypy310_pp73-musllinux_1_2_armv7l.whl (655.4 kB 查看哈希值)

上传时间 PyPy musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-pp310-pypy310_pp73-musllinux_1_2_aarch64.whl (571.0 kB 查看哈希值)

上传时间 PyPy musllinux: musl 1.2+ ARM64

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (390.8 kB 查看哈希值)

上传时间 PyPy manylinux: glibc 2.17+ x86-64

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (456.5 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ s390x

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.4 kB 查看哈希)

上传于 PyPy manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (405.4 kB 查看哈希)

上传于 PyPy manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.4 kB 查看哈希)

上传于 PyPy manylinux: glibc 2.17+ ARM64

actfast-1.1.0-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl (417.5 kB 查看哈希)

上传于 PyPy manylinux: glibc 2.5+ i686

actfast-1.1.0-pp39-pypy39_pp73-musllinux_1_2_x86_64.whl (557.5 kB 查看哈希)

上传于 PyPy musllinux: musl 1.2+ x86-64

actfast-1.1.0-pp39-pypy39_pp73-musllinux_1_2_i686.whl (581.8 kB 查看哈希)

上传于 PyPy musllinux: musl 1.2+ i686

actfast-1.1.0-pp39-pypy39_pp73-musllinux_1_2_armv7l.whl (655.2 kB 查看哈希)

上传于 PyPy musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-pp39-pypy39_pp73-musllinux_1_2_aarch64.whl (571.1 kB 查看哈希)

上传于 PyPy musllinux: musl 1.2+ ARM64

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (390.6 kB 查看哈希)

上传于 PyPy manylinux: glibc 2.17+ x86-64

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (457.1 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ s390x

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.3 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (405.6 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.5 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ARM64

actfast-1.1.0-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl (417.7 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.5+ i686

actfast-1.1.0-pp38-pypy38_pp73-musllinux_1_2_x86_64.whl (557.4 kB 查看哈希值)

上传于 PyPy musllinux: musl 1.2+ x86-64

actfast-1.1.0-pp38-pypy38_pp73-musllinux_1_2_i686.whl (581.9 kB 查看哈希值)

上传于 PyPy musllinux: musl 1.2+ i686

actfast-1.1.0-pp38-pypy38_pp73-musllinux_1_2_armv7l.whl (655.2 kB 查看哈希值)

上传于 PyPy musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-pp38-pypy38_pp73-musllinux_1_2_aarch64.whl (571.2 kB 查看哈希值)

上传于 PyPy musllinux: musl 1.2+ ARM64

actfast-1.1.0-pp38-pypy38_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl (457.0 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ s390x

actfast-1.1.0-pp38-pypy38_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.6 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-pp38-pypy38_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (405.8 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.3 kB 查看哈希值)

上传于 PyPy manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp312-none-win_amd64.whl (253.8 kB 查看哈希值)

上传于 CPython 3.12 Windows x86-64

actfast-1.1.0-cp312-none-win32.whl (246.1 kB 查看哈希值)

上传于 CPython 3.12 Windows x86

actfast-1.1.0-cp312-cp312-musllinux_1_2_x86_64.whl (556.3 kB 查看哈希值)

上传于 CPython 3.12 musllinux: musl 1.2+ x86-64

actfast-1.1.0-cp312-cp312-musllinux_1_2_i686.whl (580.6 kB 查看哈希值)

上传于 CPython 3.12 musllinux: musl 1.2+ i686

actfast-1.1.0-cp312-cp312-musllinux_1_2_armv7l.whl (654.0 kB 查看哈希值)

上传于 CPython 3.12 musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-cp312-cp312-musllinux_1_2_aarch64.whl (569.6 kB 查看哈希值)

上传于 CPython 3.12 musllinux: musl 1.2+ ARM64

actfast-1.1.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (390.0 kB 查看哈希值)

上传于 CPython 3.12 manylinux: glibc 2.17+ x86-64

actfast-1.1.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl (445.7 kB 查看哈希值)

上传于 CPython 3.12 manylinux: glibc 2.17+ s390x

actfast-1.1.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.2 kB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (404.1 kB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.1 kB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl (416.9 kB 查看哈希值)

上传时间 CPython 3.12 manylinux: glibc 2.5+ i686

actfast-1.1.0-cp312-cp312-macosx_11_0_arm64.whl (347.3 kB 查看哈希值)

上传时间 CPython 3.12 macOS 11.0+ ARM64

actfast-1.1.0-cp312-cp312-macosx_10_12_x86_64.whl (357.3 kB 查看哈希值)

上传时间 CPython 3.12 macOS 10.12+ x86-64

actfast-1.1.0-cp311-none-win_amd64.whl (252.4 kB 查看哈希值)

上传时间 CPython 3.11 Windows x86-64

actfast-1.1.0-cp311-none-win32.whl (246.1 kB 查看哈希值)

上传时间 CPython 3.11 Windows x86

actfast-1.1.0-cp311-cp311-musllinux_1_2_x86_64.whl (556.4 kB 查看哈希值)

上传时间 CPython 3.11 musllinux: musl 1.2+ x86-64

actfast-1.1.0-cp311-cp311-musllinux_1_2_i686.whl (581.2 kB 查看哈希值)

上传时间 CPython 3.11 musllinux: musl 1.2+ i686

actfast-1.1.0-cp311-cp311-musllinux_1_2_armv7l.whl (654.5 kB 查看哈希值)

上传于 CPython 3.11 musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-cp311-cp311-musllinux_1_2_aarch64.whl (569.9 kB 查看哈希值)

上传于 CPython 3.11 musllinux: musl 1.2+ ARM64

actfast-1.1.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (390.0 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ x86-64

actfast-1.1.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl (454.7 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ s390x

actfast-1.1.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.6 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (404.4 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.2 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl (417.2 kB 查看哈希值)

上传于 CPython 3.11 manylinux: glibc 2.5+ i686

actfast-1.1.0-cp311-cp311-macosx_11_0_arm64.whl (348.3 kB 查看哈希值)

上传于 CPython 3.11 macOS 11.0+ ARM64

actfast-1.1.0-cp311-cp311-macosx_10_12_x86_64.whl (358.1 kB 查看哈希值)

上传于 CPython 3.11 macOS 10.12+ x86-64

actfast-1.1.0-cp310-none-win_amd64.whl (252.5 kB 查看哈希值)

上传时间 CPython 3.10 Windows x86-64

actfast-1.1.0-cp310-none-win32.whl (246.1 kB 查看哈希值)

上传时间 CPython 3.10 Windows x86

actfast-1.1.0-cp310-cp310-musllinux_1_2_x86_64.whl (556.5 kB 查看哈希值)

上传时间 CPython 3.10 musllinux: musl 1.2+ x86-64

actfast-1.1.0-cp310-cp310-musllinux_1_2_i686.whl (581.2 kB 查看哈希值)

上传时间 CPython 3.10 musllinux: musl 1.2+ i686

actfast-1.1.0-cp310-cp310-musllinux_1_2_armv7l.whl (654.7 kB 查看哈希值)

上传时间 CPython 3.10 musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-cp310-cp310-musllinux_1_2_aarch64.whl (570.1 kB 查看哈希值)

上传时间 CPython 3.10 musllinux: musl 1.2+ ARM64

actfast-1.1.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (390.1 kB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ x86-64

actfast-1.1.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl (455.0 kB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ s390x

actfast-1.1.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.6 kB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (404.4 kB 查看哈希值)

上传时间 CPython 3.10 manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (395.4 kB 查看哈希值)

上传于 CPython 3.10 manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl (417.2 kB 查看哈希值)

上传于 CPython 3.10 manylinux: glibc 2.5+ i686

actfast-1.1.0-cp310-cp310-macosx_11_0_arm64.whl (348.3 kB 查看哈希值)

上传于 CPython 3.10 macOS 11.0+ ARM64

actfast-1.1.0-cp39-none-win_amd64.whl (252.5 kB 查看哈希值)

上传于 CPython 3.9 Windows x86-64

actfast-1.1.0-cp39-none-win32.whl (246.1 kB 查看哈希值)

上传于 CPython 3.9 Windows x86

actfast-1.1.0-cp39-cp39-musllinux_1_2_x86_64.whl (556.9 kB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ x86-64

actfast-1.1.0-cp39-cp39-musllinux_1_2_i686.whl (581.1 kB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ i686

actfast-1.1.0-cp39-cp39-musllinux_1_2_armv7l.whl (654.8 kB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-cp39-cp39-musllinux_1_2_aarch64.whl (570.5 kB 查看哈希值)

上传于 CPython 3.9 musllinux: musl 1.2+ ARM64

actfast-1.1.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (389.7 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ x86-64

actfast-1.1.0-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl (454.1 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ s390x

actfast-1.1.0-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.3 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (404.3 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (394.9 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl (417.3 kB 查看哈希值)

上传于 CPython 3.9 manylinux: glibc 2.5+ i686

actfast-1.1.0-cp39-cp39-macosx_11_0_arm64.whl (348.1 kB 查看哈希值)

上传于 CPython 3.9 macOS 11.0+ ARM64

actfast-1.1.0-cp38-none-win_amd64.whl (252.3 kB 查看哈希值)

上传于 CPython 3.8 Windows x86-64

actfast-1.1.0-cp38-none-win32.whl (246.0 kB 查看哈希值)

上传于 CPython 3.8 Windows x86

actfast-1.1.0-cp38-cp38-musllinux_1_2_x86_64.whl (556.5 kB 查看哈希值)

上传于 CPython 3.8 musllinux: musl 1.2+ x86-64

actfast-1.1.0-cp38-cp38-musllinux_1_2_i686.whl (581.2 kB 查看哈希值)

上传于 CPython 3.8 musllinux: musl 1.2+ i686

actfast-1.1.0-cp38-cp38-musllinux_1_2_armv7l.whl (654.6 kB 查看哈希值)

上传于 CPython 3.8 musllinux: musl 1.2+ ARMv7l

actfast-1.1.0-cp38-cp38-musllinux_1_2_aarch64.whl (570.2 kB 查看哈希值)

上传时间: CPython 3.8 musllinux: musl 1.2+ ARM64

actfast-1.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (389.6 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.17+ x86-64

actfast-1.1.0-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl (453.9 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.17+ s390x

actfast-1.1.0-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (432.2 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.17+ ppc64le

actfast-1.1.0-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (404.0 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.17+ ARMv7l

actfast-1.1.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (394.8 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.17+ ARM64

actfast-1.1.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl (416.6 kB 查看哈希值)

上传时间: CPython 3.8 manylinux: glibc 2.5+ i686

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面