Skip to content

Offline analysis: per-sensor IMU measurement support

Pre-release
Pre-release

Choose a tag to compare

@Jacob-Met Jacob-Met released this 10 Nov 19:19
7c9c54e

CaptureSuite 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_count for the retained frames in each window.
  • Per-sensor acc_sample_count / acc_valid_fraction and gyro_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-warnings

The 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-export

Replace 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 is SOURCE_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-tern9c2f and will be attached after the released bytes are received.