1dcmdspfn(1)                       OFFIS DCMTK                      dcmdspfn(1)
2
3
4

NAME

6       dcmdspfn - Export standard display curves to a text file
7
8

SYNOPSIS

10       dcmdspfn [options]
11

DESCRIPTION

13       Command  line  program  converts  a  DCMTK monitor / camera / printer /
14       scanner  characteristics  file  to  tabbed  text  file  describing  the
15       characteristic   curve   (CC),  the  display  function  and  the  post-
16       standardized curve (PSC) for an 8 bit display. The 256 values  of  each
17       curve  can  be  visualized by a common spread sheet program. Above that
18       the display curve (without CC and PSC)  can  also  be  computed  for  a
19       specified  luminance/OD range (min/max) and a certain number of Digital
20       Driving Levels (DDL).
21

PARAMETERS

23       dcmfile-in  DICOM input filename to be dumped
24

OPTIONS

26   general options
27         -h   --help
28                print this help text and exit
29
30              --version
31                print version information and exit
32
33              --arguments
34                print expanded command line arguments
35
36         -q   --quiet
37                quiet mode, print no warnings and errors
38
39         -v   --verbose
40                verbose mode, print processing details
41
42         -d   --debug
43                debug mode, print debug information
44
45         -ll  --log-level  [l]evel: string constant
46                (fatal, error, warn, info, debug, trace)
47                use level l for the logger
48
49         -lc  --log-config  [f]ilename: string
50                use config file f for the logger
51
52   input options (mutually exclusive)
53         +Im  --monitor-file  [f]ilename: string
54                text file describing the monitor characteristics
55
56         +Ic  --camera-file  [f]ilename: string
57                text file describing the camera characteristics
58
59         +Ip  --printer-file  [f]ilename: string
60                text file describing the printer characteristics
61
62         +Is  --scanner-file  [f]ilename: string
63                text file describing the scanner characteristics
64
65         +Il  --lum-range  [m]in max: float
66                minimum and maximum luminance (cd/m^2)
67
68         +Io  --od-range  [m]in max: float
69                minimum and maximum optical density (OD),
70                automatically converted to luminance
71
72   creation options
73         +Ca  --ambient-light  [a]mbient light: float
74                ambient light value (cd/m^2, default: file f)
75
76         +Ci  --illumination  [i]llumination: float
77                illumination value (cd/m^2, default: file f)
78
79         +Dn  --min-density  [m]inimum optical density: float
80                Dmin value (default: off, only with +Ip and +Io)
81
82         +Dx  --max-density  [m]aximum optical density: float
83                Dmax value (default: off, only with +Ip and +Io)
84
85         +Cd  --ddl-count  [n]umber of DDLs: integer
86                number of Digital Driving Levels
87                (default: 256, only with --lum/od-range)
88
89         +Cf  --curve-fitting  [n]umber: integer
90                use polynomial curve fitting algorithm with order n
91                (0..99, default: file setting or cubic spline)
92
93   output options
94         +Og  --gsdf  [f]ilename: string
95                write GSDF curve data to file f
96
97         +Oc  --cielab  [f]ilename: string
98                write CIELAB curve data to file f
99

NOTES

101       The output file describing the CC, GSDF or CIELAB and PSC for an 8  bit
102       display  system  (monitor, camera, printer or scanner) is a simple text
103       file. Lines starting with a '#' are treated as comments and, therefore,
104       skipped  as  well  as  blank  lines.  An input file can for instance be
105       created by the command line tool dconvlum.
106
107       The ambient light value possibly defined in the characteristics file is
108       also  used  for  the calculation. In this case the value is part of the
109       file comment header as well as  the  number  of  DDL  (digital  driving
110       level)  values,  the  absolute luminance range (measured in candela per
111       square  meter)  and  the  range  of  the  JND  index  (just  noticeable
112       difference) in case of GSDF. Alternatively, the ambient light value can
113       be specified as a command line option. When setting the  two  luminance
114       values  instead  of  reading a monitor characteristic file as input the
115       luminance range is linearly divided by the number of DDLs.
116
117       For printers and scanners the illumination can be specified in addition
118       to the reflected ambient light (both in the characteristics file and on
119       the command line). The header of the output file includes  the  minimum
120       and maximum Optical Density (OD) instead of the luminance range. Please
121       note that the OD values in  the  input  file  have  to  be  ordered  in
122       descending order (in contrast to the luminance values used for monitors
123       and cameras). The DDL value 0 always means black  (darkest  value)  and
124       the maximum DDL value means white (brightest value, clear film).
125
126       The  data  folder  contains  sample  characteristics file for monitors,
127       cameras, printers and scanners. See DICOM standard  part  14  for  more
128       details on display calibration and Barten's model (including GSDF).
129

LOGGING

131       The  level  of  logging  output  of  the various command line tools and
132       underlying libraries can be specified by the  user.  By  default,  only
133       errors  and  warnings  are  written to the standard error stream. Using
134       option --verbose also informational messages  like  processing  details
135       are  reported.  Option  --debug  can be used to get more details on the
136       internal activity, e.g. for debugging purposes.  Other  logging  levels
137       can  be  selected  using option --log-level. In --quiet mode only fatal
138       errors are reported. In such very severe error events, the  application
139       will  usually  terminate.  For  more  details  on the different logging
140       levels, see documentation of module 'oflog'.
141
142       In case the logging output should be written to file  (optionally  with
143       logfile  rotation),  to syslog (Unix) or the event log (Windows) option
144       --log-config can be used.  This  configuration  file  also  allows  for
145       directing  only  certain messages to a particular output stream and for
146       filtering certain messages based on the  module  or  application  where
147       they  are  generated.  An  example  configuration  file  is provided in
148       <etcdir>/logger.cfg.
149

COMMAND LINE

151       All command line tools  use  the  following  notation  for  parameters:
152       square  brackets  enclose  optional  values  (0-1), three trailing dots
153       indicate that multiple values are allowed (1-n), a combination of  both
154       means 0 to n values.
155
156       Command line options are distinguished from parameters by a leading '+'
157       or '-' sign, respectively. Usually, order and position of command  line
158       options  are  arbitrary  (i.e.  they  can appear anywhere). However, if
159       options are mutually exclusive the rightmost appearance is  used.  This
160       behavior  conforms  to  the  standard  evaluation  rules of common Unix
161       shells.
162
163       In addition, one or more command files can be specified  using  an  '@'
164       sign  as  a  prefix to the filename (e.g. @command.txt). Such a command
165       argument is replaced by the content  of  the  corresponding  text  file
166       (multiple  whitespaces  are  treated  as a single separator unless they
167       appear between two quotation marks) prior to  any  further  evaluation.
168       Please  note  that  a command file cannot contain another command file.
169       This simple but effective  approach  allows  one  to  summarize  common
170       combinations  of  options/parameters  and  avoids longish and confusing
171       command lines (an example is provided in file <datadir>/dumppat.txt).
172

FILES

174       <datadir>/camera.lut - sample characteristics file of a camera
175       <datadir>/monitor.lut - sample characteristics file of a monitor
176       <datadir>/printer.lut - sample characteristics file of a printer
177       <datadir>/scanner.lut - sample characteristics file of a scanner
178

SEE ALSO

180       dconvlum(1), dcod2lum(1)
181
183       Copyright (C) 1999-2014 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
184       Germany.
185
186
187
188Version 3.6.6                   Thu Jan 14 2021                    dcmdspfn(1)
Impressum