Replication Data and Simulation Code for the Neuro-Cognitive Safety Framework (NCSF): EEG Dataset and Agent-Based Modeling (ABM)
Description
This repository contains the replication data, code, and computational materials supporting the study: “Heidari et al. – Enhancing Safety in Construction: A Framework Predicting Neuro-Cognitive Tipping Points from Environmental Stressors”. It accompanies the Neuro Cognitive Safety Framework (NCSF), which integrates construction safety, cognitive neuroscience, and computational simulation to explore how environmental multi-physics stressors (thermal/acoustic) degrade worker cognitive capacity, laying the groundwork for Neuro-Cognitive Digital Twins (NCDTs). To ensure transparency, traceability, and reproducibility, the repository is structured into four integrated layers, providing all necessary files: 1. Neurophysiological Data Layer EEG Dataset (EEGLAB .set format): Preprocessed, ICA-cleaned EEG data from controlled cognitive workload experiments (n-back, N=16). Isolates components relevant to working memory to provide empirical grounding for the model. 2. Calibration Layer NCSF MATLAB Calibration Code.m & Supplementary MATLAB Calibrated Data.xlsx: Scripts and output datasets used to calibrate cognitive load dynamics, fatigue accumulation, and neural response parameters against the empirical EEG data. 3. Simulation Layer NCSF Agent-Based Model Proof of Concept.py: A Python-based stochastic Agent-Based Model (ABM). Simulates workers as cognitive agents over an 8-hour shift, incorporating probabilistic cognitive transitions to produce safety indicators (e.g., Mean/Peak Risk). 4. Validation & Sensitivity Analysis Layer Supplementary Sensitivity Analysis Data.csv: Data from a 30-iteration Monte Carlo replication with ±30% parameter perturbations, evaluating model robustness and identifying critical tipping points. Traceability & Reproducibility Supplementary Data Traceability Dictionary.xlsx: A structured dictionary linking neuroscience constructs, cognitive mechanisms, and safety engineering concepts. Workflow Pipeline: EEG preprocessing → parameter calibration → ABM simulation → Monte Carlo sensitivity analysis. Keywords Neuro Cognitive Safety Framework (NCSF), Agent-Based Modeling (ABM), Construction Safety, Cognitive Load, EEG, Environmental Stressors, Human Factors, Monte Carlo Simulation, LOD, Digital Twins, Traceability.
Files
Institutions
- Sharif University of TechnologyTehran, Tehran