1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl-ns/current/manpages/docbook.xsl" ?>
<!DOCTYPE Data [ <!ENTITY version SYSTEM 'version.txt'> ]>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink">
<info>
<author><personname><firstname>Mathieu</firstname><surname>Malaterre</surname></personname><contrib>Main developer</contrib></author>
<copyright><year>2006</year><year>2011</year><holder>Mathieu Malaterre</holder></copyright>
</info>
<refmeta>
<refentrytitle>gdcmpdf</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="source">GDCM</refmiscinfo>
<refmiscinfo class="version">&version;</refmiscinfo>
<refmiscinfo class="manual">DICOM Manipulation.</refmiscinfo>
</refmeta>
<refnamediv><refname>gdcmpdf</refname>
<refpurpose>Tool to convert PDF to PDF/DICOM.</refpurpose>
</refnamediv>
<refsection xml:id="gdcmxml_1synopsis">
<title>SYNOPSIS</title>
<para><literallayout>gdcmpdf [options] file-in file-out
</literallayout></para>
</refsection>
<refsection xml:id="gdcmxml_1description">
<title>DESCRIPTION</title>
<para>The <emphasis role="bold">gdcmpdf</emphasis> tool convert a PDF file (any PDF version) into an encapsulated PDF/DICOM file. By default it will try to read the PDF meta information stored in the PDF and convert this information to some specific DICOM fields (see below). However it may fails (eg. wrong password on encrypted PDF file) in which case empty value are used.</para>
</refsection>
<refsection xml:id="gdcmxml_1parameters">
<title>PARAMETERS</title>
<para><literallayout>file-in PDF input filename
file-out DICOM output filename
</literallayout></para>
</refsection>
<refsection xml:id="gdcmxml_1options">
<title>OPTIONS</title>
<refsection xml:id="gdcmxml_1general_options">
<title>general options</title>
<para><literallayout> -h --help
print this help text and exit
-v --version
print version information and exit
-V --verbose
verbose mode (warning+error).
-W --warning
warning mode, print warning information
-E --error
error mode, print error information
-D --debug
debug mode, print debug information
</literallayout></para>
</refsection>
</refsection>
<refsection xml:id="gdcmpdf_1usage_example">
<title>Usage Example</title>
<para><literallayout>$ wget http://gdcm.sourceforge.net/gdcm.pdf
$ gdcmpdf gdcm.pdf gdcm.dcm
</literallayout></para>
<para>To re-extract the encapsulated PDF file:</para>
<para><literallayout> $ gdcmraw -i gdcm.dcm -t 42,11 -o gdcm.dcm.pdf
$ diff gdcm.pdf gdcm.dcm.pdf
</literallayout></para>
</refsection>
<refsection xml:id="gdcmpdf_1pdf_mapping">
<title>PDF Info Mapping</title>
<para>Here is how the PDF info is mapped to DICOM information (typical pdfinfo output):</para>
<para><literallayout>Title: GDCM Reference Manual
Subject: Grassroots DICOM API reference
Keywords: GDCM,DICOM,JPEG,Lossless JPEG,JPEG-LS,J2K,JPEG 2000,RLE
Author: Mathieu Malaterre and co.
Creator: LaTeX with hyperref package
Producer: pdfeTeX-1.21a
CreationDate: Tue Apr 28 15:34:26 2009
Tagged: no
Pages: 1188
Encrypted: no
Page size: 612 x 792 pts (letter)
File size: 13756841 bytes
Optimized: yes
PDF version: 1.4
</literallayout></para>
<para>Converted to DICOM this leads to:</para>
<para><literallayout># Dicom-Data-Set
# Used TransferSyntax: Little Endian Explicit
(0008,0005) CS [ISO_IR 100] # 10, 1 SpecificCharacterSet
(0008,0012) DA [20090428] # 8, 1 InstanceCreationDate
(0008,0013) TM [182550.302631] # 14, 1 InstanceCreationTime
(0008,0016) UI =EncapsulatedPDFStorage # 30, 1 SOPClassUID
(0008,0018) UI [1.2.826.0.1.3680043.2.1143.776842935192792959289022034349197114] # 64, 1 SOPInstanceUID
(0008,0020) DA [20090428] # 8, 1 StudyDate
(0008,0023) DA [20090428] # 8, 1 ContentDate
(0008,002a) DT [20090428153437.000000] # 22, 1 AcquisitionDateTime
(0008,0030) TM [182550.302160] # 14, 1 StudyTime
(0008,0033) TM [153426.000000] # 14, 1 ContentTime
(0008,0050) SH (no value available) # 0, 0 AccessionNumber
(0008,0060) CS [OT] # 2, 1 Modality
(0008,0064) CS [WSD] # 4, 1 ConversionType
(0008,0070) LO [LaTeX with hyperref package] # 28, 1 Manufacturer
(0008,0090) PN (no value available) # 0, 0 ReferringPhysiciansName
(0010,0010) PN [Mathieu Malaterre and co.] # 26, 1 PatientsName
(0010,0020) LO (no value available) # 0, 0 PatientID
(0010,0030) DA (no value available) # 0, 0 PatientsBirthDate
(0010,0040) CS (no value available) # 0, 0 PatientsSex
(0018,1020) LO [pdfeTeX-1.21a] # 14, 1 SoftwareVersions
(0020,000d) UI [1.2.826.0.1.3680043.2.1143.1868121832223417351654232480755123133] # 64, 1 StudyInstanceUID
(0020,000e) UI [1.2.826.0.1.3680043.2.1143.1330099150825746617507846107663964311] # 64, 1 SeriesInstanceUID
(0020,0010) SH (no value available) # 0, 0 StudyID
(0020,0011) IS [1] # 2, 1 SeriesNumber
(0020,0013) IS [1] # 2, 1 InstanceNumber
(0028,0301) CS [YES] # 4, 1 BurnedInAnnotation
(0040,a043) SQ (Sequence with explicit length #=0) # 0, 1 ConceptNameCodeSequence
(fffe,e0dd) na (SequenceDelimitationItem for re-encod.) # 0, 0 SequenceDelimitationItem
(0042,0010) ST [GDCM Reference Manual] # 22, 1 DocumentTitle
(0042,0011) OB 25\\50\\44\\46\\2d\\31\\2e\\34\\0a\\25\\e7\\f3\\cf\\d3\\0a\\33\\32\\30\\37\\37\\20\\30... # 13756842, 1 EncapsulatedDocument
(0042,0012) LO [application/pdf] # 16, 1 MIMETypeOfEncapsulatedDocument
</literallayout></para>
<para><literallayout>$ stat gdcm.pdf
File: `gdcm.pdf'
Size: 13756841 Blocks: 26912 IO Block: 4096 regular file
Device: fe01h/65025d Inode: 2675750 Links: 1
Access: (0644/-rw-r--r--) Uid: ( 1002/mmalaterre) Gid: ( 1002/mmalaterre)
Access: 2009-04-28 16:05:00.000000000 +0200
Modify: 2009-04-28 15:34:37.000000000 +0200
Change: 2009-04-28 16:05:00.000000000 +0200
</literallayout></para>
<para>Explanation for the different Date/Time mappings:</para>
<para><itemizedlist>
<listitem>
<para>Study Date/Time, Instance Creation Date/Time are both equal to the current time gdcmpdf tool was run, </para>
</listitem>
<listitem>
<para>Acquisition Date Time is set to the Modify Time of the actual PDF file, </para>
</listitem>
<listitem>
<para>Content Date/Time are set from the actual PDF header info: CreationDate.</para>
</listitem>
</itemizedlist>
</para>
</refsection>
<refsection xml:id="gdcmxml_1see_also">
<title>SEE ALSO</title>
<para><emphasis role="bold">gdcmconv</emphasis>(1), <emphasis role="bold">gdcmraw</emphasis>(1), <emphasis role="bold">pdfinfo</emphasis>(1)</para>
</refsection>
</refentry>
|
