No project description provided
Project description
User guide and documentation
What can you do with the Python SDK?
- Search for the device.
- Check Device Battery
- Stream Impedance
- Connect and record data from the earbud.
- Get live insights of your data (raw eeg and filtered eeg)
- Get real time predictions of your data (fft, jaw clench)
- PS: Data feedback from Live insights and Realtime predictions has a latency estimate of approximately 1 second
- Download the data to your local machine.
- Generate Reports
- List all Recordings
- Delete Recording
Prerequisites
- Python 3.9 - 3.13
Quick installation guide
It is advised to create a new Python Virtual Environment:
python -m venv idun_env
source idun_env/bin/activate
Alternatively you can use third party tools such as Conda or Pipenv:
- First activate the virtual environment, this command must always be run before using the python SDK:
source idun_env/bin/activate
- After the environment is activated, install the Python SDK using the following command:
pip install idun-guardian-sdk
- After installing the package, make sure that the dependencies are correctly installed by running the following command and inspecting the packages installed in the terminal output:
pip list
You should see as output a package named idun-guardian-sdk
How to use the Python SDK
You can find sample scripts from this GitHub repository in examples
folder to do basic operations with guardian earbud.
Before getting started, to do any Cloud API operation you should have your IDUN API TOKEN. You can configure the token whether by setting IDUN_API_TOKEN
Environment Variable or by initializing GuardianClient
object in Python with api_token
argument:
Env Var:
export IDUN_API_TOKEN=my-api-token
or
my_api_token = "xxxxxx"
client = GuardianClient(api_token=my_api_token)
Pre Recording
1. Search the earbud manually
- To search for the earbud, you need to run the following command in your python shell or in your python script:
import asyncio
from idun_guardian_sdk import GuardianClient
client = GuardianClient()
device_address = asyncio.run(client.search_device())
-
Follow the steps in the terminal to search for the earbud with the name
IGEB
-
If there are more than one IGEB device in the area, you will be asked to select the device you want to connect to connect to, a list such as below will pop up in the terminal:
- For Windows:
----- Available devices ----- Index | Name | Address ---------------------------- 0 | IGEB | XX:XX:XX:XX:XX:XX 1 | IGEB | XX:XX:XX:XX:XX:XX 2 | IGEB | XX:XX:XX:XX:XX:XX ----------------------------
- For Mac OS:
----- Available devices ----- Index | Name | UUID ---------------------------- 0 | IGEB | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX 1 | IGEB | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX 2 | IGEB | XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX ----------------------------
-
Enter the index number of the device you want to connect to.
2. Check battery level
- To read out the battery level, you need to run the following command in your python shell or in your python script:
import asyncio
from idun_guardian_sdk import GuardianClient
client = GuardianClient()
battery_level = asyncio.run(client.check_battery())
print("Battery Level: %s%%" % battery_level)
**3. Check impedance values **
- To read out the impedance values, you need to run the following commands in your python shell or in your python script. PS: the
stream_impedance
will run until you manually stop by pressingCtrl + C
in your terminal:
import asyncio
from idun_guardian_sdk import GuardianClient
MAINS_FREQUENCY_60Hz = False
# mains frequency in Hz (50 or 60), for Europe 50Hz, for US 60Hz
# Get device address
client = GuardianClient()
client.address = asyncio.run(client.search_device())
# start a recording session
asyncio.run(
client.stream_impedance(mains_freq_60hz=MAINS_FREQUENCY_60Hz)
)
Recording
4. Start a recording
- To start a recording with a pre-defined timer (e.g.
100
in seconds), you need to run the following command in your python shell or in your python script:
import asyncio
from idun_guardian_sdk import GuardianClient
RECORDING_TIMER: int = 60 * 60 * 10 # 10 hours
LED_SLEEP: bool = False
my_api_token = ""
# Example callback function
def print_data(event):
print("CB Func:", event.message)
client = GuardianClient(api_token=my_api_token)
client.address = asyncio.run(client.search_device())
client.subscribe_live_insights(raw_eeg=True, filtered_eeg=True, handler=print_data)
# client.subscribe_realtime_predictions(fft=True, jaw_clench=False, handler=print_data)
# start a recording session
asyncio.run(
client.start_recording(
recording_timer=RECORDING_TIMER,
led_sleep=LED_SLEEP,
)
)
- To stop the recording, either wait for the timer to run out or interrupt the recording
- with Mac OS enter the cancellation command in the terminal running the script, this would be
Ctrl+.
orCtrl+C
- with Windows enter the cancellation command in the terminal running the script, this would be
Ctrl+C
orCtrl+Shift+C
- with Mac OS enter the cancellation command in the terminal running the script, this would be
Post Recording
5. Get all recorded info
At the end of recording, the recording ID will be printed, and you can use it to download the data.
If you somehow lose the terminal logs, you can still get info of previous recordings:
from idun_guardian_sdk import GuardianClient
client = GuardianClient()
# get a list of all recordings
recordings = client.get_recordings(status="COMPLETED", limit=10)
print(recordings)
6. Download recording
- To download the recoridng run the following command in your python shell or in your python script
from idun_guardian_sdk import GuardianClient, FileTypes
my_api_token = ""
my_recording_id = ""
client = GuardianClient(api_token=my_api_token)
client.download_file(recording_id=my_recording_id, file_type=FileTypes.EEG)
Generating Reports
Your recording must have at least 10 minutes of data so the reports can be generated
7. Generate Sleep Report for a Recording
To generate sleep report, you can call generate_and_download_sleep_report
from idun_guardian_sdk import GuardianClient
my_api_token = ""
my_recording_id = ""
client = GuardianClient(api_token=my_api_token)
client.generate_and_download_sleep_report(recording_id=my_recording_id)
8. Generate Daytime Report for a Recording
To generate daytime report, you can call generate_and_download_daytime_report
from idun_guardian_sdk import GuardianClient
my_api_token = ""
my_recording_id = ""
client = GuardianClient(api_token=my_api_token)
client.generate_and_download_daytime_report(recording_id=my_recording_id)
Development
- setup:
poetry install
- build package:
poetry build
- build docs:
make html
Project details
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
Built Distribution
Hashes for idun_guardian_sdk-0.1.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5aad75edcff2d610717ab0301b8e37d1218990ff40abda970efcd606eb255a16 |
|
MD5 | 32921475ba173b9ef3cc65ad0f2fe73c |
|
BLAKE2b-256 | ed0da57c1012cd316a143bebd9abc1001d9985ff4b951e1fc8a8cb4abd60f493 |