transientareassegmentationmodule.hpp

[詳解]

/*#******************************************************************************





** IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.





**





** By downloading, copying, installing or using the software you agree to this license.





** If you do not agree to this license, do not download, install,





** copy or use the software.





**





**





** bioinspired : interfaces allowing OpenCV users to integrate Human Vision System models.





** TransientAreasSegmentationModule Use: extract areas that present spatio-temporal changes.





** => It should be used at the output of the cv::bioinspired::Retina::getMagnoRAW() output that enhances spatio-temporal changes





**





** Maintainers : Listic lab (code author current affiliation & applications)





**





**  Creation - enhancement process 2007-2015





**      Author: Alexandre Benoit (benoit.alexandre.vision@gmail.com), LISTIC lab, Annecy le vieux, France





**





** 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).





** Refer to the following research paper for more information:





** Strat, S.T.; Benoit, A.; Lambert, P., "Retina enhanced bag of words descriptors for video classification," Signal Processing Conference (EUSIPCO), 2014 Proceedings of the 22nd European , vol., no., pp.1307,1311, 1-5 Sept. 2014 (http://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=6952461&isnumber=6951911)





** 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





** 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:





** 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.





**





**





**                          License Agreement





**               For Open Source Computer Vision Library





**





** Copyright (C) 2000-2008, Intel Corporation, all rights reserved.





** Copyright (C) 2008-2011, Willow Garage Inc., all rights reserved.





**





**               For Human Visual System tools (bioinspired)





** Copyright (C) 2007-2015, LISTIC Lab, Annecy le Vieux and GIPSA Lab, Grenoble, France, all rights reserved.





**





** Third party copyrights are property of their respective owners.





**





** Redistribution and use in source and binary forms, with or without modification,





** are permitted provided that the following conditions are met:





**





** * Redistributions of source code must retain the above copyright notice,





**    this list of conditions and the following disclaimer.





**





** * Redistributions in binary form must reproduce the above copyright notice,





**    this list of conditions and the following disclaimer in the documentation





**    and/or other materials provided with the distribution.





**





** * The name of the copyright holders may not be used to endorse or promote products





**    derived from this software without specific prior written permission.





**





** This software is provided by the copyright holders and contributors "as is" and





** any express or implied warranties, including, but not limited to, the implied





** warranties of merchantability and fitness for a particular purpose are disclaimed.





** In no event shall the Intel Corporation or contributors be liable for any direct,





** indirect, incidental, special, exemplary, or consequential damages





** (including, but not limited to, procurement of substitute goods or services;





** loss of use, data, or profits; or business interruption) however caused





** and on any theory of liability, whether in contract, strict liability,





** or tort (including negligence or otherwise) arising in any way out of





** the use of this software, even if advised of the possibility of such damage.





*******************************************************************************/








#ifndef SEGMENTATIONMODULE_HPP_




#define SEGMENTATIONMODULE_HPP_








#include "opencv2/core.hpp"
// for all OpenCV core functionalities access, including cv::Exception support








namespace

cv



{



namespace
bioinspired


{







struct

SegmentationParameters{
// CV_EXPORTS_W_MAP to export to python native dictionnaries




// default structure instance construction with default values




SegmentationParameters():



thresholdON(100),



thresholdOFF(100),



localEnergy_temporalConstant(0.5),



localEnergy_spatialConstant(5),



neighborhoodEnergy_temporalConstant(1),



neighborhoodEnergy_spatialConstant(15),



contextEnergy_temporalConstant(1),



contextEnergy_spatialConstant(75){};



// all properties list




float
thresholdON;



float
thresholdOFF;



float
localEnergy_temporalConstant;



float
localEnergy_spatialConstant;



float
neighborhoodEnergy_temporalConstant;



float
neighborhoodEnergy_spatialConstant;



float
contextEnergy_temporalConstant;



float
contextEnergy_spatialConstant;


};







class
CV_EXPORTS_W
TransientAreasSegmentationModule:
public
Algorithm



{



public:











CV_WRAP
virtual
Size
getSize()=0;







CV_WRAP
virtual
void
setup(String segmentationParameterFile="",
const
bool
applyDefaultSetupOnFailure=true)=0;







virtual
void
setup(cv::FileStorage
&fs,
const
bool
applyDefaultSetupOnFailure=true)=0;







virtual
void
setup(SegmentationParameters
newParameters)=0;







virtual
SegmentationParameters
getParameters()=0;







CV_WRAP
virtual
const
String printSetup()=0;







CV_WRAP
virtual
void
write( String fs )
const=0;







virtual
void
write(
cv::FileStorage& fs )
const
CV_OVERRIDE = 0;







CV_WRAP
virtual
void
run(InputArray inputToSegment,
const
int
channelIndex=0)=0;







CV_WRAP
virtual
void
getSegmentationPicture(OutputArray
transientAreas)=0;







CV_WRAP
virtual
void
clearAllBuffers()=0;







CV_WRAP
static
Ptr<TransientAreasSegmentationModule>
create(Size
inputSize);


};










}}
// namespaces end : cv and bioinspired












#endif