Differences between revisions 8 and 9
Revision 8 as of 09:19:10 06-04-2011
Size: 680
Comment:
Revision 9 as of 09:26:25 06-04-2011
Size: 4079
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:

= FEAT Basics =

To call the FEAT GUI, either type `Feat` in a terminal (type `Feat_gui` on Mac or Windows), or run `fsl` and press the '''FEAT''' button.

Now set the filename of the 4D input image (e.g. `/users/sibelius/origfunc.nii.gz`) by pressing '''Select 4D data'''. You can setup FEAT to process many input images, one after another, as long as they all require exactly the same analysis. Each one will generate its own FEAT directory, the name of which is based on the input data's filename (unless you enter an '''Output directory''' name).

Note that if you later run '''Post-stats''' or '''Registration''', or if you are running '''Higher-level Analysis''', then instead of selecting 4D data as the input, you select FEAT directories. In this case first set the top two drop-down menus in the GUI and then select the FEAT directory or directories; it is important to select the FEAT directories before setting up anything else in FEAT. This is because quite a lot of FEAT settings are loaded from the first selected FEAT directory, possibly over-writing any settings which you might wish to change!

'''Total volumes''' (including volumes to be deleted) is automatically set from the input files chosen.

Now set '''Delete volumes'''. These should be the volumes that are not wanted because steady-state imaging is not reached for typically two or three volumes. These volumes are deleted as soon as FEAT is started, so any 4D data output by FEAT will not contain the deleted volumes. Note that '''Delete volumes''' should not be used to correct for the time lag between stimulation and the measured response - this is corrected for in the design matrix by convolving the input stimulation waveform with a blurring-and-delaying haemodynamic response function. Most importantly, remember when setting up the design matrix that the timings in the design matrix start at t=0 seconds, and this corresponds to the start of the first image taken after the deleted scans. In other words, the design matrix starts '''after''' the deleted scans have been deleted.

Set the '''TR''' (time from the start of one volume to the start of the next).

Now set the '''High pass filter cutoff''' point (seconds), that is, the longest temporal period that you will allow. A sensible setting in the case of an rArA or rArBrArB type block design is the (r+A) or (r+A+r+B) total cycle time. For event-related designs the rule is not so simple, but in general the cutoff can typically be reduced at least to 50s.

Note that most of the timing inputs in FEAT are set in seconds, not volumes. '''Total volumes''' and '''Delete volumes''' are exceptions.

Now click on the '''Stats''' tab and setup the model and required contrasts (for more detail see below).

When FEAT setup is complete and the '''Go''' button is pressed, the setup gets saved in a temporary FEAT setup file. Then a script (called `feat` - note the lower case) is run which uses the setup file and carries out all the FMRI analysis steps asked for, starting by creating a FEAT results directory, and copying the setup file into here, named `design.fsf` (this setup file can be later loaded back into FEAT using the '''Load''' button).

Once the script has started running you can '''Exit''' the FEAT GUI. The analysis will continue until completion, by default showing information about its progress in a web browser.

Contents

  1. Introduction
  2. User Guide
  3. FAQ

Before Running FEAT

Before calling the FEAT GUI, you need to prepare each session's data as a 4D NIFTI or Analyze format image; there are utilities in fsl/bin called fslmerge and fslsplit to convert between multiple 3D images and a single 4D (3D+time) image. If the data requires any scanner-specific corrections (for example, for artefacts such as slice dropouts), this should be applied to the data before running FEAT.

Structural images for use as "highres" images in registration should normally be brain-extracted using BET before being used by FEAT.

FEAT Basics

To call the FEAT GUI, either type Feat in a terminal (type Feat_gui on Mac or Windows), or run fsl and press the FEAT button.

Now set the filename of the 4D input image (e.g. /users/sibelius/origfunc.nii.gz) by pressing Select 4D data. You can setup FEAT to process many input images, one after another, as long as they all require exactly the same analysis. Each one will generate its own FEAT directory, the name of which is based on the input data's filename (unless you enter an Output directory name).

Note that if you later run Post-stats or Registration, or if you are running Higher-level Analysis, then instead of selecting 4D data as the input, you select FEAT directories. In this case first set the top two drop-down menus in the GUI and then select the FEAT directory or directories; it is important to select the FEAT directories before setting up anything else in FEAT. This is because quite a lot of FEAT settings are loaded from the first selected FEAT directory, possibly over-writing any settings which you might wish to change!

Total volumes (including volumes to be deleted) is automatically set from the input files chosen.

Now set Delete volumes. These should be the volumes that are not wanted because steady-state imaging is not reached for typically two or three volumes. These volumes are deleted as soon as FEAT is started, so any 4D data output by FEAT will not contain the deleted volumes. Note that Delete volumes should not be used to correct for the time lag between stimulation and the measured response - this is corrected for in the design matrix by convolving the input stimulation waveform with a blurring-and-delaying haemodynamic response function. Most importantly, remember when setting up the design matrix that the timings in the design matrix start at t=0 seconds, and this corresponds to the start of the first image taken after the deleted scans. In other words, the design matrix starts after the deleted scans have been deleted.

Set the TR (time from the start of one volume to the start of the next).

Now set the High pass filter cutoff point (seconds), that is, the longest temporal period that you will allow. A sensible setting in the case of an rArA or rArBrArB type block design is the (r+A) or (r+A+r+B) total cycle time. For event-related designs the rule is not so simple, but in general the cutoff can typically be reduced at least to 50s.

Note that most of the timing inputs in FEAT are set in seconds, not volumes. Total volumes and Delete volumes are exceptions.

Now click on the Stats tab and setup the model and required contrasts (for more detail see below).

When FEAT setup is complete and the Go button is pressed, the setup gets saved in a temporary FEAT setup file. Then a script (called feat - note the lower case) is run which uses the setup file and carries out all the FMRI analysis steps asked for, starting by creating a FEAT results directory, and copying the setup file into here, named design.fsf (this setup file can be later loaded back into FEAT using the Load button).

Once the script has started running you can Exit the FEAT GUI. The analysis will continue until completion, by default showing information about its progress in a web browser.


CategoryFEAT

 

FEAT/UserGuide (last edited 17:28:45 18-02-2020 by ThomasNichols)