File: otbComputeGainLutFilter.h

package info (click to toggle)
otb 6.6.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 47,068 kB
  • sloc: cpp: 316,755; ansic: 4,474; sh: 1,610; python: 497; perl: 92; makefile: 82; java: 72
file content (128 lines) | stat: -rw-r--r-- 4,138 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/*
 * Copyright (C) 2005-2017 Centre National d'Etudes Spatiales (CNES)
 *
 * This file is part of Orfeo Toolbox
 *
 *     https://www.orfeo-toolbox.org/
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef otbComputeGainLutFilter_h
#define otbComputeGainLutFilter_h

#include "itkImageToImageFilter.h"
#include "otbImage.h"

namespace otb
{

/** \class ComputeGainLutFilter
 *  \brief Compute the gain for each pixel value from a histogram
 *
 *  This class implements the second part of the CLAHE algorithm. It's aim 
 *  is to compute a look up table filled with gain that need to be applied
 *  on the input to match the target histogram. To keep consistency with 
 *  the other parts of the algorithm it needs the minimum and maximum value
 *  of the input image and also the theorical number of pixel per histogram.
 *
 * \ingroup OTBContrast
 */

template <class TInputImage , class TOutputImage >
class ITK_EXPORT ComputeGainLutFilter :
  public itk::ImageToImageFilter< TInputImage , TOutputImage >
{
public:

  /** typedef for standard classes. */

  typedef TInputImage InputImageType;
  typedef TOutputImage OutputImageType;

  typedef ComputeGainLutFilter Self;
  typedef itk::ImageToImageFilter< InputImageType, OutputImageType > Superclass;
  typedef itk::SmartPointer< Self > Pointer;
  typedef itk::SmartPointer< const Self > ConstPointer;

  typedef typename InputImageType::PixelType HistoType;
  typedef typename OutputImageType::PixelType LutType;
  typedef typename OutputImageType::InternalPixelType OutputPixelType;
  typedef typename OutputImageType::RegionType OutputImageRegionType;

  /** Method for creation through the object factory. */
  itkNewMacro(Self)
  /** Run-time type information (and related methods). */
  itkTypeMacro(ComputeGainLutFilter, ImageToImageFilter)

  /** Get/Set macro to get/set the number of pixel by histogram */
  itkSetMacro(NbPixel, unsigned long)
  itkGetMacro(NbPixel, unsigned long)

  /** Get/Set macro to get/set the minimum value */
  itkSetMacro(Min, double)
  itkGetMacro(Min, double)

  /** Get/Set macro to get/set the maximum value */
  itkSetMacro(Max, double)
  itkGetMacro(Max, double)

protected:
  ComputeGainLutFilter() ;
  ~ComputeGainLutFilter() override {}
  void PrintSelf(std::ostream& os, itk::Indent indent) const override;

  void BeforeThreadedGenerateData() override ;

  void ThreadedGenerateData(
        const OutputImageRegionType & outputRegionForThread ,
        itk::ThreadIdType threadId) override ;

private:
  ComputeGainLutFilter(const Self &) = delete ;
  void operator =(const Self&) = delete ;

  /** Post-process the look up tabe to get a gain instead of a simple value */
  OutputPixelType PostProcess( unsigned int countMapValue ,
                               unsigned int countValue ) ;

  /** Equalized input histogram regarding the target and filling the 
    * corresponding look up table */
  void Equalized( const HistoType & inputHisto ,
                  HistoType & targetHisto ,
                  LutType & lut) ;

  /** Create target depending on the number of pixel in the input histogram */
  void CreateTarget( const HistoType & inputHisto ,
                     HistoType & targetHisto ) ;
  //TODO Give the opportunity to choose the histogram target
  
  /** Check whether the input histogram has enough pixel to be meaningful */
  bool IsValid(const HistoType & inputHisto ) ;

  double m_Min;
  double m_Max;
  double m_Step;
  unsigned int m_NbBin;
  unsigned long m_NbPixel;

};

  // End namespace otb
}

#ifndef OTB_MANUAL_INSTANTIATION
#include "otbComputeGainLutFilter.txx"
#endif

#endif