Metadata-Version: 2.4
Name: pysio-hermes-tmsi
Version: 0.0.2
Summary: A TMSi SAGA support module for HERMES
Author: e-Media Research Lab @ KU Leuven
Author-email: Maxim Yudayev <maxim.yudayev@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://maximyudayev.github.io/hermes
Project-URL: Documentation, https://maximyudayev.github.io/hermes
Project-URL: Repository, https://github.com/maximyudayev/hermes-tmsi.git
Project-URL: Issues, https://github.com/maximyudayev/hermes/issues
Project-URL: Changelog, https://github.com/maximyudayev/hermes-tmsi/blob/main/CHANGELOG.md
Keywords: embedded ai,wearables,sensors,saga,tmsi,streaming,realtime processing,physiology
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pysio-hermes
Dynamic: license-file

# HERMES - TMSi SAGA

Support package to interface the [TMSi SAGA](https://www.tmsi.artinis.com/saga) commercial multimodal physiological signal acquisition device in [HERMES](https://github.com/maximyudayev/hermes), using OEM's open-source [Python SDK](https://artinis-medical-systems-b-v.github.io/TMSi-Documentation-Python-Interface/).

> [!NOTE]
> The 2023-2024 version of the OEM Python SDK is released under the Apache-2.0 license and is packaged as a dependency of this module under `hermes.tmsi.sdk` without changes to the source. A new version has [since been released](https://artinis-medical-systems-b-v.github.io/TMSi-Documentation-Python-Interface/), but not yet integrated nor tested.

> [!IMPORTANT]
> TMSi SAGA Python SDK is Windows-only and requires `Python>=3.9`.

## Installation
Node available under the same HERMES namespace of `hermes.tmsi` as `TmsiProducer`.

Follow [these instructions](https://artinis-medical-systems-b-v.github.io/TMSi-Documentation-Python-Interface/getting_started/installation.html) to prepare the desktop with necessary drivers.

### From PyPI
```bash
pip install pysio-hermes-tmsi
```

### From source
```bash
git clone https://github.com/maximyudayev/hermes-tmsi.git
pip install -e hermes-tmsi
```

## Usage
Using the device follows the standard [configuration file specification](https://maximyudayev.github.io/hermes/) process of HERMES nodes.

> [!NOTE]
> [These modalities](https://github.com/maximyudayev/hermes-tmsi/blob/main/src/hermes/tmsi/stream.py#L44-L87) are collected out-of-the-box. Change them and the [SDK configuration](https://github.com/maximyudayev/hermes-tmsi/blob/main/src/hermes/tmsi/producer.py#L132-L159) to add or replace modalities with sensors of choice.

## Citation
When using any parts of this repository outside of its intended use, please cite the parent project [HERMES](https://github.com/maximyudayev/hermes).
