Presentation is loading. Please wait.

Presentation is loading. Please wait.

NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Writing a New ITK Filter.

Published byAaliyah Gibson Modified over 10 years ago

Similar presentations

Presentation on theme: "NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Writing a New ITK Filter."— Presentation transcript:

1 NA-MIC National Alliance for Medical Image Computing http://na-mic.org ITK Workshop October 5-8, 2005 Writing a New ITK Filter

2 National Alliance for Medical Image Computing http://na-mic.org ITK Workshop – Extending the Toolkit Filters Anatomy –Class HierarchyClass Hierarchy –InputsInputs –OutputsOutputs UnaryFunctorFilter –Casting ExampleCasting Example –Division by 2 ExampleDivision by 2 Example –Functor with parameters ExampleFunctor with parameters Example Regions and Iterators –Defining properties of the Output ImageDefining properties of the Output Image –Allocating the outputAllocating the output –Using IteratorsUsing Iterators

3 National Alliance for Medical Image Computing http://na-mic.org Anatomy of an ITK Filter Insight Toolkit - Advanced Course

4 National Alliance for Medical Image Computing http://na-mic.org The Class Hierarchy itk::ProcessObject itk::DataObject itk::Object itk::ImageBase itk::Image itk::ImageSource itk::ImageToImageFilter

5 National Alliance for Medical Image Computing http://na-mic.org The Class Hierarchy itk::InPlaceImageFilter itk::UnaryFunctorImageFilteritk::BinaryFunctorImageFilter itk::TernaryFunctorImageFilter itk::ImageToImageFilter

6 National Alliance for Medical Image Computing http://na-mic.org Filter Typical Elements Input Image Output Image Filter Parameters

7 National Alliance for Medical Image Computing http://na-mic.org InPlace Filter Elements Input Image Output Image Filter Parameters

8 National Alliance for Medical Image Computing http://na-mic.org The Unary Functor Image Filter Insight Toolkit - Advanced Course

9 National Alliance for Medical Image Computing http://na-mic.org Image Filter Hierarchy template class ImageToImageFilter : public ImageSource {…}; template class InPlaceToImageFilter : public ImageToImageFilter {…}; template class ImageSource : public ProcessObject {…};

10 National Alliance for Medical Image Computing http://na-mic.org Unary Functor Filter itk::UnaryFunctorImageFilter Pixel-Wise Image Filter Input ImageOutput Image

11 National Alliance for Medical Image Computing http://na-mic.org It should be enough to specify the operation to be applied on each pixel Unary Functor Filter That is the role of the FUNCTOR

12 National Alliance for Medical Image Computing http://na-mic.org Unary Functor Filter Filter Functor template class UnaryFunctorImageFilter : public InPlaceImageFilter { private: TFunctor m_Functor; };

13 National Alliance for Medical Image Computing http://na-mic.org Exercise 23 Insight Toolkit - Advanced Course Create an Image Filter that performs Casting

14 National Alliance for Medical Image Computing http://na-mic.org namespace itk { namespace Functor { template class Cast { public: Cast() {}; ~Cast() {}; inline TOutput operator()( const TInput & A ) { return static_cast ( A ); } }; } // end of Functor namespace Unary Functor Filter Example : Casting

15 National Alliance for Medical Image Computing http://na-mic.org Unary Functor Filter Example : Casting #include itkUnaryFunctorImageFilter.h template class MyFunctorImageFilter : public UnaryFunctorImageFilter< TInputImage,TOutputImage, Functor::Cast > { …

16 National Alliance for Medical Image Computing http://na-mic.org public: typedef MyFunctorImageFilter Self; typedef UnaryFunctorImageFilter< TInputImage, TOutputImage, Functor::Cast > Superclass; typedef SmartPointer Pointer; typedef SmartPointer ConstPointer; itkNewMacro( Self ); itkTypeMacro( MyFunctorImageFilter, UnaryFunctorImageFilter ); Unary Functor Filter Example : Casting

17 National Alliance for Medical Image Computing http://na-mic.org Typical Declarations: Traits and Macros Traits Self Superclass Pointer ConstPointer Macros NewMacro TypeMacro

18 National Alliance for Medical Image Computing http://na-mic.org protected: MyFunctorImageFilter() {} virtual ~MyFunctorImageFilter() {} private: MyFunctorImageFilter( const Self & ); // purposely not implemented void operator=( const Self & ); // purposely not implemented }; // end of class } // end of namespace itk Unary Functor Filter Example : Casting

19 National Alliance for Medical Image Computing http://na-mic.org #include MyFunctorImageFilter.h int main() { typedef itk::Image InputImageType; typedef itk::Image OutputImageType; typedef itk::MyFunctorImageFilter FilterType; FilterType::Pointer filter = FilterType::New(); } Unary Functor Filter Example : Casting

20 National Alliance for Medical Image Computing http://na-mic.org Exercise 24 Insight Toolkit - Advanced Course Create an Image Filter that divides all the intensity values by 2

21 National Alliance for Medical Image Computing http://na-mic.org NOTE Insight Toolkit - Advanced Course The use of itk::NumericTraits<> and RealType and typename

22 National Alliance for Medical Image Computing http://na-mic.org namespace itk { namespace Functor { template class Divider { public: Divider() {}; ~Divider() {}; inline TOutput operator()( const TInput & A ) { typedef typename NumericTraits ::RealType InputRealType; return static_cast ( InputRealType( A ) / 2.0 ); } }; } // end of Functor namespace Exercise

23 National Alliance for Medical Image Computing http://na-mic.org Exercise #include itkUnaryFunctorImageFilter.h template class DividerByTwoImageFilter : public UnaryFunctorImageFilter< TInputImage,TOutputImage, Functor::Divider > { public: typedef MyFunctorImageFilter Self; typedef UnaryFunctorImageFilter< TInputImage, TOutputImage, Functor::Divider > Superclass; …

24 National Alliance for Medical Image Computing http://na-mic.org Exercise 25 Insight Toolkit - Advanced Course Create an Image Filter that divides all the intensity values by a given value

25 National Alliance for Medical Image Computing http://na-mic.org namespace itk { namespace Functor { template class Divider { public: Divider() {}; ~Divider() {}; typedef typename NumericTraits ::RealType InputRealType; inline TOutput operator()( const TInput & A ) { return static_cast ( InputRealType( A ) / m_Divisor ); } void SetDivisor( const InputRealType & value ) { m_Divisor = value; } private: InputRealType m_Divisor; }; Exercise : Functors with parameters

26 National Alliance for Medical Image Computing http://na-mic.org Exercise : Functors with parameters template class DividerImageFilter : public UnaryFunctorImageFilter< TInputImage,TOutputImage, Divider > {…{… public: typedef typename Superclass::FunctorType FunctorType; typedef typename FunctorType::InputRealType InputRealType; void SetDivisor( const InputRealType & value ) { this->GetFunctor().SetDivisor( value ); }

27 National Alliance for Medical Image Computing http://na-mic.org #include DividerImageFilter.h int main() { typedef itk::Image InputImageType; typedef itk::Image OutputImageType; typedef itk::DividerImageFilter FilterType; FilterType::Pointer filter = FilterType::New(); filter->SetDivisor( 7.5 ); filter->Update(); } Exercise : Functors with parameters

28 National Alliance for Medical Image Computing http://na-mic.org Image Regions Insight Toolkit - Advanced Course

29 National Alliance for Medical Image Computing http://na-mic.org Insight Toolkit – Image Regions LargestPossibleRegion BufferedRegion RequestedRegion

30 National Alliance for Medical Image Computing http://na-mic.org Filter Typical Elements Input Image Output Image Filter Parameters Region

31 National Alliance for Medical Image Computing http://na-mic.org Insight Toolkit – Image Regions Input Region Output Region Input ImageOutput Image

32 National Alliance for Medical Image Computing http://na-mic.org Generate Output Information Method Filter virtual void GenerateOutputInformation() { Superclass::GenerateOutputInformation(); OutputImagePointer outputPtr = this->GetOutput(); outputPtr->SetLargestPossibleRegion(…); outputPtr->SetSpacing(…); outputPtr->SetOrigin(…); }

33 National Alliance for Medical Image Computing http://na-mic.org Generate Output Information Method Spacing Origin Orientation (Direction) LargestPossibleRegion This method configures the Output Image by default it copies meta data from the Input

34 National Alliance for Medical Image Computing http://na-mic.org Exercise 26 Insight Toolkit - Advanced Course Create an Image Filter that extracts the first quadrant of an image

35 National Alliance for Medical Image Computing http://na-mic.org Quadrant Extract Image Filter Example #include itkImageToImageFilter.h template class FirstQuadrantExtractImageFilter : public ImageToImageFilter { public: typedef FirstQuadrantExtractImageFilter Self; typedef ImageToImageFilter Superclass; typedef SmartPointer Pointer; typedef SmartPointer ConstPointer; itkNewMacro( Self ); itkTypeMacro( FirstQuadrantExtractImageFilter, ImageToImageFilter ); …

36 National Alliance for Medical Image Computing http://na-mic.org Quadrant Extract Image Filter Example typedef typename TInputImage::RegionType RegionType; typedef typename TInputImage::SizeType SizeType; typedef typename TInputImage::IndexType IndexType; typedef typename TInputImage::Pointer ImagePointer; typedef typename TInputImage::ConstPointer ImageConstPointer; protected: FirstQuadrantExtractImageFilter() {}; ~FirstQuadrantExtractImageFilter() {}; void PrintSelf( std::ostream &os, Indent indent) const; void GenerateOutputInformation(); void GenerateData();

37 National Alliance for Medical Image Computing http://na-mic.org GenerateOutputInformation() Method Call Superclass::GenerateOutputInformation() Set Parameters of the Output Image Spacing Origin Direction LargestPossibleRegion

38 National Alliance for Medical Image Computing http://na-mic.org GenerateOutputInformation() Method template void GenerateOutputInformation() { Superclass::GenerateOutputInformation(); ImageConstPointer inputImage = this->GetInput(); ImagePointer outputImage = this->GetOutput(); RegionType inputRegion = inputImage->GetLargestPossibleRegion (); IndexType inputStart = inputRegion.GetIndex(); SizeType inputSize = inputRegion.GetSize();

39 National Alliance for Medical Image Computing http://na-mic.org GenerateOutputInformation() Method IndexType outputStart; SizeType outputSize; const unsigned int Dimension = TInputImage::ImageDimension; for( unsigned int i = 0; i < Dimension; i++ ) { outputSize[i] = inputSize[i] / 2; outputStart[i] = inputStart[i]; } RegionType outputRegion; outputRegion.SetIndex( outputStart ); outputRegion.SetSize( outputSize );

40 National Alliance for Medical Image Computing http://na-mic.org GenerateOutputInformation() Method outputImage->SetLargestPossibleRegion( outputRegion ); outputImage->SetSpacing( inputImage->GetSpacing() ); outputImage->SetOrigin( inputImage->GetOrigin() ); outputImage->SetDirection( inputImage->GetDirection() ); } // end of GenerateOutputInformation() method

41 National Alliance for Medical Image Computing http://na-mic.org GenerateData() Method Get Input and Output Image pointers Invokes GetInput() Invokes GetOutput() Allocate memory for the Output Image (s) Invokes SetRegions() Invokes Allocate() Computes pixels of Output Image Usually requires Image Iterators

42 National Alliance for Medical Image Computing http://na-mic.org GenerateData() Method template void GenerateData() { ImageConstPointer inputImage = this->GetInput(); ImagePointer outputImage = this->GetOutput(); RegionType outputRegion = outputImage->GetLargestPossibleRegion(); outputImage->SetRegions( outputRegion ); outputImage->Allocate(); typedef ImageRegionIterator ImageIterator; typedef ImageRegionConstIterator ImageConstIterator; ImageIterator outputIterator( outputImage, outputRegion ); ImageConstIterator inputIterator( inputImage, outputRegion );

43 National Alliance for Medical Image Computing http://na-mic.org Insight Toolkit – Image Regions First Quadrant Input Image Region Output Image Region

44 National Alliance for Medical Image Computing http://na-mic.org GenerateData() Method inputIterator.GoToBegin(); outputIterator.GoToBegin(); while( ! outputIterator.IsAtEnd() ) { outputIterator.Set( inputIterator.Get() ); ++inputIterator; ++outputIterator; }

45 National Alliance for Medical Image Computing http://na-mic.org Exercise 26b Insight Toolkit - Advanced Course Modify the code for extracting the central thirds an image

46 National Alliance for Medical Image Computing http://na-mic.org Insight Toolkit – Image Regions Input Image Region Output Image Region Central Third

47 National Alliance for Medical Image Computing http://na-mic.org END Insight Toolkit - Advanced Course

Download ppt "NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Writing a New ITK Filter."

Similar presentations

Lecture 3 -- 1Computer Science I - Martin Hardwick The Programming Process rUse an editor to create a program file (source file). l contains the text of.

Lecture Computer Science I - Martin Hardwick The Programming Process rUse an editor to create a program file (source file). l contains the text of.
Chapter 7 Constructors and Other Tools. Copyright © 2006 Pearson Addison-Wesley. All rights reserved. 7-2 Learning Objectives Constructors Definitions.

Chapter 7 Constructors and Other Tools. Copyright © 2006 Pearson Addison-Wesley. All rights reserved. 7-2 Learning Objectives Constructors Definitions.
NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Multi-Threading.

NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Multi-Threading.
NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Software Design.

NA-MIC National Alliance for Medical Image Computing ITK Workshop October 5-8, 2005 Software Design.
ITK Architecture Kitware Inc.. ITK Basics C++ Generic Programming Data Pipeline Multi-threading Streaming Exceptions Events / Observers Tcl, Python and.

ITK Architecture Kitware Inc.. ITK Basics C++ Generic Programming Data Pipeline Multi-threading Streaming Exceptions Events / Observers Tcl, Python and.
ITK Segmentation Methods

ITK Segmentation Methods
ITK Registration Methods

ITK Registration Methods
ITK Deformable Registration

ITK Deformable Registration
National Alliance for Medical Image Computing Slicer3 plugins: Going Further Common architecture for interactive and batch processing.

National Alliance for Medical Image Computing Slicer3 plugins: Going Further Common architecture for interactive and batch processing.
Brown Bag #2 Advanced C++. Topics  Templates  Standard Template Library (STL)  Pointers and Smart Pointers  Exceptions  Lambda Expressions  Tips.

Brown Bag #2 Advanced C++. Topics  Templates  Standard Template Library (STL)  Pointers and Smart Pointers  Exceptions  Lambda Expressions  Tips.
National Alliance for Medical Image Computing Slicer3 plugins Common architecture for interactive and batch processing.

National Alliance for Medical Image Computing Slicer3 plugins Common architecture for interactive and batch processing.
Chapter 6 Advanced Function Features Pass by Value Pass by Reference Const parameters Overloaded functions.

Chapter 6 Advanced Function Features Pass by Value Pass by Reference Const parameters Overloaded functions.
GPU Acceleration in ITK v4

GPU Acceleration in ITK v4
C++ Basics Variables, Identifiers, Assignments, Input/Output.

C++ Basics Variables, Identifiers, Assignments, Input/Output.
Methods in Image Analysis 2004, Damion Shelton 1 ITK Lecture 4 Images in ITK Methods in Image Analysis CMU Robotics Institute 16-725 U. Pitt Bioengineering.

Methods in Image Analysis 2004, Damion Shelton 1 ITK Lecture 4 Images in ITK Methods in Image Analysis CMU Robotics Institute U. Pitt Bioengineering.
1 ITK Lecture 7 - Writing Filters, Part 1 Methods in Image Analysis CMU Robotics Institute 16-725 U. Pitt Bioengineering 2630 Spring Term, 2006 Methods.

1 ITK Lecture 7 - Writing Filters, Part 1 Methods in Image Analysis CMU Robotics Institute U. Pitt Bioengineering 2630 Spring Term, 2006 Methods.
Chapter 14: Overloading and Templates

Chapter 14: Overloading and Templates
Rossella Lau Lecture 8, DCO10105, Semester B,2004-5 DCO10105 Object-Oriented Programming and Design  Lecture 8: Polymorphism & C++ pointer  Inheritance.

Rossella Lau Lecture 8, DCO10105, Semester B, DCO10105 Object-Oriented Programming and Design  Lecture 8: Polymorphism & C++ pointer  Inheritance.
Shallow Versus Deep Copy and Pointers Shallow copy: when two or more pointers of the same types point to the same memory – They point to the same data.

Shallow Versus Deep Copy and Pointers Shallow copy: when two or more pointers of the same types point to the same memory – They point to the same data.
1 ITK Lecture 2 A brief C++ review Methods in Image Analysis CMU Robotics Institute 16-725 U. Pitt Bioengineering 2630 Spring Term, 2006 Methods in Image.

1 ITK Lecture 2 A brief C++ review Methods in Image Analysis CMU Robotics Institute U. Pitt Bioengineering 2630 Spring Term, 2006 Methods in Image.

Similar presentations

Ads by Google