Table of Contents

The following are some introductory lines to the functionality of the mrLoadRet-4.5 Graphic User Interface. All options in this section will either generate a .mat file, modify mrSESSION.mat or the .img files.

File Menu

Look in the file menu for functions that let you load / save anatomy files, analyses, ROIs and so on. There are also functions that let you print the currently displayed image, import / export data, ROIs, write out information about the session in a Readme.txt file, and quit the current session of mrLoadRet.

Base Anatomy

File Menu (Matlab on Mac OSX)

Analysis

Overlay

ROI

Import

Export

Write Readme.txt

Save mrSession

Print

Quit

Edit Menu

Edit Menu (Matlab on Linux)

Edit mrSession

Edit details of the scanning session such as a description, the subject id, operator, magnet and pulse sequence. Those were usually when running mrInitRet or mrInit.

Group

Manipulate groups (such as Raw, MotionComp, and Averages

Scan

Base Anatomy

Analysis

Overlay

ROI

Preferences

Edit important preferences that affect the overall behavior of mrLoadRet. You will see a menu like the following:

preference value
Site (e.g. NYU, RIKEN, RHUL, Nottingham, …)
verbose Yes if you want to have messages and waitbars displayed as dialogs, No to have information printed to the terminal
interpMethod Type of interpolation to use. Normally this is set to nearest for nearest neighbor interpolation – on a flat map you will be able to see a crystalline pattern of how the voxels are getting warped. If you prefer a smoother looking overlay, try setting this to linear
maxBlocksize Size of chunks of data to analyze at a time. If you are running out of memory, set lower. A good starting point is 250000000. If you are using 64 bit Matlab (there is a beta which works with mrLoadRet for Mac OS X), set this to a very high number.
volumeDirectory The directory to default to when you load base anatomies from the VOlume directory
overwritePolicy Method to use when analysis is going to overwrite an existing file
niftiFileExtension Nifti file extension, usually .img but can be set to single file .nii
selectedROIColor What color to use to draw the selected ROI.
roiPolygonMethod Method used to create ROI polygons. The default roipoly function calls the line drawing function which can be very slow if you have already drawn a buch of lines (i.e. have some ROIs displaying). If you choose getpts instead, you will not have the lines drawn between points as you draw the ROI, but it will be much faster. getptsNoDoubleClick is similar to getpts but instead of double-click to end the selection you hit the return key (on some machines Matlab''s idea of what constitutes a double-click can be very slow)
roiCacheSize Size of ROI cache, usually 100.
baseCacheSize Size of base image cache. Set to the number of base slices you want to be able to quickly view
overlayCacheSize Size of overlay image cache. Set to the number of base slices you want to be able to quickly view
roiContourWidththis specifies the linewidth with which to draw the ROI. I find that, depending on the type of base anatomy, I find a value of 2 looks better/worse than a value of 1 (the default)

Window Menu

New Window

Open up a new window, if you want to e.g. look at the same data set in the coronal and sagittal views simultaneously

New Graph Window

Open up a new graphing window, into which results from new calls to the interrogator functions or functions form the Plots menu get rendered.

Analysis Menu

View Menu

ROI Menu

Create:

Add

Subtract

Combine

Restrict

Remove

Undo

Convert

Show

Plots Menu

The main GUI window

Overlay Min/Max sliders

The “overlay min” and “max” sliders determine the range of values in the current overlay that are displayed on top of the base anatomy (with the current overlay colormap).

Note, that

Main GUI window (Matlab on Linux) - labels coming!

On the new GUI (see GLM version 2) the controls are similar and are set as follows:

Thresholds and Visibility of voxels: The thresholds that are being used for each clipping overlay are set by the combination of Min/Max sliders and boxes, but can also be controlled through the Edit→Overlay→Edit Overlay window. These thresholds determine whether particular voxels are being displayed as part of the overlay color map or not, but in addition the (alpha) transparency for each voxel can also be controlled. This might be useful if you want to emphasize data with higher statistical significance values.

The overall transparency of the overlay controlled is by the Alpha slider, but the voxel-wise alpha transparency is determined by the alphaOverlay (to get info about the current overlay: Edit→Overlay→Info, to change it, select a different alphaOverlay after Edit→Overlay→Edit Overlay).