Usage: Ifile [Options] <File List>
[-nt]: Do not use time stamp to identify complete scans.
Complete scans are identified from 'User Variable 17'
in the image header.
[-sp Pattern]: Slice acquisition pattern.
Sets the slice acquisition pattern.
The default option is alt+z.
See to3d -help for acceptable options.
[-od Output_Directory]: Set the output directory in @RenamePanga.
The default is afni .
<File List>: Strings of wildcards defining series of
GE-Real Time (GERT) images to be assembled
as an afni brick. Example:
Ifile '*/I.*'
or Ifile '083/I.*' '103/I.*' '123/I.*' '143/I.*'
The program attempts to identify complete scans from the list
of images supplied on command line and generates the commands
necessary to turn them into AFNI bricks using the script @RenamePanga.
If at least one complete scan is identified, a script file named GERT_Reco
is created and executing it creates the afni bricks placed in the afni directory.
How does it work?
With the -nt option: Ifile uses the variable 'User Variable 17' in the
I file's header. This option appears to be augmented each time a new
scan is started. (Thanks to S. Marrett for discovering the elusive variable.)
Without -nt option: Ifile first examines the modification time for each image and
infers from that which images form a single scan. Consecutive images that are less
than T seconds apart belong to the same scan. T is set based on the mean
time delay difference between successive images. The threshold currently
used works for the test data that we have. If it fails for your data, let us
know and supply us with the data. Once a set of images is grouped into a
scan the sequence of slice location is analysed and duplicate, missing slices,
and incomplete volumes are detected. Sets of images that do not pass these tests
are ignored.
Preserving Time Info: (not necessary with -nt option but does not hurt to preserve anyway)
It is important to preserve the file modification time info as you copy or untar
the data. If you neglect to do so and fail to write down where each scan ends
and/or begins, you might have a hell of a time reconstructing your data.
When copying image directories, use:
cp -rp ???/* TARGET/
and when untaring the archive on linux use:
tar --atime-preserve -xf Archive.tar
On Sun and SGI, tar -xf Archive.tar preserves the time info.
Future Improvements:
Out of justifiable laziness, and for other less convincing reasons, I have left
Ifile and @RenamePanga separate. They can be combined into one program but it's usage
would become more complicated. At any rate, the user should not notice any difference
since all they have to do is run the script GERT_reco that is created by Ifile.
Dec. 12/01 (Last modified July 24/02) SSCC/NIMH
Robert W. Cox(rwcox@nih.gov) and Ziad S. Saad (saadz@mail.nih.gov)
