Epilepsy research · Open source

From complex
signals to
visible evidence.

A workbench for exploring intracranial EEG. Compare models, inspect the signal behind a ranking, and keep disagreements in view.

Research prototype · Public and synthetic data · No treatment recommendations

ONSET / SIGNAL EXPLORERCONCEPTUAL VIEW
A conceptual brain network connected to signal tracesStylized brain contours and recording nodes connect to three illustrative signal traces. This is a system illustration, not anatomical mapping or patient data. 01 / RECORD02 / COMPARE03 / INSPECT THE EVIDENCE CH 01CH 02CH 03 ILLUSTRATION
Signal → model → evidenceHuman interpretation stays central
05Synthetic patients
48Contacts per patient
02Baseline rankers
10 sEvidence windows
01 / Inside the workbench

One signal.
An inspectable path.

Follow the working Python pipeline from a generated recording to a finding you can inspect. Select a step to see what happens inside.

THE IMPLEMENTED PIPELINEPYTHON · MNE · SCIKIT-LEARN · STREAMLIT
onset/synth.py

Build a recording with known labels.

MNE creates five virtual patients with background activity, interictal spikes, fast bursts, a seizure, and noisy contacts. The labels are known because the data are synthetic.

The current assistant uses Python rules. LLM agents, a clinical database, and an immutable run registry are future extensions.

DATA / P01 · SEED 100SYNTHETIC RECORDING
Three generated SEEG traces comparing background activity, an onset-zone contact with transients, and a noisy contact.
Actual output from the project’s synthetic generator. A selected two-second interval; each trace uses its own vertical scale. No patient data.
02 / Look at the signal

A ranking is a starting point.
The waveform matters.

A large transient, a high-frequency burst, and a noisy contact can look very different in context. A single score cannot tell the whole story.

Onset connects each model’s ranking to selected signal windows, so you can explore what sits behind the output. These windows are examples associated with the score—not proof of a clinical conclusion.

BackgroundLabeled contactAdded noise
Open the synthetic signal viewer ↗
03 / The question behind the project

Less searching.
More room to examine.

Epilepsy evaluation combines signals, imaging, clinical history, and expert interpretation. This prototype explores one narrow task: making model evidence easier to find and compare.

01 / COMPARE

See both perspectives.

View two model rankings side by side. Differences stay visible rather than disappearing into an average.

Open the patient view ↗
02 / TRACE

Return to the recording.

Move from a contact to its model-specific evidence window. Examine signal quality and the surrounding context.

Understand the evidence →
03 / EXPLAIN

Make the limitations visible.

A structured report brings together findings, disagreements, data quality, and limitations. It does not recommend treatment.

Explore a report ↗

This is a proposed workflow benefit, not a measured clinical result. Onset has not demonstrated time savings or improved patient outcomes. See how we would test its usefulness.

04 / Beyond synthetic data

The same question,
asked of real patients.

Onset-HFO carries these methods onto public intracranial recordings from twenty patients who went to epilepsy surgery. The archive ships expert-marked high-frequency oscillations, the contacts the surgeon removed, and whether the seizures stopped — so a ranking can be checked against something other than another algorithm.

The channel generating the most fast ripples sat inside the resected tissue in 11 of 13 patients who became seizure-free, against 3 of 7 whose seizures returned: AUC 0.71, p = 0.12. Thirteen against seven cannot establish that, and an earlier analysis of the first 60 seconds of the same recordings said something stronger. Both tables are published side by side, because the disagreement between them is the finding.

Open the real-data app

Two public CC0 archives · 41,187 expert-marked events · Underpowered, and says so

05 / An open research foundation

A small prototype.
A larger set of questions.

Developed in the Brain–Machine Interfaces Lab at Nazarbayev University, led by Berdakh Abibullaev. Onset connects localization-model research with the practical work of presenting traceable evidence.

Two repositories, both open. Onset is the synthetic workbench this page describes, built to be read end to end. Onset-HFO runs the same ideas against public patient recordings and publishes what they are worth. See also the interactive design mockup for a proposed future interface.

Open source · MITSynthetic and public dataPatient-held-out evaluation
What is implemented, and what comes next?

Implemented: synthetic MNE recordings, bipolar features, two baseline rankers, leave-one-patient-out evaluation, deterministic reports, a rule-based assistant, and the Streamlit interface.

Implemented in Onset-HFO: loaders for two public CC0 iEEG archives, two HFO detectors that differ only in the feature they threshold, artifact rejection on each event’s own spectrum, scoring against 41,187 expert-marked events, the surgical-outcome study, and an assistant on an open-weight model that must cite the results and is refused by code when it strays.

Proposed: authorized clinical-data ingestion, persistent versioned runs, access control, audit, and bounded LLM tools. The downloadable Qwen example is an optional teaching lab, not part of the live assistant. Clinical usefulness remains to be evaluated.

Read the research and validation roadmap →