• Stars
    star
    200
  • Rank 195,325 (Top 4 %)
  • Language
    MATLAB
  • License
    GNU General Publi...
  • Created about 9 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Toolbox for segmentation and characterisation of transient connectivity

UPDATING TO THE LATEST VERSION IS STRONGLY RECOMMENDED, DUE TO AN ERROR THAT WAS RECENTLY FOUND ON THE STOCHASTIC INFERENCE UPDATES.

HMM-MAR

Please check the Wiki for the latest documentation, including some basic introduction to the method. If you have problems or questions, use the Issues tab on github, so that others can see the response as well; but please first check if the question has been responded already here.

Note: the name of the toolbox is mantained only for historical reasons, and currently contains other observation models other than the multivariate autoregressive model (MAR).

The example scripts provide some basic demonstration of the toolbox functionality. The script examples/run_HMMMAR.m is a template script that specifies some basic options depending on the specified data modality and, provided that the user has already loaded the data in the right format (see the script for details), runs the HMM-MAR and gets some basic information out of the estimation. The script examples/run_HMMMAR_2.m is a template script that generates some random (putatively fMRI) data under two different conditions, estimates the HMM for a number of different configurations, does permutation testing to test the results against the conditions, and plots the results.

Under examples/, there are scripts demonstrating the analysis conducted for some of the papers

For more detailed description and applications, please refer to

If this toolbox turns out to be useful, we'd grateful if you cite the main references for the HMM-MAR:

Diego Vidaurre, Andrew J. Quinn, Adam P. Baker, David Dupret, Alvaro Tejero-Cantero and Mark W. Woolrich (2016) Spectrally resolved fast transient brain states in electrophysiological data. NeuroImage. Volume 126, Pages 81–95.

and, describing an efficient inference (stochastic) method for big amounts of data,

Diego Vidaurre, R. Abeysuriya, R. Becker, Andrew J. Quinn, F. Alfaro-Almagro, S.M. Smith and Mark W. Woolrich (2017) Discovering dynamic brain networks from Big Data in rest and task. NeuroImage.

An example of application on fMRI is shown in

Diego Vidaurre, S.M. Smith and Mark W. Woolrich (2017). Brain network dynamics are hierarchically organized in time. Proceedings of the National Academy of Sciences of the USA

A version adequate for modelling whole-brain M/EEG data (not MAR-based, but using lagged cross-correlations) is proposed in

Diego Vidaurre, Lawrence T. Hunt, Andrew J. Quinn, Benjamin A.E. Hunt, Matthew J. Brookes, Anna C. Nobre and Mark W. Woolrich (2017). Spontaneous cortical activity transiently organises into frequency specific phase-coupling networks. Nature Communications.

A step-by-step paper detailing the use of the HMM for MEG alongside comprehensive details of MEG preprocessing in

Andrew J. Quinn, Diego Vidaurre, Romesh Abeysuriya, Robert Becker, Anna C Nobre, Mark W Woolrich (2018). Task-Evoked Dynamic Network Analysis Through Hidden Markov Modeling. Frontiers in Neuroscience.

An HMM-based model to find dynamic decoding models, where the states define how, when and where the stimulus is encoded in the brain in

Diego Vidaurre, Nicholas Myers, Mark Stokes, Anna C Nobre and Mark W. Woolrich (2018). Temporally unconstrained decoding reveals consistent but time-varying stages of stimulus processing. Cerebral Cortex.

An HMM where each state is a probabilistic PCA model, so that we can do simultaneous dimensionality reduction and time-varying functional connectivity estimates in

Diego Vidaurre (2021) A new model for simultaneous dimensionality reduction and time-varying functional connectivity estimation. PLOS Computational Biology.

More Repositories

1

osl-dynamics

Methods for studying dynamic functional brain activity in neuroimaging data.
Python
56
star
2

osl

OHBA Software Library - MEG/EEG Analysis Tools
Python
39
star
3

osl-core

Matlab tools for running M/EEG analyses - NO LONGER SUPPORTED - Please use Python Version Instead: https://github.com/OHBA-analysis/osl
MATLAB
29
star
4

Quinn2018_TaskHMM

Task-Evoked Dynamic Network Analysis through Hidden Markov Modelling
MATLAB
17
star
5

MEG-ROI-nets

Stationary network analysis for MEG
MATLAB
12
star
6

Quinn2021_Waveform

Analysis scripts accompanying "Within-cycle instantaneous frequency profiles report oscillatory waveform dynamics" https://doi.org/10.1101/2021.04.12.439547
Python
7
star
7

GLEAN

Group Level Exploratory Analysis of Networks
MATLAB
6
star
8

Quinn2019_BurstHMM

Transient event detection with Hidden Markov Models
MATLAB
6
star
9

abeysuriya_wc_isp

Code for Abeysuriya et al. "A biophysical model of dynamic balancing of excitation and inhibition in fast oscillatory large-scale networks"
HTML
5
star
10

bayes_tutorial

OHBA Bayes GLM tutorial
MATLAB
4
star
11

Quinn2022_GLMSpectrum

Python
4
star
12

Cho2024_MEEG_RSN

Scripts for the Cho et al. (2024) manuscript
Python
3
star
13

Higgins2020_Neuron

This repository contains all the files used for the analysis in the paper "Replay bursts in humans coincide with activation of the default mode and parietal alpha networks", Higgins et al Neuron 2020
MATLAB
3
star
14

Gohil2024_NetworkAnalysisOfTaskData

Example scripts for Gohil et al., "Dynamic Network Analysis of Electrophysiological Task Data" (2024).
Python
2
star
15

Tinda

Temporal-Interval Network Density Analysis
MATLAB
1
star
16

RepresentationalDynamicsModelling

MATLAB
1
star
17

CIFTI

Open CIFTI/GIFTI files and parse associated XML metadata with latest Matlab versions
MATLAB
1
star
18

parcellations

A collection of parcellations
1
star
19

ohba-external

External libraries used by OSL and related OHBA software
MATLAB
1
star