Process Mode

Process mode is the workspace for reviewing, reprocessing, saving, and exporting previously recorded Vimotis data. Use this mode when an acquisition file already exists and you need to inspect signals, adjust processing settings, add markers, export data, or compare channels across files.

Process mode supports:

• loading recorded .h5 or .hdf5 files,
• reviewing wave-speed, calibrated-load, analog, correlation, and foot-contact views,
• updating processing parameters and calibration data,
• adding marker points to selected channels,
• saving reprocessed results back into the loaded HDF5 file,
• exporting CSV outputs and figures,
• running batch reprocess or export workflows, and
• comparing channels across files in the Evaluation window.

When Process mode is active, these unique process mode menu actions are available:

• File > Load: load a Vimotis HDF5 file.
• File > Save: save reprocessed results into the loaded HDF5 file.
• File > Export: open the CSV export dialog.
• File > Batch: open the Batch Process workflow.
• Edit > Calibration: open calibration settings for Process mode.
• Edit > Parameters: open normal processing parameters.
• Evaluate > Open: open the Evaluation window.

The current implementation loads HDF5 files with .h5 or .hdf5 extensions. If a file contains both live and reprocessed results, the user will be prompted with a pop-up to choose whether they wish to load Live data (as collected and viewed in real-time) or Reprocessed (post-processed and saved data).

Additionally, if a file is already loaded in the workspace, and the user chooses to load Live data, a dialog will pop up with options Keep Current or Reset Defaults.

• Keep Current allows the user to keep the processing parameters they set/loaded from the previous file in the workspace. Note that to apply these parameters to the new file, the user will need to run Reprocess All.
• Reset Defaults resets the workspace parameters to the defaul reprocessing parameters.

Reprocessed data is not saved by default to prevent loss of desired data when viewing or experimenting with different processing parameters. To save reprocessed data, choose File > Save. Reprocessed data is stored in the same file as the Live data. Only one set of Reprocessed data can be saved per file; any future saved reprocessing will overwrite old Reprocessed data. Once Reprocessed data has been saved, it may be chosen for viewing/reprocessing when loading that file in the future.

The main Process workspace includes a left-side channel selection area and plot tabs for reviewing the loaded file.

• Switch between Wave Speed and Calibrated Load using the dropdown in the upper-right of the main plot tab.
• Plot items can be hidden/revealed by clicking on the legend entry to toggle visibility.
• The x- and y-axis zoom is controlled by clicking and dragging in the direction and over the region of interest. Double-click to reset the axes.

The left-side channel control area is used to choose which channels are visible and which channel is active for marker editing.

1. Channel check boxes determine which wave-speed and analog signals are visible.
2. I DON'T THINK WE ACTUALLY WANT TO EXPOSE THIS ANYMORE.
3. The Add Markers controls choose the active wave-speed or analog channel for marker editing.
4. Set the low-pass cutoff for processed load data. The default (recommended) cutoff is 12Hz.
5. The Reprocess All control recalculates selected wave-speed outputs with the current processing settings.
6. Analog data aquired on auxiliary AI ports are displayed on separate axes below the load plot. Optional low/high/bandpass filtering can be applied to these data on a per-channel basis.
7. For relevant datasets, foot contacts. These are estimated using alternative processing of the raw tensiometer data and should only be used as estimates.

DO WE WANT TO EXPOSE THIS STILL?

For gait tasks, foot contacts may be optionally estimated. To enable, check the foot contacts box in the left channel bar. The channel source for the foot contacts may be selected from the dropdown, or each channel may be assigned a foot contact source if Per-Channel Sources is selected.

1. Choose which channel is shown for foot contact estimation from the dropdown.

2. The foot contact detection uses features in an accelerometer signal to estimate ground impact. Depending on the task and sensor location, the parameters to isolate foot contact features may require optimization. The available parameters are:

   1. Band Low/High [Hz]: Bandpass filter cutoffs.
   2. Prominence: Amplitude of feature peak relative to local minima.
   3. Refractory [s]: Minimum permitted time between foot contact events. For example, during high-cadence running, the time between events will be much shorter than walking, so a shorter refractory should be used.
3. Foot contact event detection may be edited diretly by single-clicking on peaks to add or remove them. Recomputing foot contacts after changing parameters will remove manually edited events.

Markers may be added per-channel to denote timing or specific features of interest. These are exported in a column vector time-synced with the rest of the data for external proecessing. Note that in marker mode, the standard x/y zoom interaction is toggled with the associated button.

Markers are saved with reprocessed results and included in CSV exports when the Markers export option is selected.

The Process Parameters window supports per-sensor editing of processing settings.

Use Reprocess All in the main app window after changing parameters when the loaded data should be recalculated with the updated settings.

File > Export opens the CSV export dialog.

The application warns before overwriting existing CSV files.

File > Batch opens a guided workflow that can run in two modes: Reprocess Files and Export Existing CSV Only. Export Existing CSV Only is intended for use when only the export function is required. The workflow is organized into four steps:

1. Select Files: choose a source folder and move files into the Files To Reprocess or Files To Export list.

   

2. Confirm Parameters: review or seed processing parameters and calibration values when reprocessing. This step is skipped in Export Existing CSV Only mode.

   Option	Description
   Reprocess Parameters	Opens the Processing Parameters dialog. These parameters are applied to all files.
   Seed From File	Applies the processing parameters from the selected file to all files. May choose between Live and Reprocessed if available.
   Seed From Workspace	Applies the processing parameters from the workspace. The intended use case is: load an individual file to the workspace. Modify processing parameters until desired results are achieved. Run the batch wizard and apply workspace parameters to batch.

   

3. Save and Export: choose the batch mode, data source, CSV outputs, summary plots, and foot-contact options.

   These options mirror those in the Export dialog.

   Additionally, choose whether to compute foot contacts for the batch files. As with the workspace [Foot Contact]() options, these can be sourced from a single channel for all channels (e.g. all sensors/signals associated with the right leg), or applied independently to each channel (e.g. bilateral measurements).

   An optional summary plot may be selected to show all processed data after the batch runs.

   

4. Review and Run: confirm the selected files, parameter/calibration sources, and export options before starting.

Always review the summary before running the batch, as previously reprocessed data in batch files will be overwritten. Once you have confirmed the details, choose Run Reprocess. The progress bar at the bottom of the wizard will show the batch progress.

When a file is saved from Process mode, the application writes reprocessed outputs back into the loaded HDF5 file.

Current saved outputs can include:

• reprocessed wave-speed data under the reprocessed wave-speed result path,
• processing parameters,
• reprocessed calibration data,
• foot-contact vectors and related debug data when generated, and
• marker data.

CSV filenames include the loaded file stem and the selected data-source token:

• Main CSV: {stem}_{source_token}_postprocess.csv
• Full-rate analog CSV: {stem}_{source_token}_postprocess_full_ai.csv
• Calibration CSV: {stem}_{source_token}_postprocess_calibration.csv

If reprocessed data already exist in the file, the user is prompted before it is overwritten.

The Evaluation window can be accessed via the Evaluate > Open menu. This tool is intended to allow for quick comparisons of data across one or more files and should not be a substitute for a more thorough data processing pipeline.

1. Add Files... loads one or more HDF5 files into the comparison set.
2. Remove Selected removes highlighted files from the comparison set.
3. Clear removes all loaded files.
4. Wave Speed Display dropdown toggles between wave speed an load.
5. Export Figure opens the Export Figure dialog.

6. Check/uncheck boxes to add/remove channels on the plot. Double-click on a channel name to assign an alias to the channel. This alias does not change the underlying data but can be useful to clarify the plot legend.

Analog channels are plotted on a separate axis below the wave speed / load axis.

7. Shows the active comparison channels. Drag and drop items in this list to reorder the plot entries and legend.

8. If foot contacts have been computed for the loaded files, checking the box will time-normalize each stride to 0-100% gait cycle.
9. Strides may be plotted in aggregate (all strides not eliminated by the outlier threshold) or as an ensemble average.
10. Based on leave-one-out analyses at each point in the gait cycle, strides in which the number of outlier points exceeds the threshold (default 30%) are excluded from the plot and ensemble average.

11. Align by event is an alternative to foot-contact based alignment for non-repetitive tasks (e.g. jumping, pitching). Choose Configure to launch the Align by Event wizard.

    1. Configure event alignment

       1. Alignment: choose One Point or Two Points. One Point identifies a single point in each channel and translates all traces such that the selected point in each channel is aligned. Two Points both translates and linearly warps each channel so that both selected points are aligned across channels.
       2. Point Type: options are Peak, Trough, or Manual. Peak and Trough will identify the nearest feature of matching type when selecting. Manual will place the point at the location clicked.
       3. When plotting multiple channels from the same file, you may choose to apply the alignment point(s) across those channels or set them independently.

    

    2. Choose points

       For each channel, select the desired alignment point(s), using Next to proceed through each plot. To adjust a selected point, use the upper-left dropdown to choose which point you want to adjust, then reselct the correct location. Once all points have been selected for all channels, choose Finish

    

    3. Once the pipeline is complete, the checkbox will be enabled to toggle the event alignment.

The Export Evaluation Figure dialog is used to configure plot output before saving a comparison figure.

1. Output type: Selects Bitmap or Vector (SVG).
2. Plot title and axis labels: Sets the title and axis text used in the exported figure. These are applied only in the export preview and will not impact the main Evaluate window plot.
3. Axis ticks: Set location of axis ticks. For an evenly spaced range, use the syntax [low:step:high].
4. Font sizes: Independently control font size for title, labels, and legend.
5. Legend placement: Sets where the legend appears in the exported figure.
6. Export theme: Selects the visual color theme used for output, Dark or Light

7. Size preset: Options for exported figure size, selects Half-Slide, Full-Slide, or Manual. Half-Slide and Full-Slide are based on standard Powerpoint slide dimensions. If Manual is chosen, additional options are exposed:

   1. Units: Selects pixels, millimeters, or inches.
   2. Dimensions: Width and height of exported figure in specified units.
   3. DPI: Controls bitmap export resolution (if Output type is Bitmap)
8. Preview: Shows a live preview of the configured figure (resolution will be lower than exported image).

Vector export saves SVG. Bitmap export supports PNG and JPEG.