Skip to main content

High level Python module for EEG/EMG/ECG acquisition and distributed streaming for OpenBCI Cyton board.

Project description

Developed by Yeison Nolberto Cardona Álvarez
Andrés Marino Álvarez Meza, PhD.
César Germán Castellanos Dominguez, PhD.
Digital Signal Processing and Control Group | Grupo de Control y Procesamiento Digital de Señales (GCPDS)
National University of Colombia at Manizales | Universidad Nacional de Colombia sede Manizales


OpenBCI-Stream

High level Python module for EEG/EMG/ECG acquisition and distributed streaming for OpenBCI Cyton board.

GitHub top language PyPI - License PyPI PyPI - Status PyPI - Python Version GitHub last commit CodeFactor Grade Documentation Status

Consist in a set of scripts which deals with the configuration and connection with the board, is compatible with both connection modes supported by Cyton: RFduino (Serial dongle) and WiFi (with the OpenBCI WiFi Shield). These drivers are a stand-alone library that can be used to handle the board from three different endpoints: (i) a Command Line Interface (CLI) with simple instructions configure, start and stop data acquisition, debug stream status and register events markers; (ii) a Python Module with high-level instructions and asynchronous acquisition; (iii) an object-proxying using Remote Python Call (RPyC) for distributed implementations that can manipulate the Python modules as if they were local, this last mode needs a daemon running in the remote host that will be listening connections and driving instructions.

The main functionality of the drivers reside on to serve a real-time and distributed access to data flow, even on single machine implementations, this is achieved by the implementation of Kafka and their capabilities to create multiple topics for classifying the streaming, these topics are used to separate the neurophysiological data from the event markers, so the clients can subscript to a specific topic for injecting or read content, this means that is possible to implement an event register in a separate process that stream markers for all clients in real-time without handle dense time-series data. A crucial issue stays on time synchronization, is required that all system components in the network be referenced to the same local real-time protocol (RTP) server.

Main features

  • Asynchronous acquisition: Acquisition and deserialization is done in uninterrupted parallel processes, in this way the sampling rate keeps stable as long as possible.
  • Distributed streaming system: The acquisition, processing, visualizations and any other system that needs to be feeded with EEG/EMG/ECG real-time data can be run with their own architecture.
  • Remote board handle: Same code syntax for develop and debug Cython boards connected in any node in the distributed system.
  • Command line interface: A simple interface for handle the start, stop and access to data stream directly from the command line.
  • Markers/Events handler: Beside the marker boardmode available in Cyton, a stream channel for the reading and writing of markers are available for use it in any development.

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

openbci-stream-1.0.0rc13.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openbci_stream-1.0.0rc13-py3-none-any.whl (45.0 kB view details)

Uploaded Python 3

File details

Details for the file openbci-stream-1.0.0rc13.tar.gz.

File metadata

  • Download URL: openbci-stream-1.0.0rc13.tar.gz
  • Upload date:
  • Size: 38.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

File hashes

Hashes for openbci-stream-1.0.0rc13.tar.gz
Algorithm Hash digest
SHA256 4b859237e917901ae51c566a82dbc3e13f2e94c3950cba570df866ee7983d444
MD5 c47c233c2cfea2c053e569218d916bab
BLAKE2b-256 23486d7556adf59e9e1b7877d3db07cb136a8f4054ff17aa41b70d6c2bcced70

See more details on using hashes here.

File details

Details for the file openbci_stream-1.0.0rc13-py3-none-any.whl.

File metadata

  • Download URL: openbci_stream-1.0.0rc13-py3-none-any.whl
  • Upload date:
  • Size: 45.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.2

File hashes

Hashes for openbci_stream-1.0.0rc13-py3-none-any.whl
Algorithm Hash digest
SHA256 a74f19ef998210e23ca25d616fe20067999f36abcc7fc8b07886d0b2172ff7fb
MD5 1270dfb0cee3ab2d255fb0b73c0dc00d
BLAKE2b-256 260752f416807b018850b2ea626db16481ad52c5cc0113dcc2269fc6f9e86639

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page