How to examine the contents of an Image Header

Symptoms:

You have an image, but do not know the spatial or demographic information for the scan

What to do:

Type:
> ImageInfo filename

or just type:

> ImageInfo

and wait for the filename prompt

ImageInfo currently recognizes Signa genesis, analyze, bshort, buchar, bfloat and APD data types, and will summarize the headers for each. Since not all image types have the same depth of header information (see file formats page for more detail), the display will differ for each data type, as shown below.

The source is now available for ImageInfo.c


Examples:

Analyze Image:

% ImageInfo Analyze.img

Image file type: Analyze
Byte Order:  Big Endian (like a Macintosh)
----------------------------------------
Header name .............. Analyze.hdr
Date/time (?)............. Thu Jan  8 20:28:35 1998
Scan description ......... EPI Data
----------------------------------------
Resolution (x / y) ....... 3.125 x 3.125 mm
Display FoV (x / y) ...... 400 / 400 mm
Display Pixels (x / y) ... 3.125 / 3.125 mm
Display matrix ........... 128 x 128 pixels
Slice thickness .......... 5.00
Slice spacing ............ 5.00
Number of slices ......... 16
Time Points .............. 1
File data type ........... unsigned short
Echo ..................... 1 of 1
Pixel min/max ............ -2147483648.00 / 2147483648.00


Show all Analyze header fields (y/n)?: n
---> (Note, entering y shows more detail) <---

Please note that the Analyze format does not actually include the tr in the standard specification. By convention, adopted from fsl and spm, the tr is placed in one of the less used data fields. Note also, that here at UCLA, I have re-used one of the header fields to convey other information about cropping and interpolation. At present, this is not displayed by ImageInfo. The range for Pixel min/max is actually calculated, when the data are brought in using imconvert. Otherwise, ImageInfo simplyu states what is in the header. Most of the tools I have seen for Analyze format images do not enter these data correctly.


MGH Image:

% ImageInfo Visual.bshort
Image file type: MGH bshort
Byte Order:  Big Endian (like a Macintosh)
----------------------------------------
Header name .............. Visual.hdr
Date/time (?)............. Tue Apr 30 18:30:01 2002
----------------------------------------
Resolution (x / y) ....... 3.125 x 3.125 mm
Display FoV (x / y) ...... 200 / 200 mm
Display Pixels (x / y) ... 3.125 / 3.125 mm
Display matrix ........... 64 x 64 pixels
Slice thickness .......... 4.00
Slice spacing ............ 0.00
Number of slices ......... 1
Time Points .............. 75
File data type ........... unsigned short
TR ....................... 2500.0 msec
Echo ..................... 1 of 1

The MGH format does not actually include the tr, FoV, resolution, thickness,slice spacing or even the number of slices. ImageInfo and imconvert make a guess.


Signa genesis Image:

% ImageInfo E2174S4I92.MR
Image file type: Signa Genesis
Byte Order:  Big Endian (like a Macintosh)
----------------------------------------
Exam number .............. 2174
Series number ............ 4
Image number ............. 92
Date/time (?)............. Wed Mar  1 15:45:00 2000
Scan duration ............ 11:44.20 min
Subject Name ............. 1038
Patient ID ............... 1038
Age ...................... 33 years
Sex ...................... Female or not specified
Weight ................... 162.7 pounds
Scan description ......... ICBM-1999
Hospital Name ............ UCLA Brain Mapping
Field strength ........... 3.00 Tesla
----------------------------------------
pulse sequence name ...... newfse
acq matrix ............... 256 x 256
Resolution (x / y) ....... 0.859 x 0.859 mm
Display FoV (x / y) ...... 220 / 220 mm
Display Pixels (x / y) ... 0.859 / 0.859 mm
Display matrix ........... 256 x 256 pixels
Slice thickness .......... 2.00
Slice spacing ............ 0.00
Top left RAS coords ...... -22.80 110.00 122.80
Top right RAS coords ..... -22.80 -110.00 122.80
Bottom right RAS coords .. -22.80 -110.00 -97.20
Normal RAS coords ........ 1.00 0.00 0.00
Number of slices ......... 1
Time Points .............. 1
File data type ........... unsigned short
TR ....................... 5500.0 msec
TE ....................... 85.00 msec
nex ...................... 1.0
acquisitions ............. -13107
Flip Angle ............... 90 degrees
Acquisition bandwidth .... 16.000 kiloHertz
Echo ..................... 2 of 2
Echo train length ........ 8
Transmitter gain ......... 131
Receiver gain (1) ........ 6
Receiver gain (2) ........ 29
Pixel min/max ............ 0.00 / 687.00

There are many more data fields in the Signa header than are displayed by ImageInfo. Interested users could modify the program to list more infomation. The data/time field is not always correct, as the different computers that are the source of these images have differing conventions on how this is stored.


Back to HowTo pages
This page is maintained by Mark Cohen [updated 4.16.02]