Python API for Mentalab biosignal aquisition devices
Project description
Explorepy overview
Explorepy is an open-source Python-based biosignal acquisition API for Mentalab’s Explore device. It provides users the following features:
Real-time streaming of ExG, orientation and environmental data
Real-time visualization
Data recording in CSV and BDF+ formats
LSL integration
Impedance measurement
Explore device configuration
Quick installation
Requirements
Python 3.5 or newer version
pybluez 0.22 (check their repo for the requirements of pybluez)
Please check installation page for more detailed instruction.
To install explorepy from PyPI run:
pip install explorepy
To install the latest development version run:
pip install git+https://github.com/Mentalab-hub/explorepy
Get started
CLI command
explorepy acquire -n Explore_XXXX
Enter explorepy -h for help.
Python code
The following code connects to the Explore device and prints the data.
import explorepy explorer = explorepy.Explore() explorer.connect(device_name="Explore_XXXX") # Put your device Bluetooth name explorer.acquire()
You can also visualize signals in real-time.
import explorepy explorer = explorepy.Explore() explorer.connect(device_name="Explore_XXXX") # Put your device Bluetooth name explorer.visualize(bp_freq=(.5, 30), notch_freq=50)
EEG:
ECG with heart beat detection:
Documentation
To see full documentation of the API, visit: https://explorepy.readthedocs.io/
License
This project is licensed under the MIT license.
Changelog
1.0.0 (22-05-2020)
Add ExploreSDK as the Bluetooth interface
New dark theme
Record module in dashboard
Improvement in visualization perfrmance
CLI migration to Click
0.6.0 (17-02-2020)
EDF (BDF+) file writer
Channel disable/enable feature
Calibration of movement sensors
Extraction of physical orientation (angle and rotation)
Soft marker event
Visualization performance enhancement
Automatic number of channel and sampling rate detection
Exception handling improvement
Command for soft reset of Explore
Marker visualization
0.5.0 (25-11-2019)
Impedance measurement
Send commands to device
Configuring device settings
Update push to lsl feature
0.4.0 (09-09-2019)
Added marker feature
Timer based recording
Fixed a bug in csv file writer
Fixed a bug in device reconnect
Improved performance of dashboard visualization
0.3.1 (28-05-2019)
Fixed a bug in 8-channel ExG packet conversion
Fixed a minor bug in the record function
Updated the documentation
0.3.0 (10-05-2019)
Explore dashboard
Real-time visualization of ExG and orientation signal
Device information in Dashboard
Environmental data (battery, temperature and light)
Real-time bandpass filter
New packet structures (ADS1294R & ADS1298R)
Heart rate estimation and R-peaks detector in dashboard
0.2.0 (2019-03-08)
Added real-time recording feature
Added Command Line Interface
Added lsl integration
Added new packet classes
Fixed reconnect issues
Removed input requests inside functions
0.1.0 (2019-01-18)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for explorepy-1.0.0-cp37-cp37m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0855cae1b58fe6c7af5d4a8a35f5bb43e3d4b5ee53690a0ad12d2270c3f96da2 |
|
MD5 | 03bb7db7eff85fa76f49ab1e336978cc |
|
BLAKE2b-256 | 208e19cfc31a28d865aef288de5c65b6dadc5ea9e996d059a778588ff6aff268 |
Hashes for explorepy-1.0.0-cp36-cp36m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7a5f5a826a6db00cd583460c09ea6adc4b11c6aa0a8524f9a8a56f9aeeaeb2f1 |
|
MD5 | f1912c3de594cd5aed76cd225883ce07 |
|
BLAKE2b-256 | 2436a6282e0a16edd8d8797a756980ef73c1d72b2266fa494b4082f69a738b24 |
Hashes for explorepy-1.0.0-cp35-cp35m-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c454cff2e31571f70176cc35ab956b36dc29c1b578b2fbe83f9236afbfa606f |
|
MD5 | 6f594fab3dd7f6ed80be82ce15b69591 |
|
BLAKE2b-256 | e9fb7396afc08e6201aebfdb029b0708ddcd1fc894c36607bd1263800163639d |