AnalyzeFMRI (version 1.1-25)

threeDto4D: threeDto4D

Description

To read tm functionnal images files in ANALYZE or NIFTI format, and concatenate them to obtain one 4D image file in Analyze (hdr/img pair) or Nifti format (hdr/img pair or single nii) which is written on disk. Note that this function outputs the files in the format sent in. If desired, one can use the function analyze2nifti to create NIFTI files from ANALYZE files.

Usage

threeDto4D(outputfile, path.in = NULL, prefix = NULL, regexp = NULL, times = NULL,
       list.of.in.files = NULL, path.out = NULL, is.nii.pair = FALSE, hdr.number = 1)

Value

None. Writes an Analyze or a NIFTI file on the disk.

Arguments

outputfile

character. Name of the outputfile without extension

path.in

character with the path to the directory containing the image files

prefix

character. Common prefix to each file

regexp

character. Regular expression to get all the files, e.g., "????.img"

times

vector. Numbers (indices) of the image files to retrieve

list.of.in.files

names of img files to concatenate (with full path)

path.out

where to write the output hdr/img pair files. Will be taken as path.in if not provided.

is.nii.pair

logical. Should we write a single nii NIFTI file or a hdr/img NIFTI pair file

hdr.number

Number of the original 3D Analyze or NIFTI image file from which to take the header that should serve as the final header of the newly 4D created image file

See Also

twoDto4D fourDto2D

Examples

a <- f.read.analyze.volume(system.file("example.img", package = "AnalyzeFMRI"))
dim(a)
tmpdir <- tempdir()
b <- threeDto4D(outputfile = "fourdfile", path.in =
          paste0(system.file(package = "AnalyzeFMRI"), "/"), 
      prefix = NULL, regexp = NULL, times = 2, list.of.in.files = rep("example.img", 2), 
      path.out = tmpdir, is.nii.pair = FALSE, hdr.number = 1)
dim(b)
unlink(tmpdir) # tidy up