itkBinomialBlurImageFilter.txx

Go to the documentation of this file.

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

  Program:   Insight Segmentation & Registration Toolkit
  Module:    $RCSfile: itkBinomialBlurImageFilter.txx,v $
  Language:  C++
  Date:      $Date: 2008-10-09 15:31:37 $
  Version:   $Revision: 1.26 $

  Copyright (c) Insight Software Consortium. All rights reserved.
  See ITKCopyright.txt or http://www.itk.org/HTML/Copyright.htm for details.

     This software is distributed WITHOUT ANY WARRANTY; without even 
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
     PURPOSE.  See the above copyright notices for more information.

=========================================================================*/
#ifndef __itkBinomialBlurImageFilter_txx
#define __itkBinomialBlurImageFilter_txx

#include "vnl/vnl_vector_fixed.h"
#include "itkProgressReporter.h"
#include "itkSize.h"
#include "itkImageRegion.h"
#include "itkImageRegionIterator.h"
#include "itkImageRegionConstIterator.h"
#include "itkImageRegionReverseIterator.h"
#include "itkBinomialBlurImageFilter.h"

namespace itk
{

template< class TInputImage, class TOutputImage >
BinomialBlurImageFilter< TInputImage, TOutputImage >
::BinomialBlurImageFilter()
{
  itkDebugMacro(<< "BinomialBlurImageFilter::BinomialBlurImageFilter() called");

  // The default is to just do one repetition
  m_Repetitions = 1;
}

template< class TInputImage, class TOutputImage >
void
BinomialBlurImageFilter< TInputImage, TOutputImage >
::GenerateInputRequestedRegion()
{
  itkDebugMacro(<< "BinomialBlurImageFilter::GenerateInputRequestedRegion() called");
  
  Superclass::GenerateInputRequestedRegion();

  InputImagePointer inputPtr = 
    const_cast< TInputImage * >( this->GetInput(0));
  OutputImagePointer outputPtr = this->GetOutput(0);

  if( !inputPtr || !outputPtr )
    {
    return;
    }

  typename TOutputImage::RegionType outputRegion;
  typename TInputImage::RegionType inputRegion;
  typename TInputImage::RegionType::SizeType inputSize;
  typename TInputImage::RegionType::IndexType inputIndex;
  
  outputRegion = outputPtr->GetRequestedRegion();

  // This filter needs a m_Repetitions pixel border about the output
  // (clamped of course at the true boundaries of the input image)
  inputRegion = outputRegion;

  inputSize = inputRegion.GetSize();
  inputIndex = inputRegion.GetIndex();

  typename TInputImage::RegionType::IndexType inputLargestPossibleRegionIndex
    = inputPtr->GetLargestPossibleRegion().GetIndex();
  typename TInputImage::RegionType::SizeType inputLargestPossibleRegionSize
    = inputPtr->GetLargestPossibleRegion().GetSize();

  for (unsigned int i=0; i < inputPtr->GetImageDimension(); ++i)
    {
    inputIndex[i] -= m_Repetitions;
    if (inputIndex[i] < inputLargestPossibleRegionIndex[i])
      {
      inputIndex[i] = inputLargestPossibleRegionIndex[i];
      }

    inputSize[i] += m_Repetitions;
    if (inputSize[i] > inputLargestPossibleRegionSize[i])
      {
      inputSize[i] = inputLargestPossibleRegionSize[i];
      }
    }

  inputRegion.SetIndex( inputIndex );
  inputRegion.SetSize( inputSize );
  
  inputPtr->SetRequestedRegion( inputRegion );
}


template< class TInputImage, class TOutputImage >
void
BinomialBlurImageFilter< TInputImage, TOutputImage >
::GenerateData()
{
  itkDebugMacro(<< "BinomialBlurImageFilter::GenerateData() called");

  // Get the input and output pointers
  InputImageConstPointer  inputPtr  = this->GetInput(0);
  OutputImagePointer      outputPtr = this->GetOutput(0);

  // Allocate the output
  outputPtr->SetBufferedRegion( outputPtr->GetRequestedRegion() );
  outputPtr->Allocate();

  // Create a temporary image used while processing the image
  // Processing with doubles eliminates possible rounding artifacts which may
  // accumulate over repeated integer division
  typedef Image<double, NDimensions> TTempImage;
  typename TTempImage::Pointer tempPtr = TTempImage::New();

  typename TTempImage::RegionType tempRegion;
  tempRegion = inputPtr->GetRequestedRegion();
  
  tempPtr->SetLargestPossibleRegion( tempRegion );
  tempPtr->SetBufferedRegion( tempRegion );
  tempPtr->SetRequestedRegion( tempRegion );
  tempPtr->Allocate();

  // How big is the input image?
  typename TInputImage::SizeType size=inputPtr->GetRequestedRegion().GetSize();
  typename TInputImage::IndexType startIndex=inputPtr->GetRequestedRegion().GetIndex();
  
  // Iterator Typedefs for this routine
  typedef ImageRegionIterator<TTempImage>        TempIterator;
  typedef ImageRegionReverseIterator<TTempImage> TempReverseIterator;
  typedef ImageRegionConstIterator<TInputImage>  InputIterator;
  typedef ImageRegionIterator<TOutputImage>      OutputIterator;

  // Create a progress reporter
  ProgressReporter progress(this, 0, (outputPtr->GetRequestedRegion().GetNumberOfPixels()) * m_Repetitions * 2 * NDimensions);
  
  // Copy the input image to the temporary image
  TempIterator tempIt = TempIterator(tempPtr,
                                     tempPtr->GetRequestedRegion());
  InputIterator inputIt = InputIterator(inputPtr, inputPtr->GetRequestedRegion());
  
  for ( inputIt.GoToBegin(), tempIt.GoToBegin(); !tempIt.IsAtEnd();++tempIt, ++inputIt)
    {
    tempIt.Set( static_cast<double>(inputIt.Get()) );
    }

  // Define a few indices that will be used to translate from an input pixel
  // to an output pixel
  typename TTempImage::IndexType index;
  typename TTempImage::IndexType indexShift;

  // How many times has the algorithm executed? (for debug)
  int num_reps = 0;

  // Temporary pixel storage
  double pixelA, pixelB;

  // walk the output image forwards and compute blur
  for (unsigned int rep = 0; rep < m_Repetitions; rep++)
    {
    num_reps++;

    itkDebugMacro(<< "Repetition # " << rep);

    // blur each dimension
    for (unsigned int dim = 0; dim < NDimensions; dim ++)
      {
      TempIterator tempItDir = TempIterator(tempPtr,
                                         tempPtr->GetRequestedRegion());
      tempItDir.GoToBegin();
      while( !tempItDir.IsAtEnd() )
        {
        // determine the index of the output pixel
        index = tempItDir.GetIndex();

        if ( index[dim] < 
             ( startIndex[dim] + static_cast<long>(size[dim]) - 1))
          {
          // Figure out the location of the "neighbor" pixel
          for (unsigned int i = 0; i < NDimensions; i++)
            {
            if ( i == dim ) 
              {
              indexShift.m_Index[i] = index.m_Index[i] + 1;
              }
            else
              {
              indexShift.m_Index[i] = index.m_Index[i];
              }
            }

          // Average the pixel of interest and shifted pixel
          pixelA = tempPtr->GetPixel(index);
          pixelB = tempPtr->GetPixel(indexShift);

          pixelA += pixelB;
          pixelA = pixelA / 2.0;

          tempPtr->SetPixel(index, pixelA);
          progress.CompletedPixel();
          }

        ++tempItDir;
    
        } // end walk the image forwards
      
      itkDebugMacro(<< "End processing forward dimension " << dim);

      //----------------------Reverse pass----------------------
      TempReverseIterator tempReverseIt
        = TempReverseIterator(tempPtr, tempPtr->GetRequestedRegion());
      
      tempReverseIt.GoToBegin();
      
      while ( !tempReverseIt.IsAtEnd() )
        {
        // determine the index of the output pixel
        index = tempReverseIt.GetIndex();

        if (index[dim] > startIndex[dim])
          {
          // Figure out the location of the "neighbor" pixel
          for (unsigned int i = 0; i < NDimensions; i++)
            {
            if ( i == dim ) 
              {
              indexShift.m_Index[i] = index.m_Index[i] - 1;
              }
            else
              {
              indexShift.m_Index[i] = index.m_Index[i];
              }
            }

          // Average the pixel of interest and shifted pixel
          pixelA = tempPtr->GetPixel(index);
          pixelB = tempPtr->GetPixel(indexShift);

          pixelA += pixelB;
          pixelA = pixelA / 2;

          tempPtr->SetPixel(index, pixelA);
          progress.CompletedPixel();
          }

        ++tempReverseIt;
    
        } // end walk the image backwards
      
      itkDebugMacro(<< "End processing reverse dimension " << dim);
      } // end dimension loop

    } // end number of repetitions loop

  // Now, copy the temporary image to the output image. Note that the temp
  // buffer iterator walks a region defined by the output
  typedef ImageRegionIterator<TOutputImage> OutputIterator;

  OutputIterator outIt = OutputIterator(outputPtr,
                                        outputPtr->GetRequestedRegion());
  TempIterator tempIt2 = TempIterator(tempPtr,
                                      outputPtr->GetRequestedRegion());
  
  for ( outIt.GoToBegin(), tempIt2.GoToBegin(); !outIt.IsAtEnd();
        ++outIt, ++tempIt2)
    {
    outIt.Set( static_cast<PixelType>(tempIt2.Get()) );
    }

  itkDebugMacro(<< "Binomial blur filter executed " << num_reps << " times");
}

template< class TInputImage, class TOutputImage >
void
BinomialBlurImageFilter< TInputImage, TOutputImage >
::PrintSelf(std::ostream& os, Indent indent) const
{
  Superclass::PrintSelf(os,indent);
  
  os << indent << "Number of repetitions: " << m_Repetitions << std::endl;
  
}

} // end namespace

#endif