Mercurial > hg > orthanc
view OrthancServer/FromDcmtkBridge.cpp @ 276:8af8754a7a8e
rest api demo
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Sun, 09 Dec 2012 14:45:10 +0100 |
parents | 81f11fb357f2 |
children | 4031f73fe0e4 |
line wrap: on
line source
/** * Orthanc - A Lightweight, RESTful DICOM Store * Copyright (C) 2012 Medical Physics Department, CHU of Liege, * Belgium * * This program is free software: you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * In addition, as a special exception, the copyright holders of this * program give permission to link the code of its release with the * OpenSSL project's "OpenSSL" library (or with modified versions of it * that use the same license as the "OpenSSL" library), and distribute * the linked executables. You must obey the GNU General Public License * in all respects for all of the code used other than "OpenSSL". If you * modify file(s) with this exception, you may extend this exception to * your version of the file(s), but you are not obligated to do so. If * you do not wish to do so, delete this exception statement from your * version. If you delete this exception statement from all source files * in the program, then also delete it here. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. **/ #ifndef NOMINMAX #define NOMINMAX #endif #include "FromDcmtkBridge.h" #include "ToDcmtkBridge.h" #include "../Core/Toolbox.h" #include "../Core/OrthancException.h" #include "../Core/PngWriter.h" #include "../Core/DicomFormat/DicomString.h" #include "../Core/DicomFormat/DicomNullValue.h" #include "../Core/DicomFormat/DicomIntegerPixelAccessor.h" #include <limits> #include <boost/lexical_cast.hpp> #include <dcmtk/dcmdata/dcdicent.h> #include <dcmtk/dcmdata/dcdict.h> #include <dcmtk/dcmdata/dcfilefo.h> #include <dcmtk/dcmdata/dcistrmb.h> #include <dcmtk/dcmdata/dcvrfd.h> #include <dcmtk/dcmdata/dcvrfl.h> #include <dcmtk/dcmdata/dcvrsl.h> #include <dcmtk/dcmdata/dcvrss.h> #include <dcmtk/dcmdata/dcvrul.h> #include <dcmtk/dcmdata/dcvrus.h> #include <dcmtk/dcmdata/dcuid.h> #include <boost/math/special_functions/round.hpp> namespace Orthanc { void FromDcmtkBridge::Convert(DicomMap& target, DcmDataset& dataset) { target.Clear(); for (unsigned long i = 0; i < dataset.card(); i++) { DcmElement* element = dataset.getElement(i); if (element && element->isLeaf()) { target.SetValue(element->getTag().getGTag(), element->getTag().getETag(), ConvertLeafElement(*element)); } } } DicomTag FromDcmtkBridge::GetTag(const DcmElement& element) { return DicomTag(element.getGTag(), element.getETag()); } DicomValue* FromDcmtkBridge::ConvertLeafElement(DcmElement& element) { if (!element.isLeaf()) { throw OrthancException("Only applicable to leaf elements"); } if (element.isaString()) { char *c; if (element.getString(c).good() && c != NULL) { std::string s(c); std::string utf8 = Toolbox::ConvertToUtf8(s, "ISO-8859-1"); // TODO Parameter? return new DicomString(utf8); } else { return new DicomNullValue; } } try { // http://support.dcmtk.org/docs/dcvr_8h-source.html switch (element.getVR()) { /** * TODO. **/ case EVR_DS: // decimal string case EVR_IS: // integer string case EVR_OB: // other byte case EVR_OF: // other float case EVR_OW: // other word case EVR_AS: // age string case EVR_AT: // attribute tag case EVR_DA: // date string case EVR_DT: // date time string case EVR_TM: // time string case EVR_UN: // unknown value representation return new DicomNullValue(); /** * String types, should never happen at this point because of * "element.isaString()". **/ case EVR_AE: // application entity title case EVR_CS: // code string case EVR_SH: // short string case EVR_LO: // long string case EVR_ST: // short text case EVR_LT: // long text case EVR_UT: // unlimited text case EVR_PN: // person name case EVR_UI: // unique identifier return new DicomNullValue(); /** * Numerical types **/ case EVR_SL: // signed long { Sint32 f; if (dynamic_cast<DcmSignedLong&>(element).getSint32(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } case EVR_SS: // signed short { Sint16 f; if (dynamic_cast<DcmSignedShort&>(element).getSint16(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } case EVR_UL: // unsigned long { Uint32 f; if (dynamic_cast<DcmUnsignedLong&>(element).getUint32(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } case EVR_US: // unsigned short { Uint16 f; if (dynamic_cast<DcmUnsignedShort&>(element).getUint16(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } case EVR_FL: // float single-precision { Float32 f; if (dynamic_cast<DcmFloatingPointSingle&>(element).getFloat32(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } case EVR_FD: // float double-precision { Float64 f; if (dynamic_cast<DcmFloatingPointDouble&>(element).getFloat64(f).good()) { return new DicomString(boost::lexical_cast<std::string>(f)); } else { return new DicomNullValue(); } } /** * Sequence types, should never occur at this point because of * "element.isLeaf()". **/ case EVR_SQ: // sequence of items return new DicomNullValue; /** * Internal to DCMTK. **/ case EVR_ox: // OB or OW depending on context case EVR_xs: // SS or US depending on context case EVR_lt: // US, SS or OW depending on context, used for LUT Data (thus the name) case EVR_na: // na="not applicable", for data which has no VR case EVR_up: // up="unsigned pointer", used internally for DICOMDIR suppor case EVR_item: // used internally for items case EVR_metainfo: // used internally for meta info datasets case EVR_dataset: // used internally for datasets case EVR_fileFormat: // used internally for DICOM files case EVR_dicomDir: // used internally for DICOMDIR objects case EVR_dirRecord: // used internally for DICOMDIR records case EVR_pixelSQ: // used internally for pixel sequences in a compressed image case EVR_pixelItem: // used internally for pixel items in a compressed image case EVR_UNKNOWN: // used internally for elements with unknown VR (encoded with 4-byte length field in explicit VR) case EVR_PixelData: // used internally for uncompressed pixeld data case EVR_OverlayData: // used internally for overlay data case EVR_UNKNOWN2B: // used internally for elements with unknown VR with 2-byte length field in explicit VR return new DicomNullValue; /** * Default case. **/ default: return new DicomNullValue; } } catch (boost::bad_lexical_cast) { return new DicomNullValue; } } static void StoreElement(Json::Value& target, DcmElement& element, unsigned int maxStringLength); static void StoreItem(Json::Value& target, DcmItem& item, unsigned int maxStringLength) { target = Json::Value(Json::objectValue); for (unsigned long i = 0; i < item.card(); i++) { DcmElement* element = item.getElement(i); StoreElement(target, *element, maxStringLength); } } static void StoreElement(Json::Value& target, DcmElement& element, unsigned int maxStringLength) { assert(target.type() == Json::objectValue); DicomTag tag(FromDcmtkBridge::GetTag(element)); const std::string tagName = FromDcmtkBridge::GetName(tag); const std::string formattedTag = tag.Format(); if (element.isLeaf()) { Json::Value value(Json::objectValue); value["Name"] = tagName; std::auto_ptr<DicomValue> v(FromDcmtkBridge::ConvertLeafElement(element)); if (v->IsNull()) { value["Type"] = "Null"; value["Value"] = Json::nullValue; } else { std::string s = v->AsString(); if (maxStringLength == 0 || s.size() <= maxStringLength) { value["Type"] = "String"; value["Value"] = s; } else { value["Type"] = "TooLong"; value["Value"] = Json::nullValue; } } target[formattedTag] = value; } else { Json::Value children(Json::arrayValue); // "All subclasses of DcmElement except for DcmSequenceOfItems // are leaf nodes, while DcmSequenceOfItems, DcmItem, DcmDataset // etc. are not." The following cast is thus OK. DcmSequenceOfItems& sequence = dynamic_cast<DcmSequenceOfItems&>(element); for (unsigned long i = 0; i < sequence.card(); i++) { DcmItem* child = sequence.getItem(i); Json::Value& v = children.append(Json::objectValue); StoreItem(v, *child, maxStringLength); } target[formattedTag]["Name"] = tagName; target[formattedTag]["Type"] = "Sequence"; target[formattedTag]["Value"] = children; } } void FromDcmtkBridge::ToJson(Json::Value& root, DcmDataset& dataset, unsigned int maxStringLength) { StoreItem(root, dataset, maxStringLength); } void FromDcmtkBridge::ToJson(Json::Value& target, const std::string& path, unsigned int maxStringLength) { DcmFileFormat dicom; if (!dicom.loadFile(path.c_str()).good()) { throw OrthancException(ErrorCode_BadFileFormat); } else { FromDcmtkBridge::ToJson(target, *dicom.getDataset(), maxStringLength); } } static void ExtractPngImagePreview(std::string& result, DicomIntegerPixelAccessor& accessor) { PngWriter w; int32_t min, max; accessor.GetExtremeValues(min, max); std::vector<uint8_t> image(accessor.GetWidth() * accessor.GetHeight(), 0); if (min != max) { uint8_t* pixel = &image[0]; for (unsigned int y = 0; y < accessor.GetHeight(); y++) { for (unsigned int x = 0; x < accessor.GetWidth(); x++, pixel++) { int32_t v = accessor.GetValue(x, y); *pixel = static_cast<uint8_t>( boost::math::lround(static_cast<float>(v - min) / static_cast<float>(max - min) * 255.0f)); } } } w.WriteToMemory(result, accessor.GetWidth(), accessor.GetHeight(), accessor.GetWidth(), PixelFormat_Grayscale8, &image[0]); } template <typename T> static void ExtractPngImageTruncate(std::string& result, DicomIntegerPixelAccessor& accessor, PixelFormat format) { PngWriter w; std::vector<T> image(accessor.GetWidth() * accessor.GetHeight(), 0); T* pixel = &image[0]; for (unsigned int y = 0; y < accessor.GetHeight(); y++) { for (unsigned int x = 0; x < accessor.GetWidth(); x++, pixel++) { int32_t v = accessor.GetValue(x, y); if (v < std::numeric_limits<T>::min()) *pixel = std::numeric_limits<T>::min(); else if (v > std::numeric_limits<T>::max()) *pixel = std::numeric_limits<T>::max(); else *pixel = static_cast<T>(v); } } w.WriteToMemory(result, accessor.GetWidth(), accessor.GetHeight(), accessor.GetWidth() * sizeof(T), format, &image[0]); } void FromDcmtkBridge::ExtractPngImage(std::string& result, DcmDataset& dataset, unsigned int frame, ImageExtractionMode mode) { // See also: http://support.dcmtk.org/wiki/dcmtk/howto/accessing-compressed-data std::auto_ptr<DicomIntegerPixelAccessor> accessor; DicomMap m; FromDcmtkBridge::Convert(m, dataset); DcmElement* e; if (dataset.findAndGetElement(ToDcmtkBridge::Convert(DICOM_TAG_PIXEL_DATA), e).good() && e != NULL) { Uint8* pixData = NULL; if (e->getUint8Array(pixData) == EC_Normal) { accessor.reset(new DicomIntegerPixelAccessor(m, pixData, e->getLength())); accessor->SetCurrentFrame(frame); } } PixelFormat format; switch (mode) { case ImageExtractionMode_Preview: case ImageExtractionMode_UInt8: format = PixelFormat_Grayscale8; break; case ImageExtractionMode_UInt16: format = PixelFormat_Grayscale16; break; default: throw OrthancException(ErrorCode_NotImplemented); } if (accessor.get() == NULL || accessor->GetWidth() == 0 || accessor->GetHeight() == 0) { PngWriter w; w.WriteToMemory(result, 0, 0, 0, format, NULL); } else { switch (mode) { case ImageExtractionMode_Preview: ExtractPngImagePreview(result, *accessor); break; case ImageExtractionMode_UInt8: ExtractPngImageTruncate<uint8_t>(result, *accessor, format); break; case ImageExtractionMode_UInt16: ExtractPngImageTruncate<uint16_t>(result, *accessor, format); break; default: throw OrthancException(ErrorCode_NotImplemented); } } } void FromDcmtkBridge::ExtractPngImage(std::string& result, const std::string& dicomContent, unsigned int frame, ImageExtractionMode mode) { DcmInputBufferStream is; if (dicomContent.size() > 0) { is.setBuffer(&dicomContent[0], dicomContent.size()); } is.setEos(); DcmFileFormat dicom; if (dicom.read(is).good()) { ExtractPngImage(result, *dicom.getDataset(), frame, mode); } else { throw OrthancException(ErrorCode_BadFileFormat); } } std::string FromDcmtkBridge::GetName(const DicomTag& t) { // Some patches for important tags because of different DICOM // dictionaries between DCMTK versions if (t == DICOM_TAG_PATIENT_NAME) return "PatientName"; if (t == DicomTag(0x0010, 0x0030)) return "PatientBirthDate"; if (t == DicomTag(0x0010, 0x0040)) return "PatientSex"; // End of patches DcmTagKey tag(t.GetGroup(), t.GetElement()); const DcmDataDictionary& dict = dcmDataDict.rdlock(); const DcmDictEntry* entry = dict.findEntry(tag, NULL); std::string s("Unknown"); if (entry != NULL) { s = std::string(entry->getTagName()); } dcmDataDict.unlock(); return s; } DicomTag FromDcmtkBridge::FindTag(const char* name) { const DcmDataDictionary& dict = dcmDataDict.rdlock(); const DcmDictEntry* entry = dict.findEntry(name); if (entry == NULL) { dcmDataDict.unlock(); throw OrthancException("Unknown DICOM tag"); } else { DcmTagKey key = entry->getKey(); DicomTag tag(key.getGroup(), key.getElement()); dcmDataDict.unlock(); return tag; } } void FromDcmtkBridge::Print(FILE* fp, const DicomMap& m) { for (DicomMap::Map::const_iterator it = m.map_.begin(); it != m.map_.end(); it++) { DicomTag t = it->first; std::string s = it->second->AsString(); printf("0x%04x 0x%04x (%s) [%s]\n", t.GetGroup(), t.GetElement(), GetName(t).c_str(), s.c_str()); } } void FromDcmtkBridge::ToJson(Json::Value& result, const DicomMap& values) { if (result.type() != Json::objectValue) { throw OrthancException(ErrorCode_BadParameterType); } result.clear(); for (DicomMap::Map::const_iterator it = values.map_.begin(); it != values.map_.end(); it++) { result[GetName(it->first)] = it->second->AsString(); } } std::string FromDcmtkBridge::GenerateUniqueIdentifier(DicomRootLevel level) { char uid[100]; switch (level) { case DicomRootLevel_Instance: return dcmGenerateUniqueIdentifier(uid, SITE_INSTANCE_UID_ROOT); case DicomRootLevel_Series: return dcmGenerateUniqueIdentifier(uid, SITE_SERIES_UID_ROOT); case DicomRootLevel_Study: return dcmGenerateUniqueIdentifier(uid, SITE_STUDY_UID_ROOT); default: throw OrthancException(ErrorCode_ParameterOutOfRange); } } }