OpenSeizureDatabase Overview

Dataset Description

OpenSeizureDatabase is a collection of epilepsy seizure and seizure‑like event data contributed by OpenSeizureDetector users, aimed at enhancing seizure detection algorithms (Open Seizure Toolkit, OSTK). The data are stored separately and require an application for access.

License

• The dataset is released under a variant of the Creative Commons Share‑Alike license, requiring that any system descriptions and results derived from the data be publicly released to benefit the OpenSeizureDetector community.

Data Users

The following researchers have obtained access to the anonymized OpenSeizureDatabase data:

Researchers wishing to access the data should email osdb@openseizuredetector.org.uk, stating their intended use and commitment to comply with the license.

Installation Instructions

1. Create a folder named osd in the root directory and enter it.
2. Clone this repository (git clone https://github.com/OpenSeizureDetector/OpenSeizureDatabase.git).
3. Navigate to ~/osd/OpenSeizureDatabase.
4. Create a Python virtual environment (python -m venv ~/pyEnvs/osdb).
5. Activate the environment (source ~/pyEnvs/osdb/bin/activate).
6. Install dependencies (pip install -r requirements.txt; optionally remove the TensorFlow requirement).
7. Create a folder named osd/osdb in the root directory.
8. Copy the OSDB JSON text files into ~/osd/osdb.

Test Installation

1. Go to ~osd/OpenSeizureDatabase/user_tools/dataSummariser.
2. Rename osdbCfg.json.template to osdbCfg.json and adjust the configuration as needed.
3. Run python ./summariseData.py --index to generate output/index.html containing all database entries.
4. Run python ./summariseData.py --event=5483 to generate an output/Event_5483_summary folder with the event summary.

Documentation

For detailed information on data structures and software, see the Documentation. Sample datasets are located in the documentation folder.