Open Earable Python

Python toolkit for parsing and analyzing multi-sensor OpenEarable recordings.

Installation

pip install open-earable-python

For local development:

git clone https://github.com/OpenEarable/open-earable-python.git
cd open-earable-python
python -m venv .venv
source .venv/bin/activate
pip install -e .

Quick Example

from open_earable_python import SensorDataset

dataset = SensorDataset("recording.oe")

# Combined time-indexed DataFrame of all parsed sensors
df = dataset.get_dataframe()

# Per-sensor views
imu_df = dataset.imu.df
ppg_red = dataset.ppg["ppg.red"]
audio_df = dataset.get_audio_dataframe()

Documentation

• Documentation index
• Getting started
• Data model and sensor channels
• API reference

License

MIT. See LICENSE.