EMG Sensor - Unit Conversion

Difficulty Level:

The OpenSignals outputted file formats contain raw data, so each sample has a digital unit.

In scientific terms it is recommended the use of specific units, like electric tension (V) or electric current (A). Each sensor that PLUX commercialise has a datasheet where a transfer function is mentioned for unit conversion be done.

The next lines are intended to explain how this conversion can be programmatically done.

In spite of the unit conversion procedure has some common steps applicable to all sensors, the current Jupyter Notebook is dedicated to the unit conversion procedure of signals acquired with EMG sensor.

1 - Importation of the needed packages

# biosignalsnotebooks Python package with useful functions that support and complement the available Notebooks
import biosignalsnotebooks as bsnb

# Function used for creating a numpy array, where a mathematical operation can be applied to each entry 
# in an easy and automatic way. On the other side, linspace, here will be used for generation of a time-axis.
from numpy import array, linspace

2 - Download of the sensor datasheet (from https://www.biosignalsplux.com/index.php/learn/documentation ). In this case we are working with EMG, being our file located at http://www.biosignalsplux.com/datasheets/EMG_Sensor_Datasheet.pdf

# Embedding of .pdf file
from IPython.display import IFrame
IFrame(src="/images/pre-process/unit_conversion_emg/EMG_Sensor_Datasheet.pdf#page=2", width="100%", height="350")

3 - Extraction of the transfer function from the beginning of the second page

\begin{equation} EMG_{mV} = \frac{(\frac{ADC}{2^n} - \frac{1}{2}).VCC}{G_{EMG}} \end{equation}

$EMG_{mV}$ - EMG value in mV	$ADC$ - Digital value sampled from the channel (initialism of "Analog to Digital Converter")	$n$ - Number of bits of the channel (dependent on the chosen resolution specified on OpenSignals previously to the acquisition stage [8, 12 or 16 bits])
$VCC$ - 3000 mV	$G_{EMG}$ - 1000

4 - Loading of data stored in biosignalsnotebooks own signal library

# Data loading
data, header = bsnb.load_signal("https://drive.google.com/file/d/1Y1k9niWLCWh1PaCCZFi2VLvUp7qwdVsU/view?usp=sharing", get_header=True)

In the following cell, some relevant information is stored inside variables. This relevant information includes the mac-address of the device, channel number and signal acquisition parameters such as resolution and sampling rate.

For a detailed explanation of how to access this info, the "Signal Loading - Working with File Header" Notebook should be consulted.

mac = "00:07:80:79:6F:DB" # Mac-address
ch = "CH1" # Channel
sr = 1000 # Sampling rate
resolution = 16 # Resolution (number of available bits)

Access to acquired signal samples and storage inside a new variable.

signal = data[ch]

5 - Final unit conversion (to mV ) by applying the transfer function sample by sample

Definition of $VCC$ and $G_{EMG}$ constants

vcc = 3000 # mV
gain = 1000

signal_mv = (((array(signal) / 2**resolution) - 0.5) * vcc) / gain

6 - Time axis generation

time = bsnb.generate_time(signal_mv, sr)

Comparison between RAW and mV signal.

bsnb.plot([time, time], [signal, signal_mv], y_axis_label=["Raw Data", "Electric Voltage (mV)"], grid_lines=1, grid_columns=2, grid_plot=True)

Similar Notebooks , dedicated to the unit conversion of other sensors, are available in the following "conversion" section of Notebooks Grouped by Tag page

A list of PLUX's available sensors (and the respective datasheets) can be accessed at Sensors page .

We hope that you have enjoyed this guide. biosignalsnotebooks is an environment in continuous expansion, so don"t stop your journey and learn more with the remaining Notebooks !

☌ Project Presentation
☌ GitHub Repository
☌ How to install biosignalsnotebooks Python package ?
☌ Signal Library

☌ Notebook Categories
☌ Notebooks by Difficulty
☌ Notebooks by Signal Type
☌ Notebooks by Tag

from biosignalsnotebooks.__notebook_support__ import css_style_apply
css_style_apply()

.................... CSS Style Applied to Jupyter Notebook .........................