micromotion
Analysis of human micromotion in motion time series: optical marker data, body-worn accelerometers, respiration belts and force plates.
The measure the package exists for is quantity of motion — the average speed of a body part, band-limited to 0.2–10 Hz, in millimetres per second. It applies equally to all three sensor families because the shared abstraction is the frequency band, not the instrument.
pip install micromotion
import micromotion as mm
rec = mm.read("Standstill2017/mocap_data/A0001.tsv") # dispatches on content, not extension
head = rec.marker("P01")
mm.qom(head, rec.fs, kind="position").mean_mm_s
Documentation
| Reference documentation | how to use it, every function, the conventions |
| Wiki | why it works this way — traps, recipes, open questions |
| Changelog | what changed, and why |
New to it: Getting started, then The two bands, which is the one convention you cannot skip.
What is in it
| Module | Contents |
|---|---|
qom |
quantity of motion from position or acceleration |
filters |
the band definitions, band-pass, low-pass, high-pass, cardiac notch |
resample |
rate measurement, downsample-only resampling, irregular-to-regular gridding |
validate |
checks that fail loudly on silently-wrong data |
posture, balance |
sway geometry, centre-of-pressure measures |
spectral, physio |
cardiac and respiratory peaks, band power, breathing rate |
dynamics |
DFA, multifractality, recurrence, surrogates, entropy |
group |
whether these people moved at the same moments |
align, circular |
offsets between clocks; directional statistics |
io, record |
one reader per corpus layout, a content sniffer, a common record type |
Why it exists
It was built while constructing a single analysis across every dataset in the Oslo Standstill Database. There were 159 analysis scripts, of which 58 defined their own band-pass filter and 37 computed quantity of motion. The project's central measure existed in dozens of copies that did not all agree, and the disagreements were invisible.
Every default here was measured rather than assumed, and the reasoning is kept beside it. The traps page lists the mistakes that shaped the design; each one happened, produced a believable wrong number, and raised nothing at the time.
Requirements
Python 3.10+, numpy, scipy, pandas.
Licence
GPL-3.0-or-later. If you use it, please cite it — see CITATION.cff.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file micromotion-0.8.3.tar.gz.
File metadata
- Download URL: micromotion-0.8.3.tar.gz
- Upload date:
- Size: 128.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04e3ff345fef1e15185aa2c70b0cb1364fcb899e126e9b0b58a206c50f49895f
|
|
| MD5 |
cefc1855226311a9c533a61eaa36ea97
|
|
| BLAKE2b-256 |
bda1e4ca4bb2dc809c08326ba27f5dc49578eac1407db59b1f5d08155af49e04
|
Provenance
The following attestation bundles were made for micromotion-0.8.3.tar.gz:
Publisher:
publish.yml on fourMs/micromotion
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
micromotion-0.8.3.tar.gz -
Subject digest:
04e3ff345fef1e15185aa2c70b0cb1364fcb899e126e9b0b58a206c50f49895f - Sigstore transparency entry: 2295239150
- Sigstore integration time:
-
Permalink:
fourMs/micromotion@8e35975d40075771b80148829adf9125bbdb001b -
Branch / Tag:
refs/tags/v0.8.3 - Owner: https://github.com/fourMs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8e35975d40075771b80148829adf9125bbdb001b -
Trigger Event:
release
-
Statement type:
File details
Details for the file micromotion-0.8.3-py3-none-any.whl.
File metadata
- Download URL: micromotion-0.8.3-py3-none-any.whl
- Upload date:
- Size: 87.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a8d3736c081b7e4e8d256d8d18fd47fd00a2b67fee22f08482b87c9f36c35b4
|
|
| MD5 |
fd1e0ff944fa05d3ee94ddca69ec06c6
|
|
| BLAKE2b-256 |
2bc976e3d4326886008f1ae4bdd879c6dd5118a59bb71645ae6ff11289286be0
|
Provenance
The following attestation bundles were made for micromotion-0.8.3-py3-none-any.whl:
Publisher:
publish.yml on fourMs/micromotion
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
micromotion-0.8.3-py3-none-any.whl -
Subject digest:
5a8d3736c081b7e4e8d256d8d18fd47fd00a2b67fee22f08482b87c9f36c35b4 - Sigstore transparency entry: 2295239196
- Sigstore integration time:
-
Permalink:
fourMs/micromotion@8e35975d40075771b80148829adf9125bbdb001b -
Branch / Tag:
refs/tags/v0.8.3 - Owner: https://github.com/fourMs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@8e35975d40075771b80148829adf9125bbdb001b -
Trigger Event:
release
-
Statement type:
