Karas Lab:FREEZ Module
Frequency Range Explorer of the Epileptogenic Zone (FREEZ)
FREEZ Web App Demo
Explore FREEZ with sample patient data through our Web App Demo to experience its powerful visualization and analysis features.
Overview of FREEZ
FREEZ is an innovative software tool for identifying the epileptogenic zone (EZ) using intracranial electroencephalography (iEEG) signals. FREEZ integrates spectral power data across six frequency bands through a stacked random forest ensemble (SRFE) algorithm, improving accuracy in electrode classification and iEEG data analysis. The tool offers a user-friendly web interface, enabling both visualization and reproducible analysis, making it accessible to researchers and clinicians alike. See our preprint for more module details as well as validation: FREEZ Pre-print
Getting Started
- 1. Install RAVE
To begin, follow the RAVE installation guide here: RAVE Installation Guide. - 2. Patient Pre-Processing
Prepare patient data in RAVE format by following these tutorials: RAVE Tutorials. - 3. Download our Docker and Connect to Local Patient Data
Run FREEZ using Docker. Full instructions for setup are available here: FREEZ Docker Guide.
Find the code GitHub repository here: Github.
Please use Zenodo for citation of this software tool: Zenodo Publication
FREEZ Module Capabilities
- Spatiotemporal Power Analysis
Visualize the mean power across frequency bands using the multitaper method. Customize frequency ranges, analysis windows, and baselines for comparative studies. - EZ Localization and Visualization
The stacked Random Forest Ensemble (SRFE) model identifies likely EZ locations by comparing power levels across frequency bands, highlighting significant differences between seizure-free and non-seizure-free cases. The model’s validation achieved high specificity for identifying EZ electrodes. - Script-Based Data Analysis
Perform advanced data analysis by leveraging module capabilities directly in R. This allows seamless integration of FREEZ tools into your analysis pipelines. For an example of how to use these scripts, visit: FREEZ Pipelining Example.
Key Visualizations and Tools
- 3D Brain Mapping
Visualize annotated and resected electrodes over patient-specific or template brain models, mapping spectral power dynamics in interactive 3D views. - Heatmaps and Time-Frequency Plots
Generate heatmaps and AUC plots for spectral power, comparing SOZ vs. non-SOZ electrodes over time and across frequency bands. - Power-over-Time and Quantile Analysis
View power distribution over selected time windows, overlaying data for seizure-free and non-seizure-free cases for comparison.
