Skip to main content

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

Project description

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.0rc2.tar.gz (36.3 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.0rc2-py3-none-any.whl (43.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for openbci-stream-1.0.0rc2.tar.gz
Algorithm Hash digest
SHA256 979f79f8aa434140299d2386d5a07342fc5786c8f078cba4c1dbde7173bd0ec8
MD5 2138f75a295188a1c727aa9008153187
BLAKE2b-256 7496162fb751c67476653882ce8117b0c293213daf40ce12eee687a355ae0af7

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for openbci_stream-1.0.0rc2-py3-none-any.whl
Algorithm Hash digest
SHA256 13d27cce368bc535915fe1951715ccfe7b3710872c7ac2eff6036753c9050c59
MD5 e6f376e102b476ea4ad5c612a5af208e
BLAKE2b-256 1fcb3ccfa36d20332392e08ea8133e453a1aeb867179fdcbdf29c39cf5ce25c0

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