Man Linux: Main Page and Category List

NAME

       m-inw - RUG INW1.0 medical image format (MedCon)

DESCRIPTION

  This  is  a  local file format used at the RUG (Ghent, Belgium). The headers
  and image data are written in one file with extension `.im'.

  The basic defines for the format:

  ---------------------------------------------------------------------------
  typedef struct Head_start_t {

          Int32 mark;           /* should be HEADER_MARK                */
          Int16 version;        /* high*256 + low                       */
          Int16 size_header;    /* whole header (in bytes)              */
          Int16 size_start;     /* sizeof(Head_start_t)                 */
          Int16 size_gen;       /* sizeof(Head_gen_t)                   */
          Int16 size_spec;      /* sizeof(Head_spec_t)                  */
          char  reserved[10];

  } MDC_INW_HEAD_START;         /* current size: 24                     */

  #define MDC_INW_HEAD_START_SIZE 24

  typedef struct Head_gen_t {

          Int16 no;             /* number of planes                     */
          Int16 sizeX;          /* number of columns                    */
          Int16 sizeY;          /* number of rows                       */
          Int16 pixel_type;     /* sizeof(pixel)                        */
                                /* for compatibility only 2 is allowed  */
          Int16 init_trans;     /* initial translation (mm)             */
          Int16 dummy1;         /* for alignment reasons only           */

          /* Note: We take the positive axis into the gantry !
                   This means, if the patient lies with his head into
                   the gantry, the head has higher translation offset
                   than his feet                                        */

          char  day[12];        /* day of first scan eg. 04-AUG-89      */
          Int32 time;           /* seconds after midnight               */
                                /* first scan or time activity measured */
          float decay_cst;      /* NOT half_life ! (discards log(2))    */
                                /* decay_cst = half_life / log(2)       */
          float pixel_size;     /* sampling distance (mm)               */
          float max;            /* scaled maximum of all images         */
          float min;
          Int16 scanner;        /* EcatII, EcatIV                       */
          char  reconstruction; /* reconFBP, reconMaxLik,...            */
          char  recon_version;  /* reconstruction version (0-99)        */
          char  reserved[24];

  } MDC_INW_HEAD_GEN;           /* current size: 72                     */

  #define MDC_INW_HEAD_GEN_SIZE 72

  typedef struct Head_spec_t {

          Int32 time;           /* time relative to gen.time (secs)     */
          float cal_cst;        /* abs_activ(uCU/ml) = cal_cst*pix_val  */
                                /* cal_cst = calibr_cst * decay_comp    */
                                /* decay_comp = exp(time/decay_cst)     */
          Int32 max;            /* maximum in plane                     */
          Int32 min;            /* minimum in plane                     */
          Int16 trans;          /* translation relative to gen.trans mm */
          char  reserved[6];

  } MDC_INW_HEAD_SPEC;          /* current size: 24                     */

  #define MDC_INW_HEAD_SPEC_SIZE 24

  ---------------------------------------------------------------------------

  What does the format support or not support:

  ===========================================================================
  Item            Supported                             Not Supported
  ===========================================================================
  Color Map     : grayscale                                   -
  File Endian   : little                                     big
  Pixeltypes    : Int16                                       -
  ===========================================================================
  Scaling factors  : quantify or calibrate factors/image are supported
  ---------------------------------------------------------------------------
  Dimensions/Image : different dimensions for each image are NOT supported
  ---------------------------------------------------------------------------
  Pixeltypes/Image : different pixeltypes for each image are NOT supported
  ===========================================================================

NOTES

  The first two structures in the file  are  HEAD_START  and  HEAD_GEN.  After
  these  data  structures, a number of HEAD_SPEC structures follow, as much as
  there are images in the file.  The float values in the headers are stored as
  VAX floats!

  Following  the headers are the binary image data. The images are stored from
  left to right and from top to bottom. The pixel  values  are  Int16,  little
  endian.

FILES

  /usr/local/xmedcon/source/m-inw.h     The header file.
  /usr/local/xmedcon/source/m-inw.c     The source file.

SEE ALSO

  medcon(1), xmedcon(1), xmedcon-config(1)

  m-acr(4), m-anlz(4), m-gif(4), m-intf(4), m-ecat(4)

  medcon(3)

AUTHOR

  (X)MedCon  project was originally written by Erik Nolf (eNlf) for the former
  PET-Centre at Ghent University (Belgium).

  e-mail:   enlf-at-users.sourceforge.net   www:   http://xmedcon.sourceforge.net