ITK  5.2.0
Insight Toolkit
itkStatisticsImageFilter.h
Go to the documentation of this file.
1 /*=========================================================================
2  *
3  * Copyright NumFOCUS
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0.txt
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  *
17  *=========================================================================*/
18 #ifndef itkStatisticsImageFilter_h
19 #define itkStatisticsImageFilter_h
20 
21 #include "itkImageSink.h"
22 #include "itkNumericTraits.h"
23 #include "itkArray.h"
25 #include <mutex>
27 
28 namespace itk
29 {
54 template <typename TInputImage>
55 class ITK_TEMPLATE_EXPORT StatisticsImageFilter : public ImageSink<TInputImage>
56 {
57 public:
58  ITK_DISALLOW_COPY_AND_MOVE(StatisticsImageFilter);
59 
65 
67  itkNewMacro(Self);
68 
71 
73  using InputImagePointer = typename TInputImage::Pointer;
74 
76  using SizeType = typename TInputImage::SizeType;
78  using PixelType = typename TInputImage::PixelType;
79 
81  static constexpr unsigned int ImageDimension = TInputImage::ImageDimension;
82 
85 
88 
92 
94  itkGetDecoratedOutputMacro(Minimum, PixelType);
95 
97  itkGetDecoratedOutputMacro(Maximum, PixelType);
98 
100  itkGetDecoratedOutputMacro(Mean, RealType);
101 
103  itkGetDecoratedOutputMacro(Sigma, RealType);
104 
106  itkGetDecoratedOutputMacro(Variance, RealType);
107 
109  itkGetDecoratedOutputMacro(Sum, RealType);
110 
112  itkGetDecoratedOutputMacro(SumOfSquares, RealType);
113 
114  // Change the access from protected to public to expose streaming option, a using statement can not be used due to
115  // limitations of wrapping.
116  void
117  SetNumberOfStreamDivisions(const unsigned int n) override
118  {
119  Superclass::SetNumberOfStreamDivisions(n);
120  }
121  unsigned int
122  GetNumberOfStreamDivisions() const override
123  {
124  return Superclass::GetNumberOfStreamDivisions();
125  }
126 
130  using Superclass::MakeOutput;
132  MakeOutput(const DataObjectIdentifierType & name) override;
133 
134 #ifdef ITK_USE_CONCEPT_CHECKING
135  // Begin concept checking
136  itkConceptMacro(InputHasNumericTraitsCheck, (Concept::HasNumericTraits<PixelType>));
137  // End concept checking
138 #endif
139 
140 protected:
142  ~StatisticsImageFilter() override = default;
143  void
144  PrintSelf(std::ostream & os, Indent indent) const override;
145 
147  void
148  BeforeStreamedGenerateData() override;
149 
152  void
153  AfterStreamedGenerateData() override;
154 
155  void
156  ThreadedStreamedGenerateData(const RegionType &) override;
157 
158  itkSetDecoratedOutputMacro(Minimum, PixelType);
159  itkSetDecoratedOutputMacro(Maximum, PixelType);
160  itkSetDecoratedOutputMacro(Mean, RealType);
161  itkSetDecoratedOutputMacro(Sigma, RealType);
162  itkSetDecoratedOutputMacro(Variance, RealType);
163  itkSetDecoratedOutputMacro(Sum, RealType);
164  itkSetDecoratedOutputMacro(SumOfSquares, RealType);
165 
166 private:
168  CompensatedSummation<RealType> m_SumOfSquares{ 1 };
169 
170  SizeValueType m_Count{ 1 };
171  PixelType m_ThreadMin{ 1 };
172  PixelType m_ThreadMax{ 1 };
173 
174  std::mutex m_Mutex;
175 }; // end of class
176 } // end namespace itk
177 
178 #ifndef ITK_MANUAL_INSTANTIATION
179 # include "itkStatisticsImageFilter.hxx"
180 #endif
181 
182 #endif
itk::SimpleDataObjectDecorator
Decorates any "simple" data type (data types without smart pointers) with a DataObject API.
Definition: itkSimpleDataObjectDecorator.h:66
itk::CompensatedSummation< RealType >
itk::Concept::HasNumericTraits
Definition: itkConceptChecking.h:714
itk::StatisticsImageFilter::RealType
typename NumericTraits< PixelType >::RealType RealType
Definition: itkStatisticsImageFilter.h:84
itk::StatisticsImageFilter::IndexType
typename TInputImage::IndexType IndexType
Definition: itkStatisticsImageFilter.h:77
itk::StatisticsImageFilter::SizeType
typename TInputImage::SizeType SizeType
Definition: itkStatisticsImageFilter.h:76
itk::ProcessObject::DataObjectIdentifierType
DataObject::DataObjectIdentifierType DataObjectIdentifierType
Definition: itkProcessObject.h:161
itk::StreamingProcessObject
Base class interface to process data on multiple requested input chunks.
Definition: itkStreamingProcessObject.h:40
itk::ImageSink::InputImagePointer
typename InputImageType::Pointer InputImagePointer
Definition: itkImageSink.h:74
itk::GTest::TypedefsAndConstructors::Dimension2::SizeType
ImageBaseType::SizeType SizeType
Definition: itkGTestTypedefsAndConstructors.h:49
itk::StatisticsImageFilter::m_Mutex
std::mutex m_Mutex
Definition: itkStatisticsImageFilter.h:174
itk::SmartPointer< Self >
itk::Indent
Control indentation during Print() invocation.
Definition: itkIndent.h:49
itkCompensatedSummation.h
itk::StatisticsImageFilter::RegionType
typename TInputImage::RegionType RegionType
Definition: itkStatisticsImageFilter.h:75
itk::GTest::TypedefsAndConstructors::Dimension2::IndexType
ImageBaseType::IndexType IndexType
Definition: itkGTestTypedefsAndConstructors.h:50
itk::ImageToImageFilter
Base class for filters that take an image as input and produce an image as output.
Definition: itkImageToImageFilter.h:108
itkImageSink.h
itk::StatisticsImageFilter::GetNumberOfStreamDivisions
unsigned int GetNumberOfStreamDivisions() const override
Definition: itkStatisticsImageFilter.h:122
itk::GTest::TypedefsAndConstructors::Dimension2::RegionType
ImageBaseType::RegionType RegionType
Definition: itkGTestTypedefsAndConstructors.h:54
itk::StatisticsImageFilter::SetNumberOfStreamDivisions
void SetNumberOfStreamDivisions(const unsigned int n) override
Definition: itkStatisticsImageFilter.h:117
itk::NumericTraits
Define additional traits for native types such as int or float.
Definition: itkNumericTraits.h:58
itkArray.h
itk::StatisticsImageFilter::PixelType
typename TInputImage::PixelType PixelType
Definition: itkStatisticsImageFilter.h:78
itkConceptMacro
#define itkConceptMacro(name, concept)
Definition: itkConceptChecking.h:65
itk
The "itk" namespace contains all Insight Segmentation and Registration Toolkit (ITK) classes....
Definition: itkAnnulusOperator.h:24
itk::StatisticsImageFilter
Compute min, max, variance and mean of an Image.
Definition: itkStatisticsImageFilter.h:55
itkNumericTraits.h
itkSimpleDataObjectDecorator.h
itk::DataObject::Pointer
SmartPointer< Self > Pointer
Definition: itkDataObject.h:301
itk::ImageSink
Definition: itkImageSink.h:53
itk::SizeValueType
unsigned long SizeValueType
Definition: itkIntTypes.h:83
itk::ImageSink::DataObjectIdentifierType
typename Superclass::DataObjectIdentifierType DataObjectIdentifierType
Definition: itkImageSink.h:82