OpenCV 4.5.3(日本語機械翻訳)
retina.hpp
[詳解]
1 /*#******************************************************************************
2 ** IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
3 **
4 ** By downloading, copying, installing or using the software you agree to this license.
5 ** If you do not agree to this license, do not download, install,
6 ** copy or use the software.
7 **
8 **
9 ** bioinspired : interfaces allowing OpenCV users to integrate Human Vision System models. Presented models originate from Jeanny Herault's original research and have been reused and adapted by the author&collaborators for computed vision applications since his thesis with Alice Caplier at Gipsa-Lab.
10 ** Use: extract still images & image sequences features, from contours details to motion spatio-temporal features, etc. for high level visual scene analysis. Also contribute to image enhancement/compression such as tone mapping.
11 **
12 ** Maintainers : Listic lab (code author current affiliation & applications) and Gipsa Lab (original research origins & applications)
13 **
14 ** Creation - enhancement process 2007-2015
15 ** Author: Alexandre Benoit (benoit.alexandre.vision@gmail.com), LISTIC lab, Annecy le vieux, France
16 **
17 ** Theses algorithm have been developped by Alexandre BENOIT since his thesis with Alice Caplier at Gipsa-Lab (www.gipsa-lab.inpg.fr) and the research he pursues at LISTIC Lab (www.listic.univ-savoie.fr).
18 ** Refer to the following research paper for more information:
19 ** Benoit A., Caplier A., Durette B., Herault, J., "USING HUMAN VISUAL SYSTEM MODELING FOR BIO-INSPIRED LOW LEVEL IMAGE PROCESSING", Elsevier, Computer Vision and Image Understanding 114 (2010), pp. 758-773, DOI: http://dx.doi.org/10.1016/j.cviu.2010.01.011
20 ** This work have been carried out thanks to Jeanny Herault who's research and great discussions are the basis of all this work, please take a look at his book:
21 ** Vision: Images, Signals and Neural Networks: Models of Neural Processing in Visual Perception (Progress in Neural Processing),By: Jeanny Herault, ISBN: 9814273686. WAPI (Tower ID): 113266891.
22 **
23 ** The retina filter includes the research contributions of phd/research collegues from which code has been redrawn by the author :
24 ** _take a look at the retinacolor.hpp module to discover Brice Chaix de Lavarene color mosaicing/demosaicing and the reference paper:
25 ** ====> B. Chaix de Lavarene, D. Alleysson, B. Durette, J. Herault (2007). "Efficient demosaicing through recursive filtering", IEEE International Conference on Image Processing ICIP 2007
26 ** _take a look at imagelogpolprojection.hpp to discover retina spatial log sampling which originates from Barthelemy Durette phd with Jeanny Herault. A Retina / V1 cortex projection is also proposed and originates from Jeanny's discussions.
27 ** ====> more informations in the above cited Jeanny Heraults's book.
28 **
29 ** License Agreement
30 ** For Open Source Computer Vision Library
31 **
32 ** Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
33 ** Copyright (C) 2008-2011, Willow Garage Inc., all rights reserved.
34 **
35 ** For Human Visual System tools (bioinspired)
36 ** Copyright (C) 2007-2015, LISTIC Lab, Annecy le Vieux and GIPSA Lab, Grenoble, France, all rights reserved.
37 **
38 ** Third party copyrights are property of their respective owners.
39 **
40 ** Redistribution and use in source and binary forms, with or without modification,
41 ** are permitted provided that the following conditions are met:
42 **
43 ** * Redistributions of source code must retain the above copyright notice,
44 ** this list of conditions and the following disclaimer.
45 **
46 ** * Redistributions in binary form must reproduce the above copyright notice,
47 ** this list of conditions and the following disclaimer in the documentation
48 ** and/or other materials provided with the distribution.
49 **
50 ** * The name of the copyright holders may not be used to endorse or promote products
51 ** derived from this software without specific prior written permission.
52 **
53 ** This software is provided by the copyright holders and contributors "as is" and
54 ** any express or implied warranties, including, but not limited to, the implied
55 ** warranties of merchantability and fitness for a particular purpose are disclaimed.
56 ** In no event shall the Intel Corporation or contributors be liable for any direct,
57 ** indirect, incidental, special, exemplary, or consequential damages
58 ** (including, but not limited to, procurement of substitute goods or services;
59 ** loss of use, data, or profits; or business interruption) however caused
60 ** and on any theory of liability, whether in contract, strict liability,
61 ** or tort (including negligence or otherwise) arising in any way out of
62 ** the use of this software, even if advised of the possibility of such damage.
63 *******************************************************************************/
64
65 #ifndef __OPENCV_BIOINSPIRED_RETINA_HPP__
66 #define __OPENCV_BIOINSPIRED_RETINA_HPP__
67
74 #include "opencv2/core.hpp" // for all OpenCV core functionalities access, including cv::Exception support
75
76
77 namespace cv{
78 namespace bioinspired{
79
82
83 enum {
84 RETINA_COLOR_RANDOM,
85 RETINA_COLOR_DIAGONAL,
86 RETINA_COLOR_BAYER
87 };
88
89
149 struct RetinaParameters{
151 struct OPLandIplParvoParameters{
152 OPLandIplParvoParameters():colorMode(true),
153 normaliseOutput(true),
154 photoreceptorsLocalAdaptationSensitivity(0.75f),
155 photoreceptorsTemporalConstant(0.9f),
156 photoreceptorsSpatialConstant(0.53f),
157 horizontalCellsGain(0.01f),
158 hcellsTemporalConstant(0.5f),
159 hcellsSpatialConstant(7.f),
160 ganglionCellsSensitivity(0.75f) { } // default setup
161 bool colorMode, normaliseOutput;
162 float photoreceptorsLocalAdaptationSensitivity, photoreceptorsTemporalConstant, photoreceptorsSpatialConstant, horizontalCellsGain, hcellsTemporalConstant, hcellsSpatialConstant, ganglionCellsSensitivity;
163 };
165 struct IplMagnoParameters{
166 IplMagnoParameters():
167 normaliseOutput(true),
168 parasolCells_beta(0.f),
169 parasolCells_tau(0.f),
170 parasolCells_k(7.f),
171 amacrinCellsTemporalCutFrequency(2.0f),
172 V0CompressionParameter(0.95f),
173 localAdaptintegration_tau(0.f),
174 localAdaptintegration_k(7.f) { } // default setup
175 bool normaliseOutput;
176 float parasolCells_beta, parasolCells_tau, parasolCells_k, amacrinCellsTemporalCutFrequency, V0CompressionParameter, localAdaptintegration_tau, localAdaptintegration_k;
177 };
178 OPLandIplParvoParameters OPLandIplParvo;
179 IplMagnoParameters IplMagno;
180 };
181
182
183
207 class CV_EXPORTS_W Retina : public Algorithm {
208
209 public:
210
211
215 CV_WRAP virtual Size getInputSize()=0;
216
221 CV_WRAP virtual Size getOutputSize()=0;
222
233 CV_WRAP virtual void setup(String retinaParameterFile="", const bool applyDefaultSetupOnFailure=true)=0;
234
239 virtual void setup(cv::FileStorage &fs, const bool applyDefaultSetupOnFailure=true)=0;
240
244 virtual void setup(RetinaParameters newParameters)=0;
245
249 virtual RetinaParameters getParameters()=0;
250
254 CV_WRAP virtual const String printSetup()=0;
255
260 CV_WRAP virtual void write( String fs ) const=0;
261
263 virtual void write( FileStorage& fs ) const CV_OVERRIDE = 0;
264
299 CV_WRAP virtual void setupOPLandIPLParvoChannel(const bool colorMode=true, const bool normaliseOutput = true, const float photoreceptorsLocalAdaptationSensitivity=0.7f, const float photoreceptorsTemporalConstant=0.5f, const float photoreceptorsSpatialConstant=0.53f, const float horizontalCellsGain=0.f, const float HcellsTemporalConstant=1.f, const float HcellsSpatialConstant=7.f, const float ganglionCellsSensitivity=0.7f)=0;
300
326 CV_WRAP virtual void setupIPLMagnoChannel(const bool normaliseOutput = true, const float parasolCells_beta=0.f, const float parasolCells_tau=0.f, const float parasolCells_k=7.f, const float amacrinCellsTemporalCutFrequency=1.2f, const float V0CompressionParameter=0.95f, const float localAdaptintegration_tau=0.f, const float localAdaptintegration_k=7.f)=0;
327
335 CV_WRAP virtual void run(InputArray inputImage)=0;
336
353 CV_WRAP virtual void applyFastToneMapping(InputArray inputImage, OutputArray outputToneMappedImage)=0;
354
367 CV_WRAP virtual void getParvo(OutputArray retinaOutput_parvo)=0;
368
372 CV_WRAP virtual void getParvoRAW(OutputArray retinaOutput_parvo)=0;
373
384 CV_WRAP virtual void getMagno(OutputArray retinaOutput_magno)=0;
385
389 CV_WRAP virtual void getMagnoRAW(OutputArray retinaOutput_magno)=0;
390
392 CV_WRAP virtual const Mat getMagnoRAW() const=0;
394 CV_WRAP virtual const Mat getParvoRAW() const=0;
395
402 CV_WRAP virtual void setColorSaturation(const bool saturateColors=true, const float colorSaturationValue=4.0f)=0;
403
409 CV_WRAP virtual void clearBuffers()=0;
410
416 CV_WRAP virtual void activateMovingContoursProcessing(const bool activate)=0;
417
424 CV_WRAP virtual void activateContoursProcessing(const bool activate)=0;
425
427 CV_WRAP static Ptr<Retina> create(Size inputSize);
444 CV_WRAP static Ptr<Retina> create(Size inputSize, const bool colorMode,
445 int colorSamplingMethod=RETINA_COLOR_BAYER,
446 const bool useRetinaLogSampling=false,
447 const float reductionFactor=1.0f, const float samplingStrength=10.0f);
448};
449
451
452}
453}
454 #endif /* __OPENCV_BIOINSPIRED_RETINA_HPP__ */
cv::_OutputArray
This type is very similar to InputArray except that it is used for input/output and output function p...
Definition: mat.hpp:295
cv::Algorithm
This is a base class for all more or less complex algorithms in OpenCV
Definition: core.hpp:3091
cv::FileStorage
XML/YAML/JSON file storage class that encapsulates all the information necessary for writing or readi...
Definition: persistence.hpp:304
cv::Mat
n-dimensional dense array class
Definition: mat.hpp:802
cv::Size_
Template class for specifying the size of an image or rectangle.
Definition: core/types.hpp:316
cv::bioinspired::Retina
class which allows the Gipsa/Listic Labs model to be used with OpenCV.
Definition: retina.hpp:207
cv::bioinspired::Retina::setup
virtual void setup(cv::FileStorage &fs, const bool applyDefaultSetupOnFailure=true)=0
cv::bioinspired::Retina::setup
virtual void setup(RetinaParameters newParameters)=0
cv::bioinspired::Retina::getParameters
virtual RetinaParameters getParameters()=0
cv::bioinspired::Retina::write
virtual void write(FileStorage &fs) const CV_OVERRIDE=0
cv::bioinspired::RETINA_COLOR_RANDOM
@ RETINA_COLOR_RANDOM
each pixel position is either R, G or B in a random choice
Definition: retina.hpp:84
cv::bioinspired::RETINA_COLOR_BAYER
@ RETINA_COLOR_BAYER
standard bayer sampling
Definition: retina.hpp:86
cv::bioinspired::RETINA_COLOR_DIAGONAL
@ RETINA_COLOR_DIAGONAL
color sampling is RGBRGBRGB..., line 2 BRGBRGBRG..., line 3, GBRGBRGBR...
Definition: retina.hpp:85
cv
"black box" representation of the file storage associated with a file on disk.
Definition: aruco.hpp:75
cv::Ptr
Definition: cvstd_wrapper.hpp:74
cv::bioinspired::RetinaParameters::IplMagnoParameters
Inner Plexiform Layer Magnocellular channel (IplMagno)
Definition: retina.hpp:165
cv::bioinspired::RetinaParameters::OPLandIplParvoParameters
Outer Plexiform Layer (OPL) and Inner Plexiform Layer Parvocellular (IplParvo) parameters
Definition: retina.hpp:151
cv::bioinspired::RetinaParameters
retina model parameters structure
Definition: retina.hpp:149
構築: doxygen 1.9.2