R4dfp (version 0.2-4)

R4dfp.Load: Read a 4dfp MRI Image.

Description

Returns a loaded 4dfp MRI image, either loaded or memory-mapped.

Usage

R4dfp.Load(file,direct.read=FALSE,direct.write=FALSE)
R4dfp.Print(x)
is.4dfp(unknown)

Arguments

file

Path name of the image to load.

direct.read

Flag indicating if the .img should be loaded with ‘mmap’ for reading.

direct.write

Flag indicating if the .img should be loaded with ‘mmap’ for writing. This implies direct.read, also.

x

Object of class ‘R4dfp’.

unknown

An object to check for class ‘R4dfp’ or a string to check for 4dfp file-name format.

Value

Object of class ‘R4dfp’.

Details

The header/image file pair corresponding to the file-name given will be loaded. The object returned should not be copied directly with <- after the initial assignment; use R4dfp.Copy instead!

If direct.read or direct.write are specified, the header information cannot be edited. See R4dfp.Recycle for info about switching to a fully-editable copy. As these options imply, all changes made to the image will be written directly to the file, and all reads will be read from the file as it exists at the time of the read.

Voxel access is via the [...] operator:

1. To access a single voxel, specify 4 scalars, e.g. myimage[1,1,1,1].
2. To access the time-series of a single voxel, leave out the time, e.g. myimage[1,1,1].
3. To access a range of voxels (i.e. a rectangle,) use sequences or vectors for each applicable position, e.g. myimage[1:10,2:5,1] or myimage[c(1,2,4),1,1].
4. To access a list of specific voxels, use a single Nx4 matrix.
5. To access the time-series of a list of specific voxels, use a single Nx3 matrix. Optionally, provide a t argument to specify frames.
6. Use a 3- or 4-D logical matrix to choose specific voxels, e.g. myimage[myimage[,,,]==NaN] <- 0. Optionally, provide a t argument to specify specific frames with a 3-D matrix.

See Also

R4dfp.Save R4dfp.Copy R4dfp.Close R4dfp.Recycle

Examples

myimage <- R4dfp.Blank333("myimage.4dfp.ifh")
R4dfp.Save(myimage)

#3 different ways to load an image
myimage <- R4dfp.Load("myimage.4dfp.ifh")
myimage <- R4dfp.Load("myimage.4dfp.ifh",direct.read=TRUE)
myimage <- R4dfp.Load("myimage.4dfp.ifh",direct.write=TRUE)

#retrieve a 3x3x3 cube of voxels
myimage[1:3,1:3,1:3,1]

#set a list of voxels to 0 for all frames
voxels <- NULL
voxels <- rbind(voxels,c(1,1,1))
voxels <- rbind(voxels,c(1,1,2))
voxels <- rbind(voxels,c(1,2,1))
voxels <- rbind(voxels,c(1,2,2))
myimage[voxels] <- 0

#set all voxels to something random
myimage[,,,] <- array(rnorm(prod(myimage$dims)),myimage$dims)

#set everything less than 0 to 0
myimage[myimage[,,,]<0] <- 0