Skip to content

UEF-SmartSleepLab/ODIN

Repository files navigation

ODIN

Observational Dashboard for Integrated Neurodata

ODIN is a visualization and post‑processing application designed to complement RAVEN.
It allows users to load EEG recordings, pair them with RAVEN‑generated annotations, and inspect, edit, or refine these events in an interactive editor environment.

ODIN serves as the second step in the analysis pipeline:
RAVEN → ODIN → Final curated dataset


🚀 Features

  • Load raw EEG signals from EDF and SLF recordings
  • Select, re‑reference, and prepare signals for visualization
  • Import event annotations generated by RAVEN
  • Display synchronized signals, hypnogram (optional), and detected events
  • Edit, add, or remove events with intuitive tools
  • Export refined annotations in the same structure used by RAVEN

📥 Download & Installation

✔ Option 1: Run directly from MATLAB

  1. Download all ODIN files into the same folder.
  2. Open MATLAB.
  3. Launch ODIN by opening: ODIN_app.mlapp

This is the fastest way to use ODIN, as it avoids loading the MATLAB Runtime.


✔ Option 2: Use the Installer

  1. Download the ODIN installer package.
  2. Install ODIN using the bundled installer.

Note:
Running ODIN via installer uses the MATLAB Runtime hosted on the server, resulting in slightly slower startup compared to running the .mlapp directly inside MATLAB.


🖥️ ODIN Editor Overview

🔍 Navigation & Event Exploration

  • Move between events
  • Scroll through the EEG timeline
  • Jump to points via the hypnogram
  • View detailed event information, including spectral content

✏️ Editing & Annotation Tools

  • Resize event boundaries
  • Add new events manually
  • Delete misclassified events
  • Track edited and added events separately
  • Save changes back to RAVEN‑compatible files

📊 Signal & Hypnogram Panels

  • Adjustable epoch length
  • Optional external hypnogram loading (XML, TXT/CSV)

🔄 RAVEN → ODIN Workflow

  1. Run RAVEN to generate sleep event annotations
  2. Load EEG + annotations in ODIN
  3. Review and refine events using visualization tools
  4. Export curated events for research or downstream analysis

About

Postprocessing and visualization tool for annotations made by RAVEN.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors