Roi wts: Difference between revisions

From MEG Core
Jump to navigation Jump to search
Content added Content deleted
(Created page with " Return to Source Localization - SAM ==Description== The purpose of roi_wts is to leverage the orientation information from the FreeSurfer par...")
 
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 3: Line 3:
==Description==
==Description==


The purpose of roi_wts is to leverage the orientation information from the FreeSurfer parcellation of the brain when solving for the beamformer weights. Normally, in a SAM analysis, the orientations calculated by solving the linear eigensystem equations and choosing the vector that gives the largest S/N. In roi_wts, the cortical normal vector is used instead. It is of paramount importance that the registration of the MEG and MRI are accurate. Thus, this program should only be run if you have already run sam_coreg. Obviously, one must have run FreeSurfer before running this program.
The purpose of roi_wts is to leverage the orientation information from the FreeSurfer parcellation of the brain when solving for the beamformer weights. Normally, in a SAM analysis, the orientations calculated by solving the linear eigensystem equations and choosing the vector that gives the largest S/N. In roi_wts, the cortical normal vector is used instead. It is of paramount importance that the registration of the MEG and MRI are accurate. Thus, this program should only be run if you have already run sam_coreg. Obviously, one must have run FreeSurfer before running this program. This program also makes use of whatever parcellation that you have requested FreeSurfer use to annotate your surface.


roi_wts uses the Nolte (realistic) head model, and will ignore other specifications of the Model parameter. By default, a 20th order harmonic expansion of the hull is used.
roi_wts uses the Nolte (realistic) head model, and will ignore other specifications of the Model parameter. By default, a 20th order harmonic expansion of the hull is used. This program represents the signal within the entire ROI using a set of basis functions, and is likely to produce greater signal to noise for the patch than a simple mean.

==Usage==


roi_wts -r <dataset_name> -m <parameter_file_name> [options]
roi_wts -r <dataset_name> -m <parameter_file_name> [options]
Line 18: Line 20:
Required Parameters (in the .param file or on the command line):
Required Parameters (in the .param file or on the command line):
CovBand: bandpass for covariance matrix calculation
Transform: Specifies transform written by sam_coreg
Atlas: Specifies the file containing the list of cortical normals in each ROI
ROIList: Specifies the file containing the list of ROIs to be estimated
Model: Nolte is required. Other specifications will be ignored.

Optional Parameters:
Optional Parameters:


MRIDirectory: Specify where to locate the necessary MRI files
MRIDirectory: Specify where to locate the necessary MRI files
PrefixLength: Specify characters used for identifying MRI and headmodel files.
PrefixLength: Specify characters used for identifying MRI and headmodel files.

==Output Files==

roi_wts creates a log file, containing the rank, number of vertices used, source power, noise power, and s/n. In addition, a .nii file containing the weights is saved, such that there will be a single "voxel" in the X and Y directions, and the Z direction will encode the ROI. The tie dimension encodes the MEG Channels.

Latest revision as of 16:36, 15 March 2019

Return to Source Localization - SAM

Description

The purpose of roi_wts is to leverage the orientation information from the FreeSurfer parcellation of the brain when solving for the beamformer weights. Normally, in a SAM analysis, the orientations calculated by solving the linear eigensystem equations and choosing the vector that gives the largest S/N. In roi_wts, the cortical normal vector is used instead. It is of paramount importance that the registration of the MEG and MRI are accurate. Thus, this program should only be run if you have already run sam_coreg. Obviously, one must have run FreeSurfer before running this program. This program also makes use of whatever parcellation that you have requested FreeSurfer use to annotate your surface.

roi_wts uses the Nolte (realistic) head model, and will ignore other specifications of the Model parameter. By default, a 20th order harmonic expansion of the hull is used. This program represents the signal within the entire ROI using a set of basis functions, and is likely to produce greater signal to noise for the patch than a simple mean.

Usage

 roi_wts -r <dataset_name> -m <parameter_file_name> [options]

The -r flag designates the dataset name (with or without the .ds suffix), and -m designates the parameter file name.

Other options:

 -v  Verbose mode, without this flag sam_wts works silently except for error messages
 -h  Show help

Required Parameters (in the .param file or on the command line):

 CovBand: bandpass for covariance matrix calculation
 Transform: Specifies transform written by sam_coreg
 Atlas: Specifies the file containing the list of cortical normals in each ROI
 ROIList: Specifies the file containing the list of ROIs to be estimated 
 Model: Nolte is required. Other specifications will be ignored.

Optional Parameters:

 MRIDirectory: Specify where to locate the necessary MRI files
 PrefixLength: Specify characters used for identifying MRI and headmodel files.

Output Files

roi_wts creates a log file, containing the rank, number of vertices used, source power, noise power, and s/n. In addition, a .nii file containing the weights is saved, such that there will be a single "voxel" in the X and Y directions, and the Z direction will encode the ROI. The tie dimension encodes the MEG Channels.