NIfTI-1/NIfTI-2 Data Format and Orientation Conventions

FSL primarily uses the NIFTI-1 data format by default. Some tools may still work with old ANALYZE files, but we are unable to offer any support for working with ANALYZE. In general, FSL tools can work with the following data formats:

By default, FSL programs use the NIFTI_GZ format, i.e. single-file NIFTI-1 compressed images. You control which NIFTI format FSL programs write using the FSLOUTPUTTYPE environment variable.

FSL can automatically read any of the above formats, regardless of what output type has been set. However, FSL programs will generally complain and quit if you have an input image present in more than one format - for example, fmridata.hdr/fmridata.img and fmridata.nii.gz present in the same directory. If you want to bypass this safety-checking you can set the environment variable FSLMULTIFILEQUIT to FALSE.

NIfTI allows the left-right orientation of your data to be specified in the file. This is separate from how it is displayed in FSLeyes. However, the FSLeyes labels should always be in the correct places. If they are wrong (or missing) then we suggest that the conversion to the NIfTI be investigated and fixed or a different method used such that the labels are correct. There is no point in continuing with any analysis if the initial labels are incorrect. Note that to distinguish left from right just by looking at the image is normally impossible and would require a marker (e.g. a vitamin capsule) to be present when acquiring the images.

The data stored on disk (in the NIfTI file) can be in either "radiological" or "neurological" order, depending on information stored in the qform and sform fields of the NIfTI header. It is rarely necessary to be concerned with what this order is. All FSL tools will work regardless of the order, as long as the orientation labels of your image are correct when viewed in FSLeyes.

ANALYZE images are treated as radiologically ordered in FSL but should be avoided whenever possible as they do not allow proper orientation information to be stored.

FSLeyes defaults to displaying images in radiological convention when possible.

NIFTI "sform" information (when present) is copied from the reference image when using Flirt to calculate or apply a registration.

NIFTI "qform" information (should be) transformed from the input image and not copied from the reference image.

All other programs should preserve the sform and qform information (or arbitrarily take it from one input if it is a process that combines many inputs)

fslcpgeom can be used to copy this info (plus voxel dims) from one image to another.

 

Formats (last edited 13:49:40 25-11-2022 by PaulMcCarthy)