Skip to content

sensors-inl/Nervous-Sensors

Repository files navigation

Nervous Sensors

PyPI version Python Versions Build Status License: MIT

Table of Contents


Project Overview

Nervous Sensors is a Python-based driver and data acquisition toolset for physiological sensors, specifically designed for Nervous ECG (Electrocardiography) and Nervous EDA (Electrodermal Activity) sensors developed in the frame of the Nervous Toolkit.

Key Features

  • 📱 Bluetooth Low Energy (BLE) sensor support
  • 📈 Real-time data visualization via local webserver
  • 💾 Flexible data storage (CSV export)
  • 📣 LSL (Lab Streaming Layer) integration for PLUME Unity plugin
  • 🔗 Multi-sensor connection capabilities

Prerequisites

  • Python 3.11, 3.12 or 3.13
  • Compatible Bluetooth Low Energy Nervous sensors

Installation

pip install nervous-sensors

Command-Line Interface (CLI)

Usage

nervous [OPTIONS]

Options

Option Description Example
-s, --sensors Specify sensors to connect (by serial number) "ECG 6543","EDA 7201"
-g, --gui Enable real-time data graph in web browser
-f, --folder Save CSV data files to specified folder ./data/csv/
-l, --lsl Send sensor data to LSL outlets
-p, --parallel Set number of parallel connection attempts

Example Command

# Connect to multiple sensors, enable GUI, save to CSV, and activate LSL
nervous -g -f ./data/csv/ -l -s "ECG 6543","EDA 7201"

Sensor Compatibility

  • Nervous ECG Sensors
  • Nervous EDA Sensors

Contributing

Contributions are what make the open-source community such a great place to learn, inspire, and create. Any contributions you make are greatly appreciated. You can open an issue to report a bug, request a feature, or submit a pull request.


License

This project, along with the entire Nervous initiative, is licensed under the MIT License. For more details, see the License file.


Acknowledgments

The main contributors to this project are Bertrand Massot, Tristan Habémont and Hugo Buy from INSA Lyon, CNRS, INL UMR 5270, Villeurbanne, France.

This work was supported by the French National Research Agency (ANR) under grant ANR-22-CE31-0023-03 RENFORCE.


Contact

[email protected]


About

A Python package for connecting to the Nervous ECG and EDA sensors

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •