How guptabhishekumar/picostep works
PicoStep is a tiny wearable step-counting product, delivered as both a Python INT8 inference library and an Android sensor application. The user-facing flow is sensor samples → buffered windows → preprocessing/features → model prediction → arm-swing rejection and step accumulation. The repository also contains a substantial acc_gyro model-training workflow; README-documented runtime capabilities are retained where their implementation was not sampled. Some Android stage internals and Python preprocessing/windowing code were not excerpted, so only documented or indexed relationships are shown.
Main entry points: StepPipeline.kt Step pipeline · pipeline.py Training workflow · FeatureExtractor.kt Feature extraction · inference.py Python counter
Components 29
Android runtime
- Counter app
android/app/src/main/java/com/stepdetector/MainActivity.kt - Sample ring buffer
android/app/src/main/java/com/stepdetector/core/RingBuffer.kt - Step pipeline
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Signal processing
android/app/src/main/java/com/stepdetector/dsp/SignalProcessor.kt - Step predictor
android/app/src/main/java/com/stepdetector/ml/StepPredictor.kt - Arm-swing rejection
android/Elegant5StageRejector.kt - Walking filters
android/app/src/main/java/com/stepdetector/pipeline/stages - Step accumulator
android/app/src/main/java/com/stepdetector/pipeline/stages/StepAccumulator.kt
Python inference
- Python counter
src/picostep/inference.py - Python rejector
src/picostep/rejection.py
Model training
- Training workflow
training/acc_gyro/pipeline.py - Dataset loader
training/acc_gyro/data_loader.py - Step labeling
training/acc_gyro/verisense_labeler.py - Training windows
training/acc_gyro/windowing.py - Training features
training/acc_gyro/feature_extraction.py - Model fitting
training/acc_gyro/model_training.py - Feature selection
training/acc_gyro/feature_selection.py - Model evaluation
training/acc_gyro/evaluation.py - Model export
training/acc_gyro/export.py
Feature computation
- Feature extraction
android/app/src/main/java/com/stepdetector/features/FeatureExtractor.kt - Biomechanical features
android/app/src/main/java/com/stepdetector/features/BiomechanicalFeatures.kt - FFT
android/app/src/main/java/com/stepdetector/dsp/FFT.kt - Wavelet transform
android/app/src/main/java/com/stepdetector/dsp/WaveletTransform.kt - acc_gyro features
src/picostep/features/_acc_gyro/feature_extraction.py - acc_only features
src/picostep/features/acc_only.py
Other components
- Wearable user
- IMU stream
- Step count
- Training datasets
Connections 27
- Wearable user → Counter app: starts
README.md - IMU stream → Sample ring buffer: streams samples
README.md - Counter app → Step pipeline: starts
android/app/src/main/java/com/stepdetector/MainActivity.kt - Step pipeline → Sample ring buffer: reads windows
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step pipeline → Signal processing: processes window
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step pipeline → Feature extraction: extracts features
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Feature extraction → FFT: uses
android/app/src/main/java/com/stepdetector/features/FeatureExtractor.kt - Feature extraction → Wavelet transform: uses
android/app/src/main/java/com/stepdetector/features/FeatureExtractor.kt - Feature extraction → Biomechanical features: uses
android/app/src/main/java/com/stepdetector/features/FeatureExtractor.kt - Step pipeline → Biomechanical features: computes biomechanics
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step pipeline → Step predictor: predicts steps
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step pipeline → Walking filters: filters prediction
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step pipeline → Arm-swing rejection: rejects arm swing
- Step pipeline → Step accumulator: adds prediction
android/app/src/main/java/com/stepdetector/pipeline/StepPipeline.kt - Step accumulator → Step count: updates total
README.md - Python counter → acc_gyro features: extracts features
src/picostep/inference.py - Python counter → acc_only features: extracts features
src/picostep/inference.py - Python counter → Python rejector: optionally rejects
src/picostep/inference.py - Training datasets → Training workflow: supplies data
- Training workflow → Dataset loader: loads datasets
training/acc_gyro/pipeline.py - Training workflow → Step labeling: labels steps
training/acc_gyro/pipeline.py - Training workflow → Training windows: creates windows
training/acc_gyro/pipeline.py - Training workflow → Training features: extracts features
training/acc_gyro/pipeline.py - Training workflow → Model fitting: fits models
training/acc_gyro/pipeline.py - Training workflow → Feature selection: selects features
training/acc_gyro/pipeline.py - Training workflow → Model evaluation: evaluates models
training/acc_gyro/pipeline.py - Training workflow → Model export: exports models
training/acc_gyro/pipeline.py