ROI Toolbox Docs

Documentation: Display ROIS (display_rois.m)
--------------------------------------------
Jeff Cooper
12/12/02

1. Summary

display_rois is a script which allows the user to superimpose an
image file (or several) containing a region of interest onto an 
anatomical image file, and interactively explore those images in 
tandem, to better visualize exactly where an ROI is in the brain.  
It uses the standard SPM 3-orthographic-projection display window, 
including the attached navigation control panel.
 
2. Usage

display_rois

display_rois can be run from the Display ROIs button in the ROI 
Toolbox, or from the command line.  It takes no inputs and produces
no outputs.
	The user is first queried for a background image to display;
this is customarily an anatomical image, although any ANALYZE-format
.img file can be used (a con_*.img, or functional image  anything
youd like).  This image pops up in the standard SPM display window,
complete with the usual navigation control panel, which is fully 
operational.
	The SPM interactive window then pops up a query as to how many
ROI images the user would like to superimpose on top of this displayed
background image  up to three superimposed images may be chosen.  The 
user then chooses the ROI image files to display.  The user is then
queried as to what color each ROI should be displayed as; if multiple
ROIS are chosen, color can be a good way to differentiate them, although
the same color can be chosen for all images if the user desires.
	The script then superimposes the ROI image files in the requested 
colors onto the background image, and at that point, the user has full
control over the SPM display facility in all the usual ways.  The
crosshairs respond as normal, and the user may use the navigation panel
in all the typical ways.
	The script may be closed simply by closing the Graphics and
interactive windows.


3. Output

None.


4. Last Bits

display_rois.m was written as part of the Gabrieli Lab ROI Toolbox,
a package of utilities to examine ROI data in SPM99.  It requires 
several functions in both of those packages to be run.

This code is in a very fluid state of development, and any suggested
modifications are welcomed and invited.  Please contact Jeff Cooper
in the Stanford Psychology Department at jcooper@stanford.edu with 
any questions about usage, bug reports, or suggestions for further
revision.  Good luck...

