Dicom package

Revision as of 21:11, 20 December 2011 by Andybuckle (talk | contribs) (→‎Features: remove dicomwrite)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

At an early development stage. octave-forge svn

  • Maintainer: Andy Buckle [1]
  • Currently worked on by: Kris Thielemans

Supporting library

GCDM. You can usually get this via your package manager,e e.g. on Ubuntu

sudo apt-get install libgdcm2.0

Alternatively, build it yourself. Get the source with subversion.

svn co https://gdcm.svn.sourceforge.net/svnroot/gdcm/branches/gdcm-2-0

cmake and g++ are required. create a gdcmbin directory parallel to the gdcm-2-0 directory. Change to gdcmbin and then run cmake (Linux/cygwin).

> mkdir gdcmbin
> ls
gdcmbin gdcm-2-0
> cd gdcmbin
> cmake -DGDCM_BUILD_SHARED_LIBS=ON ../gdcm-2-0/

This creates a Makefile in your gdcmbin directory. You can easily edit cmake options with "make edit_cache", for example to build applications like gdcmdump. "make help" is also very useful.

make install

On my system, I also had to add this to my ~/.bashrc.

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib

Mingw32 is similar. Get openSSL: Win32 Openssl v1.0.0a Light

cmake -G "MinGW Makefile" -DGDCM_BUILD_SHARED_LIBS=ON ..\gdcm-2-0
mingw32-make all

Features

All of these still need work, but they exist, and are usable to some extent.

  • dicomdict (load different dict - file follows same format as Matlab's)
  • dicominfo (load metadata into octave struct. nasty bug in SQ loading)
  • dicomlookup (keyword <-> tag)
  • dicomread (load pixel data, 2D or 3D int types. Does not yield colormaps, yet.)

Todo

  • dicomanon
  • dicomuid

Questions

I don't have a Matlab license available. I would like to make this package compatible with the dicom functions in Matlab's image processing toolbox, as far as possible.

  • Octave (and Matlab) stores images (y,x) and DICOM is intrinsically (x,y). Does Matlab transpose images when it loads them?
    • matlab reads the data from the dicom file as if it's a raw block of numbers (and then converts if necessary). Therefore, current Octave/dicom behaviour is compatible with matlab.
  • I would like people to try m-files that worked with Matlab to let me know of problems.
  • (not necessarily) Matlab related: I need examples of odd DICOM files. I have plenty with complex metadata, but I need some with unusual images.
    • More than one sample per pixel
    • Colour
    • Float types
  • DA (date) VR: does Matlab turn them into a string?
  • if the user supplies metadata (eg HighBit?, BitsStored?) that describe the type of the pixels and this is not in agreement with the type of the image matrix supplied, does Matlab
    • silently convert the image pixel type to match the metadata?
    • silently convert the metadata to match the pixel type?
    • error and do nothing?
  • What does dicominfo do when a tag is not in its dictionary: skip it or give error? I was wondering about turning the tag into a variable name, something like Tag_3243_0010. (Matlab 6.5 (2002): Private__3243_0010)
  • dicominfo: Items in sequences are not necessarily the same, so cannot be stored in arrays of structs. (Matlab 6.5 (2002): makes nested structs like dcm.RTDoseROISequence?.Item_1.DoseUnits?)