search

LIMO-EEG-Toolbox / limo_tools

Hierarchical Linear Modelling for MEEG data
https://limo-eeg-toolbox.github.io/limo_meeg/
Other
59 stars 27 forks source link

readme

LInear MOdeling of MEEG data

The LInear MOdelling of MEEG data (LIMO MEEG) toolbox is a Matlab toolbox dedicated to the statistical analysis of MEEG data. Once data are imported, all computations are performed within the toolbox, and can thus work for any data sets from any software (e.g. EEGLAB, FieldTrip, BrainStorm). It is interfaced with EEGLAB (via STUDY) acting as a plug in ; it also uses topolot from EEGLAB for result visualization. In the LIMO_FT_integration branch, ERP data from FieldTrip (scalp and source) can also be imported and processed.

This repository (master) is the stable version of LIMO MEEG (v3). A quick overview on how this can help you achieve a fully reproducbile workflow can see in the NeuroMatch YouTube video:

BIDS-EEGLAB-LIMO-Workflow

Installation

Have EEGLAB installed (because we call some functions) and LIMO in the plug-in directory. Data of each subject must be in subject specific folders -- ideally follow the Brain Imaging Data Structure making working with EEGLAB/FieldTrip/LIMO easier.

If you are using LIMO tools programmatically, make sure subfolders are in the matlab path 

addpath([limo_folder filesep 'limo_cluster_functions']); 
addpath([limo_folder filesep 'external']); 
addpath([limo_folder filesep 'external' filesep 'psom']); 
addpath([limo_folder filesep 'help']); addpath([limo_folder filesep 'deprecated']

LIMO 3.0 has been tested with EEGLAB 2021.0. This test script runs nightly to make sure LIMO remains stable.

Documentation

The wiki provides documentation on the various tools available and files created.
We also have a full tutorial taking you through an analysis.

Questions

Best to use the discussion forums like the eeglab mailing list or neurostar (tagging people) for general analysis questions.
You can also email directly or raise a github issue, in particular for bugs.

Citation and method reporting

Published papers related to the method(s) used here are listed in the citations.nbib file. More generally, we recommended using boilerplate texts from the wiki.

LIMO tutorial dataset

The tutorial uses data prepared using EEG-BIDS avaialble here: https://openneuro.org/datasets/ds002718/versions/1.0.2. There is also an older dataset that can be downloaded here: http://datashare.is.ed.ac.uk/handle/10283/2189.

Contribute

No brainer --> comment on anything you want (usage/doc/design) in free format on this google doc

Push any changes, submit pull request against the HotFixes branch.

Anyone is welcome to contribute ! check here how you can get involved, the code of conduct. Contributors are listed here