tractor.base (version 2.5.0)

sortDicomDirectory: Sort a directory of DICOM files into series

Description

This function sorts a directory containing DICOM files into subdirectories by series number (DICOM tag 0x0020,0x0011) series time (0x0008,0x0031), subject name (0x0010,0x0010) and/or scan date (0x0008,0x0020). Each unique identifier, together with its description, will be used as the name for a new subdirectory of the specified top-level directory, and all relevant files will be copied into that subdirectory. Duplicate file names are disambiguated if necessary.

Usage

sortDicomDirectory(directory, deleteOriginals = FALSE, sortOn = "series",
    useSeriesTime = FALSE)

Arguments

directory

A length-1 character vector giving the directory to search for DICOM files. Subdirectories will also be searched.

deleteOriginals

A single logical value. If TRUE, then the source files will be deleted after being copied to their new locations, making the operation a move rather than a copy. Nothing will be deleted if the copy fails.

sortOn

The string "series", "subject" or "date", or any combination in the order desired. This will be the basis of the sort, which will be nested if more than one type is specified.

useSeriesTime

Logical value. If TRUE, use the series time rather than number as the identifier. This can be more reliable if the files are from multiple scan sessions.

Value

• This function is called for its side effect.

References

Please cite the following reference when using TractoR in your work:

J.D. Clayden, S. Muñoz Maniega, A.J. Storkey, M.D. King, M.E. Bastin & C.A. Clark (2011). TractoR: Magnetic resonance imaging and tractography with R. Journal of Statistical Software 44(8):1-18. http://www.jstatsoft.org/v44/i08/.

See Also

newMriImageFromDicomDirectory for reading DICOM files into an MriImage object.