mitkDICOMITKSeriesGDCMReader.h

Go to the documentation of this file.

/*===================================================================

The Medical Imaging Interaction Toolkit (MITK)

Copyright (c) German Cancer Research Center,
Division of Medical and Biological Informatics.
All rights reserved.

This software is distributed WITHOUT ANY WARRANTY; without
even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE.

See LICENSE.txt or http://www.mitk.org for details.

===================================================================*/

#ifndef mitkDICOMITKSeriesGDCMReader_h
#define mitkDICOMITKSeriesGDCMReader_h

#include <stack>
#include "itkMutexLock.h"
#include "mitkDICOMFileReader.h"
#include "mitkDICOMDatasetSorter.h"
#include "mitkDICOMGDCMImageFrameInfo.h"
#include "mitkEquiDistantBlocksSorter.h"
#include "mitkNormalDirectionConsistencySorter.h"
#include "MitkDICOMReaderExports.h"


namespace itk
{
  class TimeProbesCollectorBase;
}

namespace mitk
{

class MITKDICOMREADER_EXPORT DICOMITKSeriesGDCMReader : public DICOMFileReader
{
  public:

    mitkClassMacro( DICOMITKSeriesGDCMReader, DICOMFileReader );
    mitkCloneMacro( DICOMITKSeriesGDCMReader );
    itkFactorylessNewMacro( DICOMITKSeriesGDCMReader );
    mitkNewMacro1Param( DICOMITKSeriesGDCMReader, unsigned int );

    virtual void AnalyzeInputFiles() override;

    // void AllocateOutputImages();
    virtual bool LoadImages() override;

    // re-implemented from super-class
    virtual bool CanHandleFile(const std::string& filename) override;

    virtual void AddSortingElement(DICOMDatasetSorter* sorter, bool atFront = false);

    typedef const std::list<DICOMDatasetSorter::ConstPointer> ConstSorterList;
    ConstSorterList GetFreelyConfiguredSortingElements() const;

    void SetFixTiltByShearing(bool on);

    bool GetFixTiltByShearing() const;

    void SetAcceptTwoSlicesGroups(bool accept) const;
    bool GetAcceptTwoSlicesGroups() const;

    void SetToleratedOriginOffsetToAdaptive(double fractionOfInterSliceDistanct = 0.3) const;

    void SetToleratedOriginOffset(double millimeters = 0.005) const;

    double GetToleratedOriginError() const;
    bool IsToleratedOriginOffsetAbsolute() const;

    double GetDecimalPlacesForOrientation() const;

    virtual bool operator==(const DICOMFileReader& other) const override;

    virtual DICOMTagPathList GetTagsOfInterest() const override;

  protected:

    virtual void InternalPrintConfiguration(std::ostream& os) const override;

  static std::string GetActiveLocale();
    void PushLocale() const;
    void PopLocale() const;

    DICOMITKSeriesGDCMReader(unsigned int decimalPlacesForOrientation = 5);
    virtual ~DICOMITKSeriesGDCMReader();

    DICOMITKSeriesGDCMReader(const DICOMITKSeriesGDCMReader& other);
    DICOMITKSeriesGDCMReader& operator=(const DICOMITKSeriesGDCMReader& other);

    typedef std::vector<DICOMDatasetAccessingImageFrameList> SortingBlockList;
    virtual SortingBlockList Condense3DBlocks(SortingBlockList& resultOf3DGrouping);

    virtual DICOMTagCache::Pointer GetTagCache() const;
    void SetTagCache( const DICOMTagCache::Pointer& ) override;

  static SortingBlockList InternalExecuteSortingStep(
        unsigned int sortingStepIndex,
        const DICOMDatasetSorter::Pointer& sorter,
        const SortingBlockList& input);

    virtual bool LoadMitkImageForOutput(unsigned int o);

    virtual bool LoadMitkImageForImageBlockDescriptor(DICOMImageBlockDescriptor& block) const;

  static ReaderImplementationLevel GetReaderImplementationLevel(const std::string sopClassUID);
  private:

    void EnsureMandatorySortersArePresent(unsigned int decimalPlacesForOrientation);

  protected:

    // NOT nice, made available to ThreeDnTDICOMSeriesReader due to lack of time
    bool m_FixTiltByShearing; // could be removed by ITKDICOMSeriesReader NOT flagging tilt unless requested to fix it!

  private:

    SortingBlockList m_SortingResultInProgress;

    typedef std::list<DICOMDatasetSorter::Pointer> SorterList;
    SorterList m_Sorter;

  protected:

    // NOT nice, made available to ThreeDnTDICOMSeriesReader and ClassicDICOMSeriesReader due to lack of time
    mitk::EquiDistantBlocksSorter::Pointer m_EquiDistantBlocksSorter;

    mitk::NormalDirectionConsistencySorter::Pointer m_NormalDirectionConsistencySorter;

  private:

    static itk::MutexLock::Pointer s_LocaleMutex;

    mutable std::stack<std::string> m_ReplacedCLocales;
    mutable std::stack<std::locale> m_ReplacedCinLocales;

    double m_DecimalPlacesForOrientation;

    DICOMTagCache::Pointer m_TagCache;
    bool m_ExternalCache;
};

}

#endif