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

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, a...

Full description

Saved in:
Bibliographic Details
Main Authors: Nan Xu, Behnaz Yousefi, Nmachi Anumba, Theodore J. LaGrow, Xiaodi Zhang, Shella Keilholz
Format: Article
Language:English
Published: Elsevier 2025-02-01
Series:SoftwareX
Subjects:
Online Access:http://www.sciencedirect.com/science/article/pii/S2352711025000342
Tags: Add Tag
No Tags, Be the first to tag this record!
_version_ 1832542478943649792
author Nan Xu
Behnaz Yousefi
Nmachi Anumba
Theodore J. LaGrow
Xiaodi Zhang
Shella Keilholz
author_facet Nan Xu
Behnaz Yousefi
Nmachi Anumba
Theodore J. LaGrow
Xiaodi Zhang
Shella Keilholz
author_sort Nan Xu
collection DOAJ
description 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.
format Article
id doaj-art-e2ab68df87724e32a33f863ff98da772
institution Kabale University
issn 2352-7110
language English
publishDate 2025-02-01
publisher Elsevier
record_format Article
series SoftwareX
spelling doaj-art-e2ab68df87724e32a33f863ff98da7722025-02-04T04:10:28ZengElsevierSoftwareX2352-71102025-02-0129102067QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activityNan Xu0Behnaz Yousefi1Nmachi Anumba2Theodore J. LaGrow3Xiaodi Zhang4Shella Keilholz5Wallace H. Coulter Department of Biomedical Engineering, Georgia Institute of Technology and Emory University, Atlanta, GA, USAWallace H. Coulter Department of Biomedical Engineering, Georgia Institute of Technology and Emory University, Atlanta, GA, USAWallace H. Coulter Department of Biomedical Engineering, Georgia Institute of Technology and Emory University, Atlanta, GA, USAElectrical and Computer Engineering, Georgia Tech, Atlanta, GA, USAWallace H. Coulter Department of Biomedical Engineering, Georgia Institute of Technology and Emory University, Atlanta, GA, USAWallace H. Coulter Department of Biomedical Engineering, Georgia Institute of Technology and Emory University, Atlanta, GA, USAQuasi-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.http://www.sciencedirect.com/science/article/pii/S2352711025000342Infraslow activityQuasiperiodic patternsSpatiotemporal brain dynamicsFunctional MRI
spellingShingle Nan Xu
Behnaz Yousefi
Nmachi Anumba
Theodore J. LaGrow
Xiaodi Zhang
Shella Keilholz
QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
SoftwareX
Infraslow activity
Quasiperiodic patterns
Spatiotemporal brain dynamics
Functional MRI
title QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
title_full QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
title_fullStr QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
title_full_unstemmed QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
title_short QPPLab: A generally applicable software package for detecting, analyzing, and visualizing large-scale quasiperiodic spatiotemporal patterns (QPPs) of brain activity
title_sort qpplab a generally applicable software package for detecting analyzing and visualizing large scale quasiperiodic spatiotemporal patterns qpps of brain activity
topic Infraslow activity
Quasiperiodic patterns
Spatiotemporal brain dynamics
Functional MRI
url http://www.sciencedirect.com/science/article/pii/S2352711025000342
work_keys_str_mv AT nanxu qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity
AT behnazyousefi qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity
AT nmachianumba qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity
AT theodorejlagrow qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity
AT xiaodizhang qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity
AT shellakeilholz qpplabagenerallyapplicablesoftwarepackagefordetectinganalyzingandvisualizinglargescalequasiperiodicspatiotemporalpatternsqppsofbrainactivity