Skip to content

pelednoam/mmvt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 

Repository files navigation

MMVT code is stored in a private repository.
If you intend to use it for academic/research purposes, please send us an email from your academic server with your GitHub username, and we will send you an invitation.
If you intend to use it for commercial purposes, please contact us for pricing.
Unfortunately, the full repository is currently supported only on Linux or Windows with WSL.
You can also check out our public repository to analyze and integrate multimodal datasets without the visualization component.
The manuscript can be found here: https://arxiv.org/abs/1912.10079
Our website: https://mmvt.mgh.harvard.edu/
MMVT as a rap song, written by ChatGPT

Download the code:

When you can access the private repo (https://github.com/mmvt/mmvt), run:

And continue using the following tutorial: https://github.com/mmvt/mmvt/blob/master/tutorials/installation.md

Multi-Modality Visualization Tool

The visualization and exploration of neuroimaging data are important for the analysis of anatomical and functional images and statistical parametric maps. While two-dimensional orthogonal views of neuroimaging data are used to display activity and statistical analysis, real three-dimensional (3D) depictions are helpful for showing the spatial distribution of a functional network, as well as its temporal evolution. For our best knowledge, currently, there is no neuroimaging 3D tool which can visualize both MEG, fMRI and invasive electrodes (ECOG, depth electrodes, DBS, etc.). Here we present the Multi-Modality Visualization Tool (MMVT). The tool was built for researchers who wish to have a better understanding of their neuroimaging anatomical and functional data. The true power of the tool is by visualizing and analyzing data from multi-modalities. MMVT is built as two separated modules: The first is implemented as an add-on in 'Blender”, an open-source 3D visualization software. The add-on is an interactive graphical interface which enables to visualize functional and statistical data (MEG and/or fMRI) on the cortex and subcortical surfaces, invasive electrodes activity and etc. The tool can also be used for a better 3D visualization of the anatomical data and the invasive electrodes locations. The other module is a standalone software, for importing and preprocessing. The users can select the data they want to import to Blender and how they want to process it.

The module supports many types of analyzed data:

  • FsFast (FreeSurfer Functional Analysis Stream)
  • SPM (Statistical Parametric Mapping)
  • MNE (a software package for processing MEG and EEG)
  • MEG raw data (fif files)
  • FieldTrip (MATLAB software toolbox for neuroimaging analysis)

The users can also reprocess raw data using wrappers for FaFast and MNE-python (a python package for sensor and source-space analysis of MEG and EEG data).

DOI

New Website

Please visit our new website: mmvt.org

Videos & Figures

  • Short demo how to use the main features (click on the image):

mmvt demo

  • Resting State fMRI & Cortical labels correlation: Example
  • Spatial and temporal ttest result of MEG activation: Example

Features

A list of features can be found here

The features can be seen here

Installation

Windows full guide

Linux & Mac OS full guide

The tool itself can run on windows, mac and linux. In the preprocessing pipeline there are several calls to FreeSurfer (runs only on linux/mac). Beside of that, you can use the tool also on windows.

Download the template brain Colin27 to learn more about the tool

Template brain and data

We've imported colin27 into MMVT, and included data we morphed from a patient. The data includes recording from EEG, MEG, fMRI, and sEEG for the MSIT task. The data can be downloaded from here (1GB). Extract the zip file in the mmvt_blend folder which was created in your mmvt_root folder. Then, open Blender, close the splash screen and open (File->open) colin's blend file (colin27_laus125.blend).

  • To learn more about the tool you can find several self-explanatory tasks for Colin27 data here.
    • Step by step answers for the tasks can be found here

Blender shortcuts

  • Rotate the brain using the middle mouse button.
  • Select objects (electrodes / sensors / cortical lables) using the right mouse button. To select cortical labels you need to change first the view to "ROIs" in the Appearence panel.
  • Zoom in/out using the mouse scrolling.

Preprocessing

The preprocessing tutorial can be found in the wiki sidebar.

Update the code

Linux: The program can be updated without using the "git pull" function.

  • Lunch MMVT.
  • Open the "Import objects and data" panel.
  • Press the "Update MMVT" button at the top of the panel.

Windows:

  • In the Git CMD terminal chage the directory to the mmvt_code folder (example: cd c:\Users\Jhon\mmvt_root\mmvt_code)
  • Type: git pull

Contributors

Acknowledgments

This research was partially funded by the Defense Advanced Research Projects Agency (DARPA) under Cooperative Agreement Number W911NF-14-2-0045 issued by ARO contracting office in support of DARPA's SUBNETS Program. The views, opinions, and/or findings expressed are those of the author and should not be interpreted as representing the official views or policies of the Department of Defense or the U.S. Government. This research was also funded by the NCRR (S10RR014978) and NIH (S10RR031599,R01-NS069696, 5R01-NS060918, U01MH093765).

Suggested Citation

N. Peled and O.Felsenstein et al. (2017). MMVT - Multi-Modality Visualization Tool. GitHub Repository. https://github.com/pelednoam/mmvt DOI:10.5281/zenodo.438343

Licensing

MMVT is GNU GPL licenced (v3.0)

About

The Multi-Modality Visualization Tool (MMVT) is built for researchers who wish to have a better understanding of their neuroimaging anatomical and spatio-temporal data

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages