Chords-Web#

Overview#

Chords-Web is an open-source web application designed for real-time signal visualization, particularly tailored for bio-potential signals like EEG, EMG, ECG and EOG. This tool serves as an advanced alternative to the standard Arduino IDE serial plotter, offering enhanced functionality for students, researchers and hobbyists alike who want to record biopotential data using BioAmp hardware.

Browser Compatibility#

The web application is compatible with the Web Serial API, which is essential for its functionality. Supported browsers include the latest versions of:

Google Chrome
Microsoft Edge
Opera

If the user’s browser does not support the Web Serial API, a message will inform them of the incompatibility, recommending the use of a supported browser.

For more information, refer to MDN Web Docs on the Web Serial API.

Software Requirements#

Arduino Firmware (Use this software to upload Chords Arduino firmware to your development board).
NPG Lite Flasher (Use this software to upload NPG Lite firmware to your NPG Lite board or any ESP32 based board).
Chromium-based browsers (Know more about Browser Compatibility).

Hardware Requirements#

A development board (see the list of Compatible Development Boards)
A USB cable (type depends on board)
BioAmp Hardware and its accessories

Setting up the hardware#

Make all the connections according to the hardware you are using, including sensor connections with the development board, body connections with the sensor, and connections from the development board to your laptop.

Uploading the code#

Connect your Arduino board to the laptop using a USB cable.
Open the Arduino Firmware for your board in the Arduino IDE.
Navigate to Tools > Board and select your board.
In the tools menu, choose the correct COM port (the one that disappears when the board is disconnected).
Upload the code and open Chords-Web in your web browser.

Once ready, upload the firmware to your development board. Visit the Chords Arduino Firmware GitHub repository, scroll to the supported boards table, locate your board, and click on the corresponding Arduino sketch.

Copy the sketch, paste it into the Arduino IDE, go to Tools, select your board and the correct COM port, then click the upload button.

To learn about how to flash the code on the NPG Lite Board, checkout:

NPG Lite Flasher

Opening Chords-web#

Open a Chromium-based browser like Google Chrome, Microsoft Edge, Opera, brave, etc.
Search chords.upsidedownlabs.tech .
Click on visualize now.
The images in the center show an overview of your hardware connections so far.
At the bottom, you can see buttons to access various applications, which are discussed below:

Applications#

Chords Visualizer#

The Chords Visualizer is a powerful web-based tool designed for seamless real-time biopotential signal acquisition and analysis. Designed for researchers, developers, and enthusiasts, this app provides an intuitive interface for monitoring multiple channels, applying advanced filters, and managing recorded data efficiently. Whether you’re analyzing EMG, ECG, EOG, or EEG signals, the app ensures a smooth and interactive experience, simplifying data acquisition and enhancing signal interpretation.

Features#

Feature	Description
Effortless Connectivity	Instantly detects BioAmp Hardware running Chords-Web Arduino Firmware, simplifying setup and ensuring smooth workflow from data acquisition to visualization.
Real-time Visualization	Experience smooth, real-time data rendering powered by WebGL-Plot. Ensures uninterrupted signal display for seamless data monitoring.
Frame Buffer & Snapshots	Stores the last five snapshots, with left/right controls for navigation. Changing the channel count resets snapshots for accuracy. Users can zoom in and out for detailed or broad views.
Recording & Data Management	Record data in CSV format indefinitely or with a timer. Manage files via a popover menu and download or delete them individually or as a ZIP with one click.
Zoom & Time Base	Use Zoom-In & Zoom-Out controls to focus on signal details. Adjust the Time Base Slider from 1 to 10 seconds per frame for flexible data visualization.
Filter Options	Enhance biopotential signals using the notch filter and bandpass filters. Apply them individually per channel or collectively via the master filter.
Channel Support	Supports real-time multi-channel plotting with color-coded streams. Accommodates up to 16 channels, depending on the connected device, for flexible biosignal applications.
One-Click Disconnect	Easily disconnect from the development board with a single click, ensuring a hassle-free disconnection process after data collection or visualization.

Chords-Web Icons#

Play/Pause Data Stream#

Clicking the pause button displays the last saved frame.
You can view and save up to the last five snapshots of your data.
Snapshots are automatically captured per frame.
Navigate snapshots using the left and right buttons.

Setting Channel Count#

The number of available channels depends on the development board in use.
Select a specific channel by clicking the channel button.
Use the “Select All” button to choose all available channels at once.
Click the reset button to revert to your previously selected channels.

Recording the Data#

Record data in CSV format for a set duration or indefinitely until manually stopped.
Start recording with a set time limit or record freely and stop anytime using the stop icon.
Efficiently download or delete recorded files through the popover menu.
Files are securely stored in IndexedDB for seamless management.
Manage individual files by downloading specific files and removing them as needed.
Easily download all files as a ZIP or delete them with a single click for seamless file management.

Visualizing EMG (Electromyography) signal#

EMG captures the electrical activity produced by skeletal muscles.

Visualizing EEG (Electroencephalography) signals#

EEG records the electrical activity of the brain and is commonly used for diagnosing neurological conditions and studying brain activity.

Visualizing EOG (Electrooculography) signals#

EOG measures the electrical potential generated by eye movements.

Visualizing ECG (Electrocardiography) signals#

The ECG (Electrocardiography) signal represents the electrical activity of the heart. This custom ECG signal is used both in clinical practice and research to evaluate heart rhythm, detect abnormalities, and assess cardiac health.

Other Options to Explore#

Switch Theme Quickly switch between light and dark modes using the theme button in the navigation bar.
Visit the GitHub Repository Access the Chords Web GitHub repository via the link in the navigation bar.
Contributors View the list of contributors using the link in the navigation bar’s top-right corner.

Running the Application#

Click the Visualize Now button to navigate to the applications page. Here, you will find two options.
Click the Chords Visualizer button to establish a connection with the Arduino and start streaming data.
Use the ZoomIn/ZoomOut buttons to adjust data visualization.
Use the Play/Pause button to control the data stream. Navigate the last five snapshots with the Left/Right buttons in the Frame Buffer feature.
Click the Record button to start recording data into a CSV file.
Click the Download button to save the recorded data.
Click the Delete button to remove recorded data.
Click the Filter button to apply filters for EMG, ECG, EOG, and EEG signals: - Muscle (70Hz high-pass for EMG) - Heart (30Hz low-pass for ECG) - Eye (10Hz low-pass for EOG) - Brain (45Hz low-pass for EEG) - Use the Master button to apply filters across all channels. - Apply 50Hz or 60Hz filters to individual or all channels.
Select channels via the Channels button in the settings popover.
Adjust zoom using the Zoom slider for a detailed or overall view.