QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity

Abstract

Quasi-periodic patterns (QPPs) are prominent spatiotemporal brain dynamics observed in functional neuroimaging data, reflecting the alternation of high and low activity across brain regions and their propagation along cortical gradients. QPPs have been linked to neural processes such as attention, arousal fluctuations, and cognitive function. Despite their significance, existing QPP analysis tools are limited by study-specific parameters and complex workflows. To address these challenges, we present QPPLab, an open-source MATLAB-based toolbox for detecting, analyzing, and visualizing QPPs from fMRI time series. QPPLab integrates correlation-based iterative algorithms, supports customizable parameter settings, and features automated workflows to simplify analysis. Processing times vary depending on dataset size and the selected mode, with the fast detection mode completing analyses that can be 4–6 times faster than the robust detection mode. Results include spatiotemporal templates of QPPs, sliding correlation time courses, and functional connectivity maps. By reducing manual parameter adjustments and providing user-friendly tools, QPPLab enables researchers to efficiently study QPPs across diverse datasets and species, advancing our understanding of intrinsic brain dynamics.