Skip to content

Offline analysis: EMG continuity (Linux experimental)

Pre-release
Pre-release

Choose a tag to compare

@Jacob-Met Jacob-Met released this 10 Nov 20:36
38edc6e

CaptureSuite offline analysis: recorded EMG continuity

Experimental Linux x86-64 build of exact source 38edc6e (merged PR177). This version includes the cumulative offline analysis work at that commit: payload QC, saved feature export, nested signal plots, warning-first responsive reports, numeric excerpts and IMU checks.

What changed

Decoded EMG QC checks each batch's first sample index against the preceding decoded batch's expected end, including transitions between MCAP segments. Missing ranges, overlap and counter resets now produce a warning with exact expected/observed indices. Arbitrary starting indices remain valid. Reset handling re-anchors the next comparison rather than repeating the same error. Raw recording files are unchanged.

Run

Download the Linux archive and SHA256SUMS, then:

sha256sum --check --ignore-missing SHA256SUMS
tar -xzf capturesuite-analysis-linux-x86_64.tar.gz
./capturesuite-analysis/capturesuite-analysis --version
./capturesuite-analysis/capturesuite-analysis qc "/data/session.mmsession" --inspect-payloads --strict-warnings

Open the printed job's reports/qc.html in a browser. Exit 0 means the QC job passed its requested checks; exit 2 means strict warnings. The bundled README documents features, plots, all and export-table.

Observed validation

Producer astra-larch-91e ran the maintained scripts/build-analysis-linux.sh on hamon-build-195, exact source above. 75 relevant source tests and focused Ruff checks passed at the merge. The actual standalone executable ran outside the checkout with PATH=/nonexistent: arbitrary-origin continuous EMG exited0; missing batch expected4/observed8 exited2 with exactly1 forward jump; reset expected104/observed0 exited2 with exactly1 overlap/reset and no spurious follow-on warning. All raw source hashes stayed unchanged. release-use.json records these three results; synthetic input packages are attached. Actual emitted HTML was opened in Chrome at1440x1000 and390x844 and visually inspected; document width equalled viewport and the warning was visible on the first phone screen. Attached screenshots show that final merge report.

Independent judge astra-sable-4f1 separately built/exercised predecessor1884e4ade73507ee7a4721d1c9b26abe2f9ebb72 using heldout multi-segment continuous/missing/overlap/reset recordings. Scoped PASS: exact single discontinuity count, raw unchanged, real desktop/phone report inspected. Task capturesuite-release-operator-judge-sable4f1 retains the independent evidence. The final merged38 build's producer checks are separately identified above; independent judgment is not relabeled as a final38 rebuild.

Platform and limits

Linux x86-64, built with Python3.12 on Ubuntu24.04-era glibc; compatible system libraries required, no installed Python needed. This is the offline command-line analysis package, not a capture desktop or hardware validation. Physical sensors, clinical accuracy, full-duration recordings, Windows/macOS binaries and native desktop operation are not certified by these checks. EMG index discontinuities identify recorded index changes; they do not establish an exact number of physically lost samples. Reports retain a source-oriented run_analysis.py example; use the executable command above for this bundle.

Exact full source archive, dependency versions, GPL license and third-party notices are supplied. This release is explicitly experimental and does not change GitHub's latest release pointer.