froi: fs-fast roi

manual pages

technical documentation


SYNOPSIS

edit_roi -analysis analysisName -roi roiName -sf sessid -df sessdir [optional arguments]

Type ``edit_roi -man'' for complete documentation

DESCRIPTION

edit_roi allows one to edit a previously created ROI. Such an ROI is commonly created from a program like make_roi. Multiple ROIs can be saved, as the program will use the input ROI as a template from which to save further ROIs. The program thus allows one to take a large ROI, like a ``p values smaller than 10^-4'' map and divide it into smaller ROIs.

edit_roi starts Matlab with your input ROI displayed over the first run in your bold directory or the first run in your runlist (if you have defined a runlist). At first all voxels in the input ROI will be selected and in red. To erase all the selected voxels and to start from a blank ROI, press ``c''. You will see that all of the voxels are now yellow, indicating that no voxels are selected for the current ROI. The yellow voxels indicate the input ROI and are used as a template when creating further ROIs.

To ease creation of ROIs, you can use a large brush size to select voxels and then press ``i'' to take the intersection of your brush selection and the underlying template.

There is more complete help information within the program itself; press ``h'' to read it.

ARGUMENTS

REQUIRED ARGUMENTS

-analysis analysisName
Name of a fsfast analysis

-roi roiName
Name of the ROI to edit

-sf sessidfile
Name of the session ID file. Note that only one session ID in the file will be used (the last one)

-df sessdirfile
Name of the session directory file.

OPTIONAL ARGUMENTS

-overlay overlayName
Name of the ROI to overlay on top of the ROI named with the -roi parameter. Most often this is used to make further edits to, e.g., an ``FFA'' ROI on top of a ``t greater than 4'' ROI.

-roidir masks
Name of the directory under the analysis analysisName to hold your ROIs. Defaults to analysisName_ROI (e.g., for an analysis called ``hfso'', the ROI directory defaults to ``hfso_ROI'').

-base runDirectory
Name of a different base directory on which to overlay the template and ROIs. Only needs to be taken into account if you used different slice prescriptions within the same scan. Defaults to the first run in the bold directory or the first run in your runlist (if you have that defined).

-funcDir bold
Name of the directory holding the functional runs. Usually ``bold'', defaults to ``bold''.

-funcStem fmc
Name of the functional stem from which to create the base. See -base. Defaults to fmc or the functional stem in your analysis.info file.

-help
Provides complete command information.

-man
Provides verbose usage information.

-debug
Provides complete debugging information.

EXAMPLE

edit_roi -analysis blocked -roi ffa -sf sessid -df sessdir

BUGS

None known of. Send bug reports to <froi-bugs@sourceforge.net>.

AUTHOR

Nicholas Knouf, <nknouf@mit.edu>, <nknouf@mimeme.net>

COPYRIGHT & LICENSE

Copyright (c) 2003, Nicholas Knouf, MIT.

This program is free software and is governed by the terms of the Artistic License.

REVISION

$Id: edit_roi,v 1.10 2003/10/06 16:03:47 nknouf Exp $

SEE ALSO

make_roi, compute_roi