Skip to main content

Activity Recognition with Ubiquitous Sensing

Project description

Overview

ARUS python package provides a computational and experimental framework to manage and process sensory data or wireless devices, to develop and run activity recognition algorithms on the data, and to create interactive programs using the algorithms and wireless devices.

This package is licensed under GPL version 3.

PyPI version
Downloads
deployment build
unittest and build test
codecov

Prerequists

python >= 3.7.0
# Need these SDKs to install arus[metawear] on Windows.
Visual Studio C++ SDK (v14.1)
Windows SDK (10.0.16299.0)
Windows SDK (10.0.17763.0)

# Need these packages to install arus[metawear] on Ubuntu or equivalent packages on other linux distributions.
libbluetooth-dev
libboost-all-dev
bluez

Installation

> pip install arus
# Optionally, you may install plugins via pip extra syntax.
> pip install arus[metawear]
> pip install arus[demo]
> pip install arus[dev]
> pip install arus[nn]

Optional components

arus[metawear]: This optional component installs dependency supports for streaming data from Bluetooth metawear sensors.

arus[demo]: This optional component installs dependency supports for running the demo app that demonstrates a real-time interactive activity recognition training and testing program.

arus[dev]: These optional component installs dependency supports for running some package and version management functions in the arus.dev module.

arus[nn]: The optional component installs dependency supports for PyTorch and Tensorboard, which are required by arus.models.report module. Note that for Windows, you should install the torch package manually using pip following the pytorch.org instruction.

Get started for development

> git clone https://github.com/qutang/arus.git
> cd arus
> # Install poetry python package management tool https://python-poetry.org/docs/
> # On Linux
> curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
> # On windows powershell
> (Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python
> # Install package dependencies
> poetry install
> # Install optional component dependencies
> poetry install --extras "metawear demo dev nn"
> # Run unit tests
> poetry run python -m pytest

Development conventions

  1. Use Google's python coding guidance: http://google.github.io/styleguide/pyguide.html.
  2. Use arus package release VERSION --release to bump and tag versions. VERSION can be manual version code following semantic versioning, path, minor, or major.
  3. Changelogs are automatically generated when building the documentation website, do not create it manually.
  4. Pypi release will be handled by github action deploy.yml, which will be triggered whenever a new tag is pushed. Therefore, developers should only tag release versions.
  5. After commits, even not bumping and releasing the package, you may run arus package docs --release to update the documentation website, where the developer version changelogs will be updated immediately.

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

arus-1.1.22.tar.gz (6.1 MB view hashes)

Uploaded source

Built Distribution

arus-1.1.22-py3-none-any.whl (6.1 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page