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 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348
|
/*
*
* Copyright (C) 2016-2022, OFFIS e.V.
* All rights reserved. See COPYRIGHT file for details.
*
* This software and supporting documentation were developed by
*
* OFFIS e.V.
* R&D Division Health
* Escherweg 2
* D-26121 Oldenburg, Germany
*
*
* Module: dcmdata
*
* Author: Sebastian Grallert
*
* Purpose: Convert the contents of a DICOM file to JSON format
*
*/
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/dcmdata/dctk.h"
#include "dcmtk/dcmdata/cmdlnarg.h"
#include "dcmtk/dcmdata/dcjson.h"
#include "dcmtk/ofstd/ofstream.h"
#include "dcmtk/ofstd/ofconapp.h"
#include "dcmtk/ofstd/ofexit.h"
#ifdef WITH_ZLIB
#include <zlib.h> /* for zlibVersion() */
#endif
#ifdef DCMTK_ENABLE_CHARSET_CONVERSION
#include "dcmtk/ofstd/ofchrenc.h" /* for OFCharacterEncoding */
#endif
#define OFFIS_CONSOLE_APPLICATION "dcm2json"
#define OFFIS_CONSOLE_DESCRIPTION "Convert DICOM file and data set to JSON"
#define EXITCODE_CANNOT_CONVERT_TO_UNICODE 80
#define EXITCODE_CANNOT_WRITE_VALID_JSON 81
static OFLogger dcm2jsonLogger = OFLog::getLogger("dcmtk.apps." OFFIS_CONSOLE_APPLICATION);
static char rcsid[] = "$dcmtk: " OFFIS_CONSOLE_APPLICATION " v"
OFFIS_DCMTK_VERSION " " OFFIS_DCMTK_RELEASEDATE " $";
// ********************************************
/* Function to call all writeJson() functions in DCMTK */
static OFCondition writeFile(STD_NAMESPACE ostream &out,
const char *ifname,
DcmFileFormat *dfile,
const E_FileReadMode readMode,
const OFBool format,
const OFBool printMetaInfo,
const OFBool encode_extended,
const DcmJsonFormat::NumStringPolicy opt_ns_policy)
{
OFCondition result = EC_IllegalParameter;
if ((ifname != NULL) && (dfile != NULL))
{
/* write JSON document content */
DcmDataset *dset = dfile->getDataset();
if (format)
{
DcmJsonFormatPretty fmt(printMetaInfo);
fmt.setJsonExtensionEnabled(encode_extended);
fmt.setJsonNumStringPolicy(opt_ns_policy);
if (readMode == ERM_dataset)
result = dset->writeJsonExt(out, fmt, OFTrue, OFTrue);
else result = dfile->writeJson(out, fmt);
}
else
{
DcmJsonFormatCompact fmt(printMetaInfo);
fmt.setJsonExtensionEnabled(encode_extended);
fmt.setJsonNumStringPolicy(opt_ns_policy);
if (readMode == ERM_dataset)
result = dset->writeJsonExt(out, fmt, OFTrue, OFTrue);
else result = dfile->writeJson(out, fmt);
}
}
return result;
}
#define SHORTCOL 3
#define LONGCOL 20
int main(int argc, char *argv[])
{
OFBool opt_format = OFTrue;
OFBool opt_addMetaInformation = OFFalse;
OFBool opt_encode_extended = OFFalse;
DcmJsonFormat::NumStringPolicy opt_ns_policy = DcmJsonFormat::NSP_auto;
E_FileReadMode opt_readMode = ERM_autoDetect;
E_TransferSyntax opt_ixfer = EXS_Unknown;
OFString optStr;
OFConsoleApplication app(OFFIS_CONSOLE_APPLICATION, OFFIS_CONSOLE_DESCRIPTION, rcsid);
OFCommandLine cmd;
cmd.setOptionColumns(LONGCOL, SHORTCOL);
cmd.setParamColumn(LONGCOL + SHORTCOL + 4);
cmd.addParam("dcmfile-in", "DICOM input filename to be converted\n(\"-\" for stdin)", OFCmdParam::PM_Mandatory);
cmd.addParam("jsonfile-out", "JSON output filename (default: stdout)", OFCmdParam::PM_Optional);
cmd.addGroup("general options:", LONGCOL, SHORTCOL + 2);
cmd.addOption("--help", "-h", "print this help text and exit", OFCommandLine::AF_Exclusive);
cmd.addOption("--version", "print version information and exit", OFCommandLine::AF_Exclusive);
OFLog::addOptions(cmd);
cmd.addGroup("input options:");
cmd.addSubGroup("input file format:");
cmd.addOption("--read-file", "+f", "read file format or data set (default)");
cmd.addOption("--read-file-only", "+fo", "read file format only");
cmd.addOption("--read-dataset", "-f", "read data set without file meta information");
cmd.addSubGroup("input transfer syntax:");
cmd.addOption("--read-xfer-auto", "-t=", "use TS recognition (default)");
cmd.addOption("--read-xfer-detect", "-td", "ignore TS specified in the file meta header");
cmd.addOption("--read-xfer-little", "-te", "read with explicit VR little endian TS");
cmd.addOption("--read-xfer-big", "-tb", "read with explicit VR big endian TS");
cmd.addOption("--read-xfer-implicit", "-ti", "read with implicit VR little endian TS");
cmd.addGroup("processing options:");
cmd.addSubGroup("encoding of infinity and not-a-number:");
cmd.addOption("--encode-strict", "-es", "report error for 'inf' and 'nan' (default)");
cmd.addOption("--encode-extended", "-ee", "permit 'inf' and 'nan' in JSON numbers");
cmd.addSubGroup("encoding of IS and DS (integer/decimal string) elements:");
cmd.addOption("--is-ds-auto", "-ia", "encode as number if valid, as string\notherwise (default)");
cmd.addOption("--is-ds-num", "-in", "always encode as number, fail if invalid");
cmd.addOption("--is-ds-string", "-is", "always encode as string");
cmd.addGroup("output options:");
cmd.addSubGroup("output format:");
cmd.addOption("--formatted-code", "+fc", "enable whitespace formatting (default)");
cmd.addOption("--compact-code", "-fc", "print only required characters");
cmd.addOption("--write-meta", "+m", "write data set with meta information\n(warning: not conforming to the DICOM standard)");
/* evaluate command line */
prepareCmdLineArgs(argc, argv, OFFIS_CONSOLE_APPLICATION);
if (app.parseCommandLine(cmd, argc, argv))
{
/* check exclusive options first */
if (cmd.hasExclusiveOption())
{
if (cmd.findOption("--version"))
{
app.printHeader(OFTrue /*print host identifier*/);
COUT << OFendl << "External libraries used:";
#if !defined(WITH_ZLIB) && !defined(DCMTK_ENABLE_CHARSET_CONVERSION)
COUT << " none" << OFendl;
#else
COUT << OFendl;
#endif
#ifdef WITH_ZLIB
COUT << "- ZLIB, Version " << zlibVersion() << OFendl;
#endif
#ifdef DCMTK_ENABLE_CHARSET_CONVERSION
COUT << "- " << OFCharacterEncoding::getLibraryVersionString() << OFendl;
#endif
return 0;
}
}
/* general options */
OFLog::configureFromCommandLine(cmd, app);
/* input options */
cmd.beginOptionBlock();
if (cmd.findOption("--read-file")) opt_readMode = ERM_autoDetect;
if (cmd.findOption("--read-file-only")) opt_readMode = ERM_fileOnly;
if (cmd.findOption("--read-dataset")) opt_readMode = ERM_dataset;
cmd.endOptionBlock();
cmd.beginOptionBlock();
if (cmd.findOption("--read-xfer-auto"))
opt_ixfer = EXS_Unknown;
if (cmd.findOption("--read-xfer-detect"))
dcmAutoDetectDatasetXfer.set(OFTrue);
if (cmd.findOption("--read-xfer-little"))
{
app.checkDependence("--read-xfer-little", "--read-dataset", opt_readMode == ERM_dataset);
opt_ixfer = EXS_LittleEndianExplicit;
}
if (cmd.findOption("--read-xfer-big"))
{
app.checkDependence("--read-xfer-big", "--read-dataset", opt_readMode == ERM_dataset);
opt_ixfer = EXS_BigEndianExplicit;
}
if (cmd.findOption("--read-xfer-implicit"))
{
app.checkDependence("--read-xfer-implicit", "--read-dataset", opt_readMode == ERM_dataset);
opt_ixfer = EXS_LittleEndianImplicit;
}
cmd.endOptionBlock();
/* number encoding options */
cmd.beginOptionBlock();
if (cmd.findOption("--encode-strict"))
opt_encode_extended = OFFalse;
if (cmd.findOption("--encode-extended"))
opt_encode_extended = OFTrue;
cmd.endOptionBlock();
cmd.beginOptionBlock();
if (cmd.findOption("--is-ds-auto"))
opt_ns_policy = DcmJsonFormat::NSP_auto;
if (cmd.findOption("--is-ds-num"))
opt_ns_policy = DcmJsonFormat::NSP_always_number;
if (cmd.findOption("--is-ds-string"))
opt_ns_policy = DcmJsonFormat::NSP_always_string;
cmd.endOptionBlock();
/* format options */
cmd.beginOptionBlock();
if (cmd.findOption("--formatted-code"))
opt_format = OFTrue;
if (cmd.findOption("--compact-code"))
opt_format = OFFalse;
cmd.endOptionBlock();
/* meta option */
if (cmd.findOption("--write-meta"))
{
app.checkConflict("--write-meta", "--read-dataset", opt_readMode == ERM_dataset);
opt_addMetaInformation = OFTrue;
}
}
/* print resource identifier */
OFLOG_DEBUG(dcm2jsonLogger, rcsid << OFendl);
/* make sure data dictionary is loaded */
if (!dcmDataDict.isDictionaryLoaded())
{
OFLOG_WARN(dcm2jsonLogger, "no data dictionary loaded, check environment variable: "
<< DCM_DICT_ENVIRONMENT_VARIABLE);
}
int result = 0;
/* first parameter is treated as the input filename */
const char *ifname = NULL;
cmd.getParam(1, ifname);
/* check input file */
if ((ifname != NULL) && (strlen(ifname) > 0))
{
/* read DICOM file or data set */
DcmFileFormat dfile;
OFCondition status = dfile.loadFile(ifname, opt_ixfer, EGL_noChange, DCM_MaxReadLength, opt_readMode);
if (status.good())
{
DcmDataset *dset = dfile.getDataset();
OFString csetString;
if (dset->findAndGetOFStringArray(DCM_SpecificCharacterSet, csetString).good())
{
if (csetString.compare("ISO_IR 6") == 0)
{
/* SpecificCharacterSet indicates ASCII without extended characters.
* If this is true, no conversion is necessary. Check for extended characters.
*/
if (dset->containsExtendedCharacters(OFFalse /*checkAllStrings*/))
{
OFLOG_FATAL(dcm2jsonLogger, "dataset contains extended characters but SpecificCharacterSet (0008,0005) is 'ISO_IR 6'");
result = EXITCODE_CANNOT_CONVERT_TO_UNICODE;
}
}
else if (csetString.compare("ISO_IR 192") == 0)
{
/* DICOM dataset is already in UTF-8, no conversion necessary */
}
else
{
/* we have a character set other than ASCII or UTF-8. Perform conversion. */
#ifdef DCMTK_ENABLE_CHARSET_CONVERSION
/* convert all DICOM strings to UTF-8 */
OFLOG_INFO(dcm2jsonLogger, "converting all element values that are affected by SpecificCharacterSet (0008,0005) to UTF-8");
status = dset->convertToUTF8();
if (status.bad())
{
OFLOG_FATAL(dcm2jsonLogger, status.text() << ": converting file to UTF-8: " << ifname);
result = EXITCODE_CANNOT_CONVERT_TO_UNICODE;
}
#else
OFLOG_FATAL(dcm2jsonLogger, "character set conversion not available");
result = EXITCODE_CANNOT_CONVERT_TO_UNICODE;
#endif
}
}
else
{
/* SpecificCharacterSet not present */
if (dset->containsExtendedCharacters(OFFalse /*checkAllStrings*/))
{
OFLOG_FATAL(dcm2jsonLogger, "dataset contains extended characters but no SpecificCharacterSet (0008,0005)");
result = EXITCODE_CANNOT_CONVERT_TO_UNICODE;
}
}
if (result == 0)
{
/* if second parameter is present, it is treated as the output filename ("stdout" otherwise) */
if (cmd.getParamCount() == 2)
{
const char *ofname = NULL;
cmd.getParam(2, ofname);
STD_NAMESPACE ofstream stream(ofname);
if (stream.good())
{
/* write content in JSON format to file */
status = writeFile(stream, ifname, &dfile, opt_readMode, opt_format, opt_addMetaInformation, opt_encode_extended, opt_ns_policy);
if (status.bad())
{
OFLOG_FATAL(dcm2jsonLogger, status.text() << ": " << ifname);
result = EXITCODE_CANNOT_WRITE_VALID_JSON;
}
}
else
result = EXITCODE_CANNOT_WRITE_OUTPUT_FILE;
}
else
{
/* write content in JSON format to standard output */
status = writeFile(COUT, ifname, &dfile, opt_readMode, opt_format, opt_addMetaInformation, opt_encode_extended, opt_ns_policy);
if (status.bad())
{
OFLOG_FATAL(dcm2jsonLogger, status.text() << ": " << ifname);
result = EXITCODE_CANNOT_WRITE_VALID_JSON;
}
}
}
}
else
{
OFLOG_ERROR(dcm2jsonLogger, OFFIS_CONSOLE_APPLICATION << ": error (" << status.text() << ") reading file: " << ifname);
return EXITCODE_CANNOT_READ_INPUT_FILE;
}
}
else
{
OFLOG_ERROR(dcm2jsonLogger, OFFIS_CONSOLE_APPLICATION << ": invalid filename: <empty string>");
return EXITCODE_NO_INPUT_FILES;
}
return result;
}
|