This package automatically analyzes complex ERP and source localized EEG experiment structures off minimally processed time series data. Integration after epoching with EEGLAB. Source localized EEG is calculated with dsi.

Scalp Topoplot
Overlaid ERP	Grouped Bar Plots

Brain Map	Network Differences
	Network Connectivity

1. Download
2. Uncompress
3. Place in active MATLAB directory or add to MATLAB path.
4. Follow the template in makeSampleData.m to format data. Sample Data is also provided.
5. Follow runERP.m for scalp EEG pipeline.
6. Follow runERSP.m to generate ERSP plots.
7. Follow runSource.m for source localized EEG pipeline.

Your input should follow a specific structure using a MATLAB struct called project. Below is a guide to each required field and how to populate it. Sample Script

• Example

• Project Metadata

• Formatting EEG Data

To run an analysis, you must define a few required parameters, including time windows of interest (timeRange) and the baseline period (baselineTime). Additional optional settings can be customized through the cfg struct to control how the analyses are run and plotted.

• Example: Defining Required Fields

• Example: Optional Config Definition

• Required Parameters Reference

• Configuring Analysis (cfg Struct) Reference

This page outlines the standard analysis workflow using the ScalpObject class to process, analyze, and visualize scalp-level EEG data. Reference script is runERP.m.

• Example

• 📚 Initial Set Up and Processing

• Main Analysis Functions

This section outlines the standard analysis workflow using the SourceObject class to process, analyze, and visualize source localized EEG data. Reference script is runSource.m

• Example

• 📚 Initial Set Up and Processing

• Main Analysis Section

• Apply Custom Function to Time-Series Data

• More functionality for neural behavioral models

📁/samplePlots - Sample data and plots generated with this package. Output of runERP.m and runSource.m

📂/scripts - Contains all the code

• 📁DataAnalysis/ - Contains class object code and dependent functions.

• 📁main/ - Contains scripts to run different analysis.

This project is licensed under the MIT License. See the LICENSE file for details.

If you use this work, please cite:

Nan, J., et al. (2025). Climate trauma from wildfire exposure impacts cognitive decision-making. Nature Scientific Reports.
https://doi.org/10.1038/s41598-025-94672-0

@article{nan2025,
  author    = {Nan, Jason et. al},
  title     = {Climate trauma from wildfire exposure impacts cognitive decision-making},
  journal   = {Nature Scientific Reports},
  year      = {2025},
  volume    = {},
  number    = {},
  pages     = {},
  doi       = {10.1038/s41598-025-94672-0}
}