Phase-restricted wavelet detection of event-related fNIRS responses: calibrated and latency-robust detection under physiological noise

Code and data to reproduce the analyses in "Phase-restricted wavelet detection of event-related fNIRS responses: calibrated and latency-robust detection under physiological noise." The bundle contains three fully commented R scripts and the fourteen resting-state fNIRS recordings used in the paper. Script 01 runs a single-channel Monte Carlo simulation that sweeps hemodynamic latency and signal-to-noise ratio and compares a phase-restricted continuous-wavelet detector against canonical, informed-basis, and finite-impulse-response (FIR) general linear models on false-positive rate and amplitude recovery. Script 02 injects a known hemodynamic response into each real recording, which is used only as an empirical noise carrier so that the ground truth is exact, and compares every detector, including autoregressive-prewhitened GLMs, at a matched 5% false-positive rate, reporting sensitivity with across-subject dispersion. Script 03 is a phase-restriction ablation showing that the phase mask, rather than band-limited wavelet power alone, drives the detector's advantage. The recordings are the plain resting-state files from von Lühmann et al. (2020), redistributed under the dataset's original open-access terms (see DATA_SOURCE.md); please cite that dataset in any reuse. All random draws are seeded, so the reported numbers reproduce exactly. Software: R (version 4.0 or later) with the biwavelet, fmrihrf, hdf5r, and openxlsx packages.