Skip to content

Getting Started

Getting Started with hdsemg-shared

This guide walks you through the first steps of using the hdsemg-shared application to inspect and clean your high-density surface EMG (HD-sEMG) data.

1. Launching the Application

After completing the installation, start the application with the following command:

python main.py

This will open the application window and display the dashboard interface.

Dashboard Empty

2. Loading Data

To load HD-sEMG data into the application:

  1. Open the file explorer: Go to File → Open… or press Ctrl + O.

  2. Choose a supported file: The application supports the following formats:

  3. .mat

  4. .otb+
  5. .otb4

  6. .otb

  7. The application will attempt to auto-detect the grid configuration. If this fails, you’ll be prompted to configure the layout manually.

  8. Once the file is recognized, a Grid and Orientation Selection dialog will appear:

  9. Select the appropriate grid (if multiple are detected).

  10. Choose the fiber orientation (whether rows or columns are aligned with the muscle fibers). If you're unsure, you can evaluate the orientation later by observing propagation patterns in the Signal Overview Plot and adjust it if needed.

Grid Orientation Dialog

  1. After confirming grid and orientation, the main dashboard will be displayed.

Dashboard

You can now navigate the grid using the bottom navigation buttons or your keyboard’s left/right arrow keys.

For a detailed overview of the dashboard features, see the Dashboard Guide.