Nervous Sensors

Table of Contents

• Table of Contents
• Project Overview
  • Key Features
• Prerequisites
• Installation
• Command-Line Interface (CLI)
  • Usage
    • Options
  • Example Command
• Sensor Compatibility
• Contributing
• License
• Acknowledgments
• Contact

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

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

bertrand.massot@insa-lyon.fr