mitkDICOMTagBasedSorter.h

Go to the documentation of this file.

/*============================================================================
 
The Medical Imaging Interaction Toolkit (MITK)
 
Copyright (c) German Cancer Research Center (DKFZ)
All rights reserved.
 
Use of this source code is governed by a 3-clause BSD license that can be
found in the LICENSE file.
 
============================================================================*/
 
#ifndef mitkDICOMTagBasedSorter_h
#define mitkDICOMTagBasedSorter_h
 
#include "mitkDICOMDatasetSorter.h"
#include "mitkDICOMSortCriterion.h"
 
namespace mitk
{
 
class MITKDICOM_EXPORT DICOMTagBasedSorter : public DICOMDatasetSorter
{
  public:
 
    class MITKDICOM_EXPORT TagValueProcessor
    {
      public:
        virtual std::string operator()(const std::string&) const = 0;
        virtual TagValueProcessor* Clone() const = 0;
        virtual ~TagValueProcessor() {}
    };
 
    class MITKDICOM_EXPORT CutDecimalPlaces : public TagValueProcessor
    {
      public:
        CutDecimalPlaces(unsigned int precision);
        CutDecimalPlaces(const CutDecimalPlaces& other);
        unsigned int GetPrecision() const;
        std::string operator()(const std::string&) const override;
        TagValueProcessor* Clone() const override;
      private:
        unsigned int m_Precision;
    };
 
    mitkClassMacro( DICOMTagBasedSorter, DICOMDatasetSorter );
 
    itkNewMacro( DICOMTagBasedSorter );
 
    void AddDistinguishingTag( const DICOMTag&, TagValueProcessor* tagValueProcessor = nullptr );
    DICOMTagList GetDistinguishingTags() const;
    const TagValueProcessor* GetTagValueProcessorForDistinguishingTag(const DICOMTag&) const;
 
    void SetSortCriterion( DICOMSortCriterion::ConstPointer criterion );
    DICOMSortCriterion::ConstPointer GetSortCriterion() const;
 
    DICOMTagList GetTagsOfInterest() override;
 
    void SetStrictSorting(bool strict);
    bool GetStrictSorting() const;
 
    void SetExpectDistanceOne(bool strict);
    bool GetExpectDistanceOne() const;
 
 
    void Sort() override;
 
    void PrintConfiguration(std::ostream& os, const std::string& indent = "") const override;
 
    bool operator==(const DICOMDatasetSorter& other) const override;
 
    static bool GetDefaultStrictSorting()
    {
      return m_DefaultStrictSorting;
    }
 
    static bool GetDefaultExpectDistanceOne()
    {
      return m_DefaultExpectDistanceOne;
    }
 
  protected:
 
    struct ParameterizedDatasetSort
    {
      ParameterizedDatasetSort(DICOMSortCriterion::ConstPointer);
      bool operator() (const mitk::DICOMDatasetAccess* left, const mitk::DICOMDatasetAccess* right);
      DICOMSortCriterion::ConstPointer m_SortCriterion;
    };
 
 
    DICOMTagBasedSorter();
    ~DICOMTagBasedSorter() override;
 
    DICOMTagBasedSorter(const DICOMTagBasedSorter& other);
    DICOMTagBasedSorter& operator=(const DICOMTagBasedSorter& other);
 
    std::string BuildGroupID( DICOMDatasetAccess* dataset );
 
    using GroupIDToListType = std::map<std::string, DICOMDatasetList>;
 
    using SplitReasonListType = std::map<std::string, IOVolumeSplitReason::Pointer>;
 
    GroupIDToListType SplitInputGroups(SplitReasonListType& splitReasons);
 
    GroupIDToListType& SortGroups(GroupIDToListType& groups, SplitReasonListType& splitReasons);
 
    DICOMTagList m_DistinguishingTags;
    typedef std::map<const DICOMTag, TagValueProcessor*>  TagValueProcessorMap;
    TagValueProcessorMap m_TagValueProcessor;
 
    DICOMSortCriterion::ConstPointer m_SortCriterion;
 
    bool m_StrictSorting;
    bool m_ExpectDistanceOne;
 
    const static bool m_DefaultStrictSorting = false;
    const static bool m_DefaultExpectDistanceOne = false;
};
 
}
 
#endif