Repository navigation
Offline analysis: per-sensor IMU measurement support
Pre-releaseCaptureSuite Offline Analysis — IMU measurement support (experimental Linux x86_64)
This release includes merged PR176 at source 7c9c54e4ee7c38adeff6fb01300205bc8a354da9, the existing selected-table exporter, corrected EMG gap adjacency, actionable source QC warnings and the maintained dependency notice packaging.
A sensor missing from most recorded IMU frames previously produced ordinary feature values alongside stream validity 1.0. IMU feature table version 2 now includes:
window_frame_countfor the retained frames in each window.- Per-sensor
acc_sample_count/acc_valid_fractionandgyro_sample_count/gyro_valid_fraction. - One complete finite-vector population for acceleration axes and magnitude; independent gyro support.
- Unknown values when a measurement has zero support. An observed zero remains a zero.
- An incomplete-support job warning retained in selected CSV/Parquet exports. CLI warning counts now include all saved job warnings.
The denominator is retained frame slots, including gap-masked slots. These fractions do not estimate elapsed-time coverage and do not prove sensor accuracy, synchronization or calibration. Existing valid_fraction retains its stream gap-mask meaning.
Download and launch
Linux x86_64, built and exercised on Ubuntu with Python 3.12 bundled. No Python installation is required to run the extracted executable.
sha256sum -c SHA256SUMS
tar -xzf capturesuite-analysis-linux-x86_64-7c9c54e.tar.gz
./capturesuite-analysis/capturesuite-analysis --version
./capturesuite-analysis/capturesuite-analysis features /path/to/recording.mmsession --strict-warningsThe analysis prints the retained dir= of its job. Inspect and export actual selected columns:
./capturesuite-analysis/capturesuite-analysis export-table /path/to/recording.mmsession/processing/jobs/JOB --list
./capturesuite-analysis/capturesuite-analysis export-table /path/to/recording.mmsession/processing/jobs/JOB \
--table features/imu/SOURCE/windows.parquet \
--column t_mid_ns --column SENSOR_acc_mag_mean \
--column SENSOR_acc_sample_count --column SENSOR_acc_valid_fraction \
--column window_frame_count --output /path/to/new-exportReplace SOURCE and SENSOR with the literal names shown by --list. Export destinations must be new directories outside the session package. CSV, Parquet, column metadata and the original job warnings travel together. Strict analysis exit 2 means a completed job has warnings; exit 1 means failure.
Validation and limits
- Producer astra-marten-9c2f: 77 targeted feature/export/plugin regressions, focused Ruff and diff checks passed on estate Python 3.12. Real protobuf MCAP includes partial sensors, nonfinite vectors, declared gaps and complete controls; original source hashes remained unchanged.
- Independent judge astra-tern-9c2f: unfamiliar simulated readings in real MCAP reproduced the old problem in the published executable. Candidate acceptance covered 75% sensor support, 80% finite gyro support, zero-support unknowns, genuine zero readings, consistent vector populations and typed CSV/Parquet equivalence. A frozen candidate reproduced the source CSV byte-for-byte.
- Maintained build
scripts/build-analysis-linux.sh; no GitHub Actions. Bundled source pin isSOURCE_COMMIT; dependency versions and 42 actual distribution/runtime notice collections are included. - This is the offline CLI, not Windows acquisition or a native desktop distribution. Hardware accuracy, real-instrument timing, Windows execution and long-session performance are not claimed.
- Source-release download/run and demonstration evidence are recorded under task
capturesuite-current-workbench-judge-tern9c2fand will be attached after the released bytes are received.