WARNING: The current repository is deprecated since 28th June of 2019. For accessing the most recent update about biosignalsnotebooks project, please, visit our newest repository located at https://github.com/biosignalsplux/biosignalsnotebooks

Description

biosignalsnotebooks is a set of documents and a Python library to provide programming examples in the form of Jupyter Notebooks, as companion to the OpenSignals biosignals acquisition tools.

This collection of code samples has the purpose to help users of PLUX Wireless Biosignals systems, such as bitalino or biosignalsplux, and to the researcher or student interested on recording processing and classifying biosignals. The examples are set on a level of complexity to inspire the users and programmers on how easy some tasks are and that more complex ones can also be achieved, by reusing and recreating some of the examples presented here.

A Python library (entitled biosignalsnotebooks ) is the base toolbox to support the notebooks and to provide some useful functionalities. It can be installed through pip command, like demonstrated in a PyPI <img src="https://image.ibb.co/cNnx6V/link.png" width="10px" height="10px" style="display:inline"> dedicated page.

In many cases we also point and illustrate with code the usage of other python toolboxes dedicated to biosignal processing.

The notebooks will cover the full topics pipeline of working with biosignals, such as: Load a file; Visualise the data online and offline, Pre-Process a one channel signal or a multi-channel acquisition, Detect relevant events in the signals, Extract features from many different type of sensors and domains, Train and Classify among a set of classes with several machine learning approaches, Understand the obtained results with metrics and validations techniques.

These examples are carried in a multitude of biosignals , from ECG, EDA, EMG, Accelerometer, Respiration among many others. The notebooks have a set of labels to help navigate among topics <a href="http://biosignalsplux.com/notebooks/Categories/MainFiles/by_tag_rev.php"><img src="https://image.ibb.co/cNnx6V/link.png" width="10px" height="10px" style="display:inline"></a>, types of signals <a href="http://biosignalsplux.com/notebooks/Categories/MainFiles/by_signal_type_rev.php"><img src="https://image.ibb.co/cNnx6V/link.png" width="10px" height="10px" style="display:inline"></a>, application area <a href="http://biosignalsplux.com/notebooks/Categories/MainFiles/biosignalsnotebooks_rev.php"><img src="https://image.ibb.co/cNnx6V/link.png" width="10px" height="10px" style="display:inline"></a> and complexity <a href="http://biosignalsplux.com/notebooks/Categories/MainFiles/by_diff_rev.php"><img src="https://image.ibb.co/cNnx6V/link.png" width="10px" height="10px" style="display:inline"></a> level to support the search for particular solutions.

We encourage you to share new example ideas, to pose questions info@plux.info, and to make improvements or suggestion to this set of notebooks.

Be inspired on how to make the most of your biosignals!

Available Notebooks

<table width="100%"> <tr> <td width="20%" align="center"> Category </td> <td width="80%"></td> </tr> <tr> <td rowspan='2'><img src='https://i.ibb.co/4fBR4Q3/Install.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Install/prepare_anaconda_rev.php' target='_blank'> Download, Install and Execute Anaconda </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Install/prepare_jupyter_rev.php'> Download, Install and Execute Jypyter Notebook Environment </a> </td> </tr> <tr> <td rowspan='1'><img src='https://i.ibb.co/3yDZpxC/Connect.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Connect/pairing_device_rev.php' target='_blank'> Pairing a Device at Windows 10 [biosignalsplux] </a> </td> </tr> <tr> <td rowspan='4'><img src='https://i.ibb.co/d2jZH1s/Record.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Record/record_data_rev.php' target='_blank'> Signal Acquisition [OpenSignals] </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Record/resolution_rev.php'> Resolution - The difference between smooth and abrupt variations </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Record/sampling_rate_and_aliasing_rev.php'>Problems of low sampling rate (aliasing)</a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Record/store_signals_after_acquisition_rev.php'> Store Files after Acquisition [OpenSignals] </a> </td> </tr> <tr> <td rowspan='4'><img src='https://i.ibb.co/YPbCnzD/Load.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Load/open_h5_rev.php' target='_blank'>Load acquired data from .h5 file</a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Load/open_signals_after_acquisition_rev.php'> Load Signals after Acquisition [OpenSignals] </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Load/open_txt_rev.php'>Load acquired data from .txt file</a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Load/signal_loading_preparatory_steps_rev.php'>Signal Loading - Working with File Header </a> </td> </tr> <tr> <td rowspan='7'><img src='https://i.ibb.co/1rKWccX/Pre-Process.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/digital_filtering_rev.php' target='_blank'> Digital Filtering - A Fundamental Pre-Processing Step </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/emg_fatigue_evaluation_median_freq_rev.php'>Fatigue Evaluation - Evolution of Median Power Frequency</a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/generation_of_time_axis_rev.php'> Generation of a time axis (conversion of samples into seconds) </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/unit_conversion_ecg_rev.php'>ECG Sensor - Unit Conversion </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/unit_conversion_eeg_rev.php'>EEG Sensor - Unit Conversion </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/unit_conversion_emg_rev.php'>EMG Sensor - Unit Conversion </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Pre-Process/unit_conversion_fNIRS_rev.php'>fNIRS Sensor - Unit Conversion </a> </td> </tr> <tr> <td rowspan='2'><img src='https://i.ibb.co/rymrvFL/Detect.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Detect/detect_bursts_rev.php' target='_blank'> Event Detection - Muscular Activations (EMG) </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Detect/r_peaks_rev.php'> Event Detection - R Peaks (ECG) </a> </td> </tr> <tr> <td rowspan='1'><img src='https://i.ibb.co/tchq7Cc/Extract.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Extract/emg_parameters_rev.php' target='_blank'> EMG Analysis - Time and Frequency Parameters </a> </td> </tr> <tr> <td rowspan='4'><img src='https://i.ibb.co/CQ4cyGb/Train-and-Classify.png' width='50%' align='center'></td> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Train_and_Classify/classification_game_orange_rev.php' target='_blank'> Rock, Paper or Scissor Game - Train and Classify [Orange] </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Train_and_Classify/classification_game_volume_1_rev.php'> Rock, Paper or Scissor Game - Train and Classify [Volume 1] </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosignalsplux.com/notebooks/Categories/Train_and_Classify/classification_game_volume_2_rev.php'> Rock, Paper or Scissor Game - Train and Classify [Volume 2] </a> </td> </tr> <tr> <td align='center'> <a href='http://www.biosign

Biosignalsnotebooks

Install / Use

README

Description

Available Notebooks