Skip to main content

Activity Recognition with Ubiquitous Sensing

Project description


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
deployment build
unittest and build test


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.


> 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 module.

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

Get started for development

> git clone
> cd arus
> # Install poetry python package management tool
> # On Linux
> curl -sSL | python
> # On windows powershell
> (Invoke-WebRequest -Uri -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:
  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 and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page