1dsr2html(1) OFFIS DCMTK dsr2html(1)
2
6 dsr2html - Render DICOM SR file and data set to HTML/XHTML
7
9 dsr2html [options] dsrfile-in [htmlfile-out]
10
12 The dsr2html utility renders the contents of a DICOM Structured
13 Reporting (SR) document (file format or raw data set) to HTML (Hyper
14 Text Markup Language) version 3.2 or 4.01 as well as to XHTML
15 (Extensible Hyper Text Markup Language) version 1.1.
16 If dsr2html reads a raw data set (DICOM data without a file format
18 meta-header) it will attempt to guess the transfer syntax by examining
19 the first few bytes of the file. It is not always possible to correctly
20 guess the transfer syntax and it is better to convert a data set to a
21 file format whenever possible (using the dcmconv utility). It is also
22 possible to use the -f and -t[ieb] options to force dsr2html to read a
23 dataset with a particular transfer syntax.
24
26 dsrfile-in DICOM SR input filename to be rendered
27 htmlfile-out HTML/XHTML output filename (default: stdout)
29
31 general options
32 -h --help
33 print this help text and exit
34 --version
36 print version information and exit
37 --arguments
39 print expanded command line arguments
40 -q --quiet
42 quiet mode, print no warnings and errors
43 -v --verbose
45 verbose mode, print processing details
46 -d --debug
48 debug mode, print debug information
49 -ll --log-level [l]evel: string constant
51 (fatal, error, warn, info, debug, trace)
52 use level l for the logger
53 -lc --log-config [f]ilename: string
55 use config file f for the logger
56 input options
58 input file format:
59 +f --read-file
61 read file format or data set (default)
62 +fo --read-file-only
64 read file format only
65 -f --read-dataset
67 read data set without file meta information
68 input transfer syntax:
70 -t= --read-xfer-auto
72 use TS recognition (default)
73 -td --read-xfer-detect
75 ignore TS specified in the file meta header
76 -te --read-xfer-little
78 read with explicit VR little endian TS
79 -tb --read-xfer-big
81 read with explicit VR big endian TS
82 -ti --read-xfer-implicit
84 read with implicit VR little endian TS
85 parsing options
87 additional information:
88 -Ip --processing-details
90 show currently processed content item
91 error handling:
93 -Er --unknown-relationship
95 accept unknown/missing relationship type
96 -Ec --ignore-constraints
98 ignore relationship content constraints
99 -Ee --ignore-item-errors
101 do not abort on content item errors, just warn
102 (e.g. missing value type specific attributes)
103 -Ei --skip-invalid-items
105 skip invalid content items (incl. sub-tree)
106 character set:
108 +Cr --charset-require
110 require declaration of extended charset (default)
111 +Ca --charset-assume [c]harset: string constant
113 (latin-1 to -5, greek, cyrillic, arabic, hebrew)
114 assume c if undeclared extended charset found
115 output options
117 HTML/XHTML compatibility:
118 +H3 --html-3.2
120 use only HTML version 3.2 compatible features
121 +H4 --html-4.0
123 allow all HTML version 4.01 features (default)
124 +X1 --xhtml-1.1
126 comply with XHTML version 1.1 specification
127 +Hd --add-document-type
129 add reference to SGML document type definition
130 cascading style sheet (CSS), not with HTML 3.2:
132 +Sr --css-reference URL: string
134 add reference to specified CSS to document
135 +Sf --css-file [f]ilename: string
137 embed content of specified CSS into document
138 general rendering:
140 +Ri --expand-inline
142 expand short content items inline (default)
143 -Ri --never-expand-inline
145 never expand content items inline
146 +Ra --always-expand-inline
148 always expand content items inline
149 +Rd --render-full-data
151 render full data of content items
152 +Rt --section-title-inline
154 render section titles inline, not separately
155 document rendering:
157 +Dt --document-type-title
159 use document type as document title (default)
160 +Dp --patient-info-title
162 use patient information as document title
163 -Dh --no-document-header
165 do not render general document information
166 code rendering:
168 +Ci --render-inline-codes
170 render codes in continuous text blocks
171 +Cn --concept-name-codes
173 render code of concept names
174 +Cu --numeric-unit-codes
176 render code of numeric measurement units
177 +Cv --code-value-unit
179 use code value as measurement unit (default)
180 +Cm --code-meaning-unit
182 use code meaning as measurement unit
183 +Cc --render-all-codes
185 render all codes (implies +Ci, +Cn and +Cu)
186 +Ct --code-details-tooltip
188 render code details as a tooltip (implies +Cc)
189
191 DICOM Conformance
192 The dsr2html utility supports the following SOP Classes:
193 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
195 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
196 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
197 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
198 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
199 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
200 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
201 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
202 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
203 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
204 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
205 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
206
208 The level of logging output of the various command line tools and
209 underlying libraries can be specified by the user. By default, only
210 errors and warnings are written to the standard error stream. Using
211 option --verbose also informational messages like processing details
212 are reported. Option --debug can be used to get more details on the
213 internal activity, e.g. for debugging purposes. Other logging levels
214 can be selected using option --log-level. In --quiet mode only fatal
215 errors are reported. In such very severe error events, the application
216 will usually terminate. For more details on the different logging
217 levels, see documentation of module 'oflog'.
218 In case the logging output should be written to file (optionally with
220 logfile rotation), to syslog (Unix) or the event log (Windows) option
221 --log-config can be used. This configuration file also allows for
222 directing only certain messages to a particular output stream and for
223 filtering certain messages based on the module or application where
224 they are generated. An example configuration file is provided in
225 <etcdir>/logger.cfg).
226
228 All command line tools use the following notation for parameters:
229 square brackets enclose optional values (0-1), three trailing dots
230 indicate that multiple values are allowed (1-n), a combination of both
231 means 0 to n values.
232 Command line options are distinguished from parameters by a leading '+'
234 or '-' sign, respectively. Usually, order and position of command line
235 options are arbitrary (i.e. they can appear anywhere). However, if
236 options are mutually exclusive the rightmost appearance is used. This
237 behaviour conforms to the standard evaluation rules of common Unix
238 shells.
239 In addition, one or more command files can be specified using an '@'
241 sign as a prefix to the filename (e.g. @command.txt). Such a command
242 argument is replaced by the content of the corresponding text file
243 (multiple whitespaces are treated as a single separator unless they
244 appear between two quotation marks) prior to any further evaluation.
245 Please note that a command file cannot contain another command file.
246 This simple but effective approach allows to summarize common
247 combinations of options/parameters and avoids longish and confusing
248 command lines (an example is provided in file <datadir>/dumppat.txt).
249
251 The dsr2html utility will attempt to load DICOM data dictionaries
252 specified in the DCMDICTPATH environment variable. By default, i.e. if
253 the DCMDICTPATH environment variable is not set, the file
254 <datadir>/dicom.dic will be loaded unless the dictionary is built into
255 the application (default for Windows).
256 The default behaviour should be preferred and the DCMDICTPATH
258 environment variable only used when alternative data dictionaries are
259 required. The DCMDICTPATH environment variable has the same format as
260 the Unix shell PATH variable in that a colon (':') separates entries.
261 On Windows systems, a semicolon (';') is used as a separator. The data
262 dictionary code will attempt to load each file specified in the
263 DCMDICTPATH environment variable. It is an error if no data dictionary
264 can be loaded.
265
267 <datadir>/report.css - Sample Cascading Stylesheet file for HTML
268 <datadir>/reportx.css - Sample Cascading Stylesheet file for XHTML
269
271 dcmconv(1)
272
274 Copyright (C) 2000-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
275 Germany.
276Version 3.6.0 6 Jan 2011 dsr2html(1)