Slicer:VTK ITK Coordinates

From NAMIC Wiki
Revision as of 13:22, 18 December 2006 by Andy (talk | contribs) (Update from Wiki)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Home < Slicer:VTK ITK Coordinates

Background

Both VTK and ITK have their image origin in the lower left corner of the image. The BIG difference is in the way they read in the data.

VTK view of Image Data

From the vtkDICOMImageReader: http://public.kitware.com/cgi-bin/viewcvs.cgi/IO/vtkDICOMImageReader.cxx?annotate=1.32

   // DICOM stores the upper left pixel as the first pixel in an
   // image. VTK stores the lower left pixel as the first pixel in
   // an image.  Need to flip the data.

Note that every vtk image reader does the mapping from the way data is stored on disk into the way it is stored in memory. For Slicer's Nrrd reader and Generic readers (based on ITK infrastructure), this is done using the vtkImageFlip filter to flip data along the y axis of the data after it is read as a block.

ITK view of Image Data

ITK internally does not do the same flipping of the data during read that VTK does. As result, if image data is passed from ITK to VTK for rendering, the pictures will appear upside down unless flipped.

Using VTK and ITK in Situations with Orientation Directions

Slicer

In slicer, images are stored in VTK convention with:

  • RasToIjk telling the mapping from patient space to the way data was originally on disk
  • RasToVtk tell the mapping to the way VTK stores it in memory (flipped in Y)

Slicer composites all volume data in RAS space (axes pointing along Right-Anterior-Superior, which origin at the center of the volume by default). The rendering from RAS to View coordinates can select to view the data axial, coronal etc.

ITK

In ITK, the Spacing and Directions members of an itk::ImageBase holds the same information as slicer's RasToIjk (except stored differently).

Registration Framework

In order for the ITK Registration framework to generate RAS-to-RAS transforms, the slicer code resamples the image data including the flips.

Notes:

Although it is possible to represent the differences (the flip) in the Directions in ITK and/or the RasToIjk matrix in slicer, the drawback is that there isn't a 'standard' slice orientation which describes this difference (choices are IS, SI, AP, PA, RL, LR each of which corresponds to a radiology standard acquisition layout).