NAME

    dsr2html


SYNOPSIS

    dsr2html [options] dsrfile-in [htmlfile-out]


SUMMARY

The dsr2html utility renders the contents of a DICOM Structured Reporting (SR)
document (file format or raw data set) to HTML (Hyper Text Markup Language)
which is compatible with version 3.2 or 4.0.

If dsr2html reads a raw data set (DICOM data without a file format meta-
header) it will attempt to guess the transfer syntax by examining the first few
bytes of the file.  It is not always possible to correctly guess the transfer
syntax and it is better to convert a data set to a file format whenever
possible (using the dcmconv utility).  It is also possible to use the -f and
-t[ieb] options to force dsr2html to read a dataset with a particular transfer
syntax.


USAGE

dsr2html: Render DICOM SR file and data set to HTML
usage: dsr2html [options] dsrfile-in [htmlfile-out]

parameters:
  dsrfile-in                    DICOM SR input filename to be rendered
  htmlfile-out                  HTML output filename (default: stdout)

general options:
  -h     --help                 print this help text and exit
         --version              print version information and exit
  -d     --debug                debug mode, print debug information
  -dd    --verbose-debug        verbose debug mode, print more details
input options:
  input file format:
    +f   --read-file            read file format or data set (default)
    -f   --read-dataset         read data set without file meta information
  input transfer syntax (only with --read-dataset):
    -t=  --read-xfer-auto       use TS recognition (default)
    -te  --read-xfer-little     read with explicit VR little endian TS
    -tb  --read-xfer-big        read with explicit VR big endian TS
    -ti  --read-xfer-implicit   read with implicit VR little endian TS
parsing options:
  additional information:
    -Ip  --processing-details   show currently processed content item
  error handling:
    -Ec  --ignore-constraints   ignore relationship content constraints
    -Ei  --skip-invalid-items   skip invalid content items (incl. sub-tree)
output options:
  HTML compatibility:
    +H3  --html-3.2             use only HTML version 3.2 compatible features
    +H4  --html-4.0             allow all HTML version 4.0 features (default)
    +Hd  --add-document-type    add reference to SGML document type definition
  cascading style sheet (CSS), only with HTML 4.0:
    +Sr  --css-reference        URL : string
                                add reference to specified CSS to HTML page
    +Sf  --css-file             filename : string
                                embed content of specified CSS into HTML page
  general rendering:
    +Ri  --expand-inline        expand short content items inline (default)
    -Ri  --never-expand-inline  never expand content items inline
    +Rd  --render-full-data     render full data of content items
  document rendering:
    +Dt  --document-type-title  use document type as document title (default)
    +Dp  --patient-info-title   use patient information as document title
    -Dh  --no-document-header   do not render general document information
  code rendering:
    +Ci  --render-inline-codes  render codes in continuous text blocks
    +Cn  --concept-name-codes   render code of concept names
    +Cu  --numeric-unit-codes   render code of numeric measurement units
    +Cv  --code-value-unit      use code value as measurement unit (default)
    +Cm  --code-meaning-unit    use code meaning as measurement unit
    +Ca  --render-all-codes     render all codes (implies +Ci, +Cn and +Cu)


DICOM CONFORMANCE

The dsr2xml application supports the following SOP Classes (according to
DICOM 2001):

    BasicTextSR                 "1.2.840.10008.5.1.4.1.1.88.11"
    EnhancedSR                  "1.2.840.10008.5.1.4.1.1.88.22"
    ComprehensiveSR             "1.2.840.10008.5.1.4.1.1.88.33"
    MammographyCADSR            "1.2.840.10008.5.1.4.1.1.88.50"
    KeyObjectSelectionDocument  "1.2.840.10008.5.1.4.1.1.88.59"


ENVIRONMENT

The dsr2html utility will attempt to load DICOM data dictionaries specified in
the DCMDICTPATH environment variable.  By default, if the DCMDICTPATH
environment variable is not set, the file /usr/local/dicom/lib/dicom.dic will
be loaded.  The default behaviour should be preferred and the DCMDICTPATH
environment variable only used when alternative data dictionaries are
required.  The DCMDICTPATH environment variable has the same format as the
shell PATH variable in that a colon (":") separates entries.  The data
dictionary code will attempt to load each file specified in the DCMDICTPATH
environment variable.  It is an error if no data dictionary can be loaded.