Add privacy-conscious waveform fixture extractor#29
Draft
sslnevefocusrite wants to merge 2 commits into
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a standalone extraction utility and a double-click Windows application for
creating compact waveform-only HDF5 fixtures from EyeFlow outputs. This enables
beat-detection and waveform-metric robustness testing without transferring
complete acquisition files.
Windows release:
EyeFlow Waveform Fixture Extractor 0.1.0
What changed
tools/extract_waveform_fixture.pywith file, folder, recursive,dry-run, overwrite, and size-limit modes.
Extract fixtures actions.
timing, and optional per-beat signals.
indexes.
fixtures and to reuse duplicates safely.
maps, filenames, and acquisition metadata.
warning.
to the README.
duplicate reuse, malformed inputs, recursive discovery, GUI validation, and
GUI extraction.
Why
Full EyeFlow outputs can be hundreds of megabytes and may contain patient or
acquisition metadata that is unnecessary for beat-detection and waveform-metric
robustness testing. This utility produces small, purpose-limited fixtures while
making clear that metadata removal does not make clinical waveforms
non-sensitive.
Validation
allow-listed datasets.
attributes, or the full retinal velocity volume.
Privacy and signing
Extracted waveforms remain patient-derived and potentially sensitive. They
should not be uploaded to a public repository without explicit approval.
The downloadable executable is not code-signed. Windows SmartScreen may show an
unrecognized-app warning; the release includes a SHA-256 checksum for
verification.
This remains a draft so the fixture contract and privacy boundary can be
reviewed before merge.