Mercurial > hg > orthanc
view OrthancFramework/Sources/DicomParsing/DicomPixelMasker.cpp @ 6040:100a0371fc85 pixel-anon
pixel anon: 3D regions
author | Alain Mazy <am@orthanc.team> |
---|---|
date | Thu, 13 Mar 2025 10:09:50 +0100 |
parents | 4742b4fe824b |
children | 7902d830c9a5 |
line wrap: on
line source
/** * Orthanc - A Lightweight, RESTful DICOM Store * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics * Department, University Hospital of Liege, Belgium * Copyright (C) 2017-2023 Osimis S.A., Belgium * Copyright (C) 2024-2025 Orthanc Team SRL, Belgium * Copyright (C) 2021-2025 Sebastien Jodogne, ICTEAM UCLouvain, Belgium * * This program is free software: you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public License * as published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. * * 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this program. If not, see * <http://www.gnu.org/licenses/>. **/ #include "../PrecompiledHeaders.h" #include "DicomPixelMasker.h" #include "../OrthancException.h" #include "../SerializationToolbox.h" #include "../Logging.h" namespace Orthanc { static const char* KEY_MASK_PIXELS = "MaskPixelData"; static const char* KEY_MASK_TYPE = "MaskType"; static const char* KEY_MASK_TYPE_FILL = "Fill"; static const char* KEY_MASK_TYPE_MEAN_FILTER = "MeanFilter"; static const char* KEY_FILTER_WIDTH = "FilterWidth"; static const char* KEY_FILL_VALUE = "FillValue"; static const char* KEY_REGIONS = "Regions"; static const char* KEY_REGION_TYPE = "RegionType"; static const char* KEY_REGION_2D = "2D"; static const char* KEY_REGION_3D = "3D"; static const char* KEY_ORIGIN = "Origin"; static const char* KEY_END = "End"; static const char* KEY_TARGET_SERIES = "TargetSeries"; static const char* KEY_TARGET_INSTANCES = "TargetInstances"; DicomPixelMasker::DicomPixelMasker() { } DicomPixelMasker::~DicomPixelMasker() { for (std::list<BaseRegion*>::iterator it = regions_.begin(); it != regions_.end(); ++it) { delete *it; } } DicomPixelMasker::BaseRegion::BaseRegion() : mode_(DicomPixelMaskerMode_Undefined), fillValue_(0), filterWidth_(0) { } DicomPixelMasker::Region2D::Region2D(unsigned int x1, unsigned int y1, unsigned int x2, unsigned int y2) : x1_(x1), y1_(y1), x2_(x2), y2_(y2) { } DicomPixelMasker::Region3D::Region3D(double x1, double y1, double z1, double x2, double y2, double z2) : x1_(x1), y1_(y1), z1_(z1), x2_(x2), y2_(y2), z2_(z2) { } bool DicomPixelMasker::BaseRegion::IsTargeted(const ParsedDicomFile& file) const { DicomInstanceHasher hasher = file.GetHasher(); const std::string& seriesId = hasher.HashSeries(); const std::string& instanceId = hasher.HashInstance(); if (targetSeries_.size() > 0 && targetSeries_.find(seriesId) == targetSeries_.end()) { return false; } if (targetInstances_.size() > 0 && targetInstances_.find(instanceId) == targetInstances_.end()) { return false; } return true; } bool DicomPixelMasker::Region2D::GetPixelMaskArea(unsigned int& x1, unsigned int& y1, unsigned int& x2, unsigned int& y2, const ParsedDicomFile& file, unsigned int frameIndex) const { if (IsTargeted(file)) { x1 = x1_; y1 = y1_; x2 = x2_; y2 = y2_; return true; } return false; } static void GetDoubleVector(std::vector<double>& target, const ParsedDicomFile& file, const DicomTag& tag, size_t expectedSize) { target.clear(); std::string str; if (!file.GetTagValue(str, tag)) { throw OrthancException(ErrorCode_InexistentTag, "Unable to perform 3D -> 2D conversion, missing tag" + tag.Format()); } std::vector<std::string> strVector; Toolbox::SplitString(strVector, str, '\\'); if (strVector.size() != expectedSize) { throw OrthancException(ErrorCode_InexistentTag, "Unable to perform 3D -> 2D conversion, tag " + tag.Format() + " length is invalid"); } for (size_t i = 0; i < strVector.size(); ++i) { try { target.push_back(boost::lexical_cast<double>(strVector[i])); } catch (boost::bad_lexical_cast&) { throw OrthancException(ErrorCode_InexistentTag, "Unable to perform 3D -> 2D conversion, tag " + tag.Format() + " contains invalid value " + strVector[i]); } } } bool DicomPixelMasker::Region3D::GetPixelMaskArea(unsigned int& x1, unsigned int& y1, unsigned int& x2, unsigned int& y2, const ParsedDicomFile& file, unsigned int frameIndex) const { if (IsTargeted(file)) { std::vector<double> imagePositionPatient; std::vector<double> imageOrientationPatient; std::vector<double> pixelSpacing; GetDoubleVector(imagePositionPatient, file, DICOM_TAG_IMAGE_POSITION_PATIENT, 3); GetDoubleVector(imageOrientationPatient, file, DICOM_TAG_IMAGE_ORIENTATION_PATIENT, 6); GetDoubleVector(pixelSpacing, file, DICOM_TAG_PIXEL_SPACING, 2); // note: To simplify, for the z, we only check that imagePositionPatient is between the authorized z values. // This won't be perfectly true for weird images with slices that are not parallel but let's wait for someone to complain ... if (imagePositionPatient[2] < std::min(z1_, z2_) || imagePositionPatient[2] > std::max(z1_, z2_)) { return false; } double deltaX1 = x1_ - imagePositionPatient[0]; double deltaY1 = y1_ - imagePositionPatient[1]; double deltaZ1 = z1_ - imagePositionPatient[2]; double deltaX2 = x2_ - imagePositionPatient[0]; double deltaY2 = y2_ - imagePositionPatient[1]; double deltaZ2 = z2_ - imagePositionPatient[2]; double ix1 = (deltaX1 * imageOrientationPatient[0] + deltaY1 * imageOrientationPatient[1] + deltaZ1 * imageOrientationPatient[2]) / pixelSpacing[0]; double iy1 = (deltaX1 * imageOrientationPatient[3] + deltaY1 * imageOrientationPatient[4] + deltaZ1 * imageOrientationPatient[5]) / pixelSpacing[1]; double ix2 = (deltaX2 * imageOrientationPatient[0] + deltaY2 * imageOrientationPatient[1] + deltaZ2 * imageOrientationPatient[2]) / pixelSpacing[0]; double iy2 = (deltaX2 * imageOrientationPatient[3] + deltaY2 * imageOrientationPatient[4] + deltaZ2 * imageOrientationPatient[5]) / pixelSpacing[1]; std::string strRows; std::string strColumns; if (!file.GetTagValue(strRows, DICOM_TAG_ROWS) || !file.GetTagValue(strColumns, DICOM_TAG_COLUMNS)) { throw OrthancException(ErrorCode_InexistentTag, "Unable to perform 3D -> 2D conversion, missing ROWS or COLUMNS tag"); } // clip on image size double rows = boost::lexical_cast<double>(strRows); double columns = boost::lexical_cast<double>(strColumns); x1 = static_cast<unsigned int>(std::max(0.0, std::min(ix1, ix2))); y1 = static_cast<unsigned int>(std::max(0.0, std::min(iy1, iy2))); x2 = static_cast<unsigned int>(std::min(columns, std::max(ix1, ix2))); y2 = static_cast<unsigned int>(std::min(rows, std::max(iy1, iy2))); return true; } return false; } void DicomPixelMasker::Apply(ParsedDicomFile& toModify) { for (std::list<BaseRegion*>::const_iterator itr = regions_.begin(); itr != regions_.end(); ++itr) { const BaseRegion* r = *itr; for (unsigned int i = 0; i < toModify.GetFramesCount(); ++i) { unsigned int x1, y1, x2, y2; if (r->GetPixelMaskArea(x1, y1, x2, y2, toModify, i)) { ImageAccessor imageRegion; toModify.GetRawFrame(i)->GetRegion(imageRegion, x1, y1, x2 - x1, y2 - y1); if (r->GetMode() == DicomPixelMaskerMode_MeanFilter) { ImageProcessing::MeanFilter(imageRegion, r->GetFilterWidth(), r->GetFilterWidth()); } else if (r->GetMode() == DicomPixelMaskerMode_Fill) { ImageProcessing::Set(imageRegion, r->GetFillValue()); } } } } } void DicomPixelMasker::ParseRequest(const Json::Value& request) { if (request.isMember(KEY_MASK_PIXELS) && request[KEY_MASK_PIXELS].isObject()) { const Json::Value& maskPixelsJson = request[KEY_MASK_PIXELS]; if (maskPixelsJson.isMember(KEY_REGIONS) && maskPixelsJson[KEY_REGIONS].isArray()) { const Json::Value& regionsJson = maskPixelsJson[KEY_REGIONS]; for (Json::ArrayIndex i = 0; i < regionsJson.size(); ++i) { const Json::Value& regionJson = regionsJson[i]; std::unique_ptr<BaseRegion> region; if (regionJson.isMember(KEY_REGION_TYPE) && regionJson[KEY_REGION_TYPE].isString()) { if (regionJson[KEY_REGION_TYPE].asString() == KEY_REGION_2D) { if (regionJson.isMember(KEY_ORIGIN) && regionJson[KEY_ORIGIN].isArray() && regionJson[KEY_ORIGIN].size() == 2 && regionJson.isMember(KEY_END) && regionJson[KEY_END].isArray() && regionJson[KEY_END].size() == 2) { unsigned int x = regionJson[KEY_ORIGIN][0].asUInt(); unsigned int y = regionJson[KEY_ORIGIN][1].asUInt(); unsigned int width = regionJson[KEY_END][0].asUInt() - x; unsigned int height = regionJson[KEY_END][1].asUInt() - y; region.reset(new Region2D(x, y, width, height)); } else { throw OrthancException(ErrorCode_BadFileFormat, "2D Region: invalid coordinates"); } } else if (regionJson[KEY_REGION_TYPE].asString() == KEY_REGION_3D) { if (regionJson.isMember(KEY_ORIGIN) && regionJson[KEY_ORIGIN].isArray() && regionJson[KEY_ORIGIN].size() == 3 && regionJson.isMember(KEY_END) && regionJson[KEY_END].isArray() && regionJson[KEY_END].size() == 3) { double x1 = regionJson[KEY_ORIGIN][0].asDouble(); double y1 = regionJson[KEY_ORIGIN][1].asDouble(); double z1 = regionJson[KEY_ORIGIN][2].asDouble(); double x2 = regionJson[KEY_END][0].asDouble(); double y2 = regionJson[KEY_END][1].asDouble(); double z2 = regionJson[KEY_END][2].asDouble(); region.reset(new Region3D(x1, y1, z1, x2, y2, z2)); } else { throw OrthancException(ErrorCode_BadFileFormat, "2D Region: invalid coordinates"); } } else { throw OrthancException(ErrorCode_BadFileFormat, std::string(KEY_REGION_TYPE) + " unrecognized value '" + regionJson[KEY_REGION_TYPE].asString() +"'"); } } if (regionJson.isMember(KEY_MASK_TYPE) && regionJson[KEY_MASK_TYPE].isString()) { if (regionJson[KEY_MASK_TYPE].asString() == KEY_MASK_TYPE_FILL) { if (regionJson.isMember(KEY_FILL_VALUE) && regionJson[KEY_FILL_VALUE].isInt()) { region->SetFillValue(regionJson[KEY_FILL_VALUE].asInt()); } } else if (regionJson[KEY_MASK_TYPE].asString() == KEY_MASK_TYPE_MEAN_FILTER) { if (regionJson.isMember(KEY_FILTER_WIDTH) && regionJson[KEY_FILTER_WIDTH].isUInt()) { region->SetMeanFilter(regionJson[KEY_FILTER_WIDTH].asUInt()); } } else { throw OrthancException(ErrorCode_BadFileFormat, std::string(KEY_MASK_TYPE) + " should be '" + KEY_MASK_TYPE_FILL +"' or '" + KEY_MASK_TYPE_MEAN_FILTER + "'."); } } if (regionJson.isMember(KEY_TARGET_SERIES) && regionJson[KEY_TARGET_SERIES].isArray()) { std::set<std::string> targetSeries; SerializationToolbox::ReadSetOfStrings(targetSeries, regionJson, KEY_TARGET_SERIES); region->SetTargetSeries(targetSeries); } if (regionJson.isMember(KEY_TARGET_INSTANCES) && regionJson[KEY_TARGET_INSTANCES].isArray()) { std::set<std::string> targetInstances; SerializationToolbox::ReadSetOfStrings(targetInstances, regionJson, KEY_TARGET_INSTANCES); region->SetTargetInstances(targetInstances); } regions_.push_back(region.release()); } } } } }