m-inw(4) - f39

1M-INW(4)                   Kernel Interfaces Manual                   M-INW(4)
2
3
4

NAME

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

DESCRIPTION

9  This  is  a  local file format used at the RUG (Ghent, Belgium). The headers
10  and image data are written in one file with extension `.im'.
11
12  The basic defines for the format:
13
14  ---------------------------------------------------------------------------
15  typedef struct Head_start_t {
16
17          Int32 mark;           /* should be HEADER_MARK                */
18          Int16 version;        /* high*256 + low                       */
19          Int16 size_header;    /* whole header (in bytes)              */
20          Int16 size_start;     /* sizeof(Head_start_t)                 */
21          Int16 size_gen;       /* sizeof(Head_gen_t)                   */
22          Int16 size_spec;      /* sizeof(Head_spec_t)                  */
23          char  reserved[10];
24
25  } MDC_INW_HEAD_START;         /* current size: 24                     */
26
27  #define MDC_INW_HEAD_START_SIZE 24
28
29  typedef struct Head_gen_t {
30
31          Int16 no;             /* number of planes                     */
32          Int16 sizeX;          /* number of columns                    */
33          Int16 sizeY;          /* number of rows                       */
34          Int16 pixel_type;     /* sizeof(pixel)                        */
35                                /* for compatibility only 2 is allowed  */
36          Int16 init_trans;     /* initial translation (mm)             */
37          Int16 dummy1;         /* for alignment reasons only           */
38
39          /* Note: We take the positive axis into the gantry !
40                   This means, if the patient lies with his head into
41                   the gantry, the head has higher translation offset
42                   than his feet                                        */
43
44          char  day[12];        /* day of first scan eg. 04-AUG-89      */
45          Int32 time;           /* seconds after midnight               */
46                                /* first scan or time activity measured */
47          float decay_cst;      /* NOT half_life ! (discards log(2))    */
48                                /* decay_cst = half_life / log(2)       */
49          float pixel_size;     /* sampling distance (mm)               */
50          float max;            /* scaled maximum of all images         */
51          float min;
52          Int16 scanner;        /* EcatII, EcatIV                       */
53          char  reconstruction; /* reconFBP, reconMaxLik,...            */
54          char  recon_version;  /* reconstruction version (0-99)        */
55          char  reserved[24];
56
57  } MDC_INW_HEAD_GEN;           /* current size: 72                     */
58
59  #define MDC_INW_HEAD_GEN_SIZE 72
60
61  typedef struct Head_spec_t {
62
63          Int32 time;           /* time relative to gen.time (secs)     */
64          float cal_cst;        /* abs_activ(uCU/ml) = cal_cst*pix_val  */
65                                /* cal_cst = calibr_cst * decay_comp    */
66                                /* decay_comp = exp(time/decay_cst)     */
67          Int32 max;            /* maximum in plane                     */
68          Int32 min;            /* minimum in plane                     */
69          Int16 trans;          /* translation relative to gen.trans mm */
70          char  reserved[6];
71
72  } MDC_INW_HEAD_SPEC;          /* current size: 24                     */
73
74  #define MDC_INW_HEAD_SPEC_SIZE 24
75
76  ---------------------------------------------------------------------------
77
78  What does the format support or not support:
79
80  ===========================================================================
81  Item            Supported                             Not Supported
82  ===========================================================================
83  Color Map     : grayscale                                   -
84  File Endian   : little                                     big
85  Pixeltypes    : Int16                                       -
86  ===========================================================================
87  Scaling factors  : quantify or calibrate factors/image are supported
88  ---------------------------------------------------------------------------
89  Dimensions/Image : different dimensions for each image are NOT supported
90  ---------------------------------------------------------------------------
91  Pixeltypes/Image : different pixeltypes for each image are NOT supported
92  ===========================================================================
93

NOTES

95  The first two structures in the file  are  HEAD_START  and  HEAD_GEN.  After
96  these  data  structures, a number of HEAD_SPEC structures follow, as much as
97  there are images in the file.  The float values in the headers are stored as
98  VAX floats!
99
100  Following  the headers are the binary image data. The images are stored from
101  left to right and from top to bottom. The pixel  values  are  Int16,  little
102  endian.
103

FILES

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

AUTHOR

116  (X)MedCon  project was originally written by Erik Nolf (eNlf) for the former
117  PET-Centre at Ghent University (Belgium).
118
119  e-mail:   enlf-at-users.sourceforge.net   www:   http://xmedcon.sourceforge.net
120
121
122
123
124                                                                      M-INW(4)

NAME

DESCRIPTION

NOTES

FILES

SEE ALSO

AUTHOR