]> Creatis software - gdcm.git/blob - Doc/Website/ConformanceSummary.html
ENH: Yes we handle j2k and lossless now
[gdcm.git] / Doc / Website / ConformanceSummary.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML>
3 <HEAD>
4    <META http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
5    <TITLE>Gdcm supported formats</TITLE>
6 </HEAD>
7
8 <BODY>
9
10 <!#######################################################################>
11 <H1>Gdcm DICOM v3.0 conformance summary</H1>
12 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
13
14 <!#######################>
15 <H2>Introduction</H2>
16
17 This section is an abbreviated DICOM conformance statement for gdcm.
18 <BR>
19 It specifies the compliance of gdcm to file reading/writing
20 support to the
21 <A HREF="http://www.dclunie.com/dicom-status/status.html">
22           dicom base standard <B>part 5</B></A>.
23 <BR>
24 Gdcm <B>does not contain or support any of the DICOM services</B>
25 such as Storage, Query/Retrieve, Print, Verification...
26
27 <!##############################################>
28 <H2>Supported transfer syntaxes (Reading)</H2>
29 The Transfer Syntax UID is in the file DICOM Tag field (0002,0010).
30
31 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
32        BGCOLOR="#ffffff">
33 <!####### Uncompressed #########>
34 <TR BGCOLOR="#99ccff">
35    <TH> Uncompressed Transfer Syntax </TH>
36    <TH> Description </TH>
37 </TR>
38 <TR>
39    <TD> 1.2.840.10008.1.2 </TD>
40    <TD> Implicit VR - Little Endian</TD>
41 </TR>
42 <TR>
43    <TD> 1.2.840.10008.1.2.1 </TD>
44    <TD> Explicit VR - Little Endian</TD>
45 </TR>
46 <TR>
47    <TD> 1.2.840.10008.1.2.1.99</TD>
48    <TD> Deflated Explicit VR - Little Endian</TD>
49 </TR>
50 <TR>
51    <TD> 1.2.840.10008.1.2.2 </TD>
52    <TD> Explicit VR - Big Endian </TD>
53 </TR>
54 <TR>
55    <TD> 1.2.840.113619.5.2 </TD>
56    <TD> Implicit VR - Big Endian (G.E Private) </TD>
57 </TR>
58
59
60 <!####### RLE #########>
61 <TR BGCOLOR="#99ccff">
62    <TD> RLE Transfer Syntax </TD>
63    <TD></TD>
64 </TR>
65 <TR>
66    <TD> 1.2.840.10008.1.2.5 </TD>
67    <TD> Run Length Encoding, Lossless</TD>
68 </TR>
69
70 <!####### JPEG #########>
71 <TR BGCOLOR="#99ccff">
72    <TD> JPEG Transfer Syntax </TD>
73    <TD></TD>
74 </TR>
75 <TR>
76    <TD> 1.2.840.10008.1.2.4.50 </TD>
77    <TD> JPEG Baseline (Process 1)</TD>
78 </TR>
79 <TR>
80    <TD> 1.2.840.10008.1.2.4.51 </TD>
81    <TD> JPEG Extended (Process 2 & 4) </TD>
82 </TR>
83 <TR>
84    <TD> 1.2.840.10008.1.2.4.57 </TD>
85    <TD> JPEG Lossless, Non-Hierarchical (Process 14) </TD>
86 </TR>
87 <TR>
88    <TD> 1.2.840.10008.1.2.4.70 </TD>
89    <TD> JPEG Lossless, Hierarchical, First-Order
90         Prediction (Process 14, [Selection Value 1]) </TD>
91 </TR>
92 <TR>
93    <TD> 1.2.840.10008.1.2.4.90 </TD>
94    <TD> JPEG 2000 Image Compression (Lossless Only) </TD>
95 </TR>
96 <TR>
97    <TD> 1.2.840.10008.1.2.4.91 </TD>
98    <TD> JPEG 2000 Image Compression </TD>
99 </TR>
100 </TABLE>
101
102 <!##############################################>
103 <H2>Supported transfer syntaxes (Writing)</H2>
104 The Transfer Syntax UID is in the file DICOM Tag field (0002,0010).
105
106 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
107        BGCOLOR="#ffffff">
108 <!####### Uncompressed #########>
109 <TR BGCOLOR="#99ccff">
110    <TH> Uncompressed Transfer Syntax </TH>
111    <TH> Description </TH>
112 </TR>
113 <TR>
114    <TD> 1.2.840.10008.1.2 </TD>
115    <TD> Implicit VR - Little Endian</TD>
116 </TR>
117 <TR>
118    <TD> 1.2.840.10008.1.2.1 </TD>
119    <TD> Explicit VR - Little Endian</TD>
120 </TR>
121 <!####### JPEG #########>
122 <TR BGCOLOR="#99ccff">
123    <TD> JPEG Transfer Syntax </TD>
124    <TD></TD>
125 </TR>
126 <TR>
127    <TD> 1.2.840.10008.1.2.4.50 </TD>
128    <TD> JPEG Baseline (Process 1)</TD>
129 </TR>
130 <TR>
131    <TD> 1.2.840.10008.1.2.4.51 </TD>
132    <TD> JPEG Extended (Process 2 & 4) </TD>
133 </TR>
134 <TR>
135    <TD> 1.2.840.10008.1.2.4.57 </TD>
136    <TD> JPEG Lossless, Non-Hierarchical (Process 14) </TD>
137 </TR>
138 <TR>
139    <TD> 1.2.840.10008.1.2.4.70 </TD>
140    <TD> JPEG Lossless, Hierarchical, First-Order
141         Prediction (Process 14, [Selection Value 1]) </TD>
142 </TR>
143 <TR>
144    <TD> 1.2.840.10008.1.2.4.90 </TD>
145    <TD> JPEG 2000 Image Compression (Lossless Only) </TD>
146 </TR>
147 <TR>
148    <TD> 1.2.840.10008.1.2.4.91 </TD>
149    <TD> JPEG 2000 Image Compression </TD>
150 </TR>
151 </TABLE>
152 <!##############################################>
153 <H2>Supported "Photometric Interpretation" pixel format (Reading)</H2>
154 The Photometric Interpretation UID is in the file DICOM Tag field (0028,0004).
155
156 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
157        BGCOLOR="#ffffff">
158 <TR BGCOLOR="#99ccff">
159    <TH> Photometric Interpretation" pixel format </TH>
160    <TH> Description </TH>
161 </TR>
162 <TR>
163    <TD> MONOCHROME1 </TD>
164    <TD> grey level image description (high values=dark, low values=bright)</TD>
165 </TR>
166 <TR>
167    <TD> MONOCHROME2 </TD>
168    <TD> grey level image description (high values=bright, low values=dark)</TD>
169 </TR>
170 <TR>
171    <TD> PALETTE COLOR </TD>
172    <TD> pseudo color image description</TD>
173 </TR>
174 <TR>
175    <TD> RGB </TD>
176    <TD> true color image description</TD>
177 </TR>
178 <TR>
179    <TD> YBR_FULL </TD>
180    <TD> true color image description</TD>
181 </TR>
182 <TR>
183    <TD> YBR_FULL_422 </TD>
184    <TD> true color image description</TD>
185 </TR>
186 </TABLE>
187
188 </TABLE>
189 <!##############################################>
190 <H2>Supported "Photometric Interpretation" pixel format (Writing)</H2>
191 The Photometric Interpretation UID is in the file DICOM Tag field (0028,0004).
192
193 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
194        BGCOLOR="#ffffff">
195 <TR BGCOLOR="#99ccff">
196    <TH> Photometric Interpretation" pixel format </TH>
197    <TH> Description </TH>
198 </TR>
199 <TR>
200    <TD> MONOCHROME2 </TD>
201    <TD> grey level image description (high values=bright, low values=dark)</TD>
202 </TR>
203 <TR>
204    <TD> PALETTE COLOR </TD>
205    <TD> pseudo color image description</TD>
206 </TR>
207 <TR>
208    <TD> RGB </TD>
209    <TD> true color image description</TD>
210 </TR>
211
212 </TABLE>
213
214
215 <!##############################################>
216 <H2>Supported 'Bits Allocated' values (Reading)</H2>
217 The Bits Allocated value is in the file DICOM Tag field (0020,0100).
218
219 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
220        BGCOLOR="#ffffff">
221 <!####### Uncompressed #########>
222 <TR BGCOLOR="#99ccff">
223    <TH> Classical values </TH>
224    <TH> Description </TH>
225 </TR>
226 <TR>
227    <TD> 8, 12, 16 </TD>
228    <TD> 12 means that 4 pixels are stored in 3 'short int'</TD>
229 </TR>
230 <TR BGCOLOR="#99ccff">
231    <TH> Unusual values </TH>
232    <TH> Description </TH></TR>
233 <TR>
234    <TD> 24 </TD>
235    <TD> Some ACR-NEMA RGB files came with 'Bits Allocated' = 24
236      and 'Samples Per Pixel' = 1, or with no 'Samples Per Pixel' 
237      at all  </TD>
238 </TR>
239 <TR>  
240    <TD> 32 </TD>
241    <TD> Some ACR-NEMA files, from CT,  came with 'Bits Allocated' = 32
242       (probabely 65535 grey levels was not enough for them ...) 
243    </TD>
244 </TR>
245 </TABLE>
246
247 <!##############################################>
248 <H2> Note on odd length data elements</H2>
249
250 The Dicom Standard PS 3.5 (Data Structures and Encoding) specifies that
251 the data element values which make up a DICOM data stream must be padded
252 to an even length.
253 <BR>
254 Gdcm will <B>tolerate</B> an incorrectly formed odd length data field while
255 <B>reading</B> (thus not enforcing the standard).
256 <BR>
257 But gdcm will always <B>enforce</B> the standard while <B>writing</B>.
258
259 <!##############################################>
260 <H2> Note on undefined Value Representations</H2>
261
262 If gdcm encounters an undefined VR (either because in a private group,
263 or because it corresponds to an undocumented public dictionary entry
264 when in implicit VR) while reading a file, it will set that data
265 element's VR to be UN (unknown).
266
267 <!##############################################>
268 <H2> Note on missing 'Mandatory' Tags</H2>
269
270 Each time it's possible to assume a 'reasonable' default value for missing
271 'mandatory' tag, gdcm does it. <br>
272 For instance if the Tag 'Samples Per Pixels' is missing, we assume its value is
273 '1' (Grey pixels, as opposite to RGB); <br>
274 if the tag 'High Bit' is missing, we
275 assume its value is 'Bits stored -1' (i.e. : no bad trick inside the pixels)<br>
276 As gdcm wants to read *as well* old ACR-NEMA files, it has to be widely
277 tolerant.
278
279
280 <!##############################################>
281 <H2> Note 'Value Multiplicity'</H2>
282
283 gdcm believes what's written on disc, better than the 'Dicom Dictionary'.<br>
284 For instance if the field 'Pixels Spacing' contains a single value -instead of
285 the mandatory two, gdcm will suppose both values are equal.
286
287
288 <!##############################################>
289 <H2>Note on retired data elements</H2>
290
291 Certain data elements are no longer supported under the v3.0 of the DICOM
292 standard but persist as retired element. Gdcm maintain them in its Dicom
293 Dictionary, postfix their names with the "(RET)" string, and goes on dealing
294 with them as standard data elements.
295
296
297 <!#######################################################################>
298 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
299 <H2><B>UN</B>Supported transfer syntaxes</H2>
300 The Transfer Syntax UID is in the file DICOM Tag field (0002,0010).
301                                                                                 
302 <TABLE WIDTH="800" BORDER="0" CELLSPACING="1" CELLPADDING="10"
303        BGCOLOR="#ffffff">
304 <!####### Uncompressed #########>
305 <TR BGCOLOR="#99ccff">
306    <TH> Jpeg UNSUPPORTED Transfer Syntax </TH>
307    <TH> Description </TH>
308 </TR>
309 <TR>
310    <TD> 1.2.840.10008.1.2.4.52 </TD>
311    <TD> JPEG Extended (Process 3 & 5) </TD>
312 </TR>
313 <TR>
314    <TD> 1.2.840.10008.1.2.4.53</TD>
315    <TD> JPEG Spectral Selection, Non-Hierarchical (Process 6 & 8)</TD>
316 </TR>
317 <TR>
318    <TD> 1.2.840.10008.1.2.4.54 </TD>
319    <TD> JPEG Spectral Selection, Non-Hierarchical (Process 7 & 9)</TD>
320 </TR>
321 <TR>
322    <TD> 1.2.840.10008.1.2.4.55 </TD>
323    <TD> JPEG Full Progression, Non-Hierarchical (Process 10 & 12)</TD>
324 </TR>
325 <TR>
326    <TD> 1.2.840.10008.1.2.4.56 </TD>
327    <TD> JPEG Full Progression, Non-Hierarchical (Process 11 & 13) </TD>
328 </TR>
329 <TR>
330    <TD> 1.2.840.10008.1.2.4.59 </TD>
331    <TD> JPEG Extended, Hierarchical (Process 16 & 18) </TD>
332 </TR>
333 <TR>
334    <TD> 1.2.840.10008.1.2.4.60 </TD>
335    <TD> JPEG Extended, Hierarchical (Process 17 & 19)</TD>
336 </TR>
337 <TR>
338    <TD> 1.2.840.10008.1.2.4.61 </TD>
339    <TD> JPEG Spectral Selection, Hierarchical (Process 20 & 22) </TD>
340 </TR>
341 <TR>
342    <TD> 1.2.840.10008.1.2.4.62 </TD>
343    <TD> JPEG Spectral Selection, Hierarchical (Process 21 & 23) </TD>
344 </TR>
345 <TR>
346    <TD> 1.2.840.10008.1.2.4.63 </TD>
347    <TD> JPEG Full Progression, Hierarchical (Process 24 & 26)</TD>
348 </TR>
349 <TR>
350    <TD> 1.2.840.10008.1.2.4.64 </TD>
351    <TD> JPEG Full Progression, Hierarchical (Process 25 & 27) </TD>
352 </TR>
353 <TR>
354    <TD> 1.2.840.10008.1.2.4.80 (partial)</TD>
355    <TD> JPEG-LS Lossless Image Compression </TD>
356 </TR>
357 <TR>
358    <TD> 1.2.840.10008.1.2.4.81 (partial)</TD>
359    <TD> JPEG-LS Lossy (Near-Lossless) Image Compression </TD>
360 </TR>
361 <TR>
362    <TD> 1.2.840.10008.1.2.4.100 (partial)</TD>
363    <TD> MPEG2 Main Profile @ Main Level </TD>
364 </TR>
365
366 </TABLE>
367
368
369 <HR size="1"><ADDRESS style="align: right;"></ADDRESS>
370
371 </BODY>
372 </HTML>