mitkITKDICOMSeriesReaderHelper.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 mitkITKDICOMSeriesReaderHelper_h
#define mitkITKDICOMSeriesReaderHelper_h
 
#include "mitkImage.h"
#include "mitkGantryTiltInformation.h"
#include "mitkDICOMTag.h"
 
#include <itkGDCMImageIO.h>
 
/* Forward deceleration of an DCMTK class. Used in the txx but part of the interface.*/
class OFDateTime;
 
namespace mitk
{
 
class ITKDICOMSeriesReaderHelper
{
  public:
 
    static const DICOMTag AcquisitionDateTag;
    static const DICOMTag AcquisitionTimeTag;
    static const DICOMTag TriggerTimeTag;
 
    typedef std::vector<std::string> StringContainer;
    typedef std::list<StringContainer> StringContainerList;
 
    Image::Pointer Load( const StringContainer& filenames, bool correctTilt, const GantryTiltInformation& tiltInfo );
    Image::Pointer Load3DnT( const StringContainerList& filenamesLists, bool correctTilt, const GantryTiltInformation& tiltInfo );
 
    static bool CanHandleFile(const std::string& filename);
 
  private:
 
    typedef std::vector<TimeBounds> TimeBoundsList;
    typedef itk::FixedArray<OFDateTime,2>  DateTimeBounds;
 
 
    static bool ExtractDateTimeBoundsAndTriggerOfTimeStep( const StringContainer& filenamesOfTimeStep,
      DateTimeBounds& bounds, TimeBounds& triggerBounds);
 
    /* Determine the time bounds in ms respective to the baselineDateTime for the passed
    files. Additionally it regards the trigger time tag if set and acquisition date time
    carries not enough information.
    @param [in, out] usedTriggerBounds Variable used to communicate if preceding time bounds extractions
    used the trigger time (true). If true is passed to the method, it will use always trigger time
    to extract the next bounds. Default is false. After the method call is returning the variable indicates
    the last call used trigger time or not to extract the time bounds.*/
    static bool ExtractTimeBoundsOfTimeStep(const StringContainer& filenamesOfTimeStep,
                                                 TimeBounds& bounds,
                                                 const OFDateTime& baselineDateTime,
                                                 bool& usedTriggerBounds);
 
    static TimeBoundsList ExtractTimeBoundsOfTimeSteps (const StringContainerList& filenamesOfTimeSteps);
 
    static TimeGeometry::Pointer GenerateTimeGeometry(const BaseGeometry* templateGeometry, const TimeBoundsList& boundsList);
 
    template <typename ImageType>
    typename ImageType::Pointer
    FixUpTiltedGeometry( ImageType* input, const GantryTiltInformation& tiltInfo );
 
    template <typename PixelType, unsigned int TDim>
    Image::Pointer
    LoadDICOMByITK( const StringContainer& filenames,
                    bool correctTilt,
                    const GantryTiltInformation& tiltInfo,
                    itk::GDCMImageIO::Pointer& io);
 
    template<unsigned int TDim>
    mitk::Image::Pointer
    LoadByTypeDispatch(const StringContainer& filenames,
        bool correctTilt,
        const GantryTiltInformation& tiltInfo,
        itk::GDCMImageIO::Pointer& io);
 
 
    template <typename PixelType>
    Image::Pointer
    LoadDICOMByITK3DnT( const StringContainerList& filenames,
                        bool correctTilt,
                        const GantryTiltInformation& tiltInfo,
                        itk::GDCMImageIO::Pointer& io);
 
 
};
 
}
 
#endif