Sam epi

From MEG Core
Revision as of 11:46, 12 March 2019 by Nugenta (talk | contribs) (→‎Description)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Return to Source Localization - SAM


The sam_epi routine is a program designed for detecting epileptiform activity in the brain in a semi-automated fashion, to prevent the necessity for the epileptologist to view each MEG channel time series individually. sam_epi evaluates the time series of each voxel in the brain to determine kurtosis. The recommended pipeline is to run sam_cov, sam_wts, and then sam_epi, using an initial bandwidth in the range 20-70Hz. The utility NIFTIPeak can then be used to identify voxels with peak or excess kurtosis values. These voxel locations can then be used as targets for a secondary run of sam_cov and sam_wts with a wide bandwidth (1-150Hz). Finally, DataEditor can be used to generate the virtual sensor time series for the targets, and the epileptologist can investigate the time series to examine individual spikes.

Note that datasets must be continuous, and not epoched into trials.


 sam_epi -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:

 CovBand: Bandpass for the covariance matrices (and directory for weights files)
 ImageBand: Bandpass for the image
 ImageMetric: Must be KURTOSIS
 TimeInt: designates the duration for the boxcar integration
 CovType: Must be GLOBAL

Optional Parameters:

 FilterType: choose the applied filter, IIR vs. FFT 
 ImageDirectory: Directory where the output images are written, default is the SAM directory
 PrefixLength: Number of characters in the MEG dataset name used for naming MRI files

Output Files

Creates a single 3D NIFTI format image of kurtosis (g2). Output file will be named using the PrefixLength parameter.