Level 1 algorithm: adjust image dynamic range from a reference using histograms matching. More...

#include <MatchHistograms2dImgLvl1.h>

Inheritance diagram for ipsdk::imaproc::itrans::MatchHistograms2dImgLvl1:

Public Member Functions
	~MatchHistograms2dImgLvl1 ()
	destructor

const std::string &	getObjectName () const
	method allowing to retrieve object name

const std::string &	getToolTip () const
	method allowing to retrieve object tooltip

const boost::filesystem::path	getHeaderPath () const
	retrieve relative header path associated to processor

const std::string	getLibraryName () const
	retrieve library name associated processor

template<typename TAttribute >
TAttribute::StorageType	getStorage ()
	retrieve storage associated to a given attribute More...

Attribute accessors
Setters and Getters for attributes
template<>
const ipsdk::imaproc::attr::InImg &	get () const
	Getter for attribute InImg.

template<>
void	set (const typename ipsdk::imaproc::attr::InImg::StorageType &value)
	Setter for attribute InImg.

template<>
const ipsdk::imaproc::attr::InOptRefImg &	get () const
	Getter for attribute InOptRefImg.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptRefImg::StorageType &value)
	Setter for attribute InOptRefImg.

template<>
const ipsdk::imaproc::attr::InOptPIRefHistogram &	get () const
	Getter for attribute InOptPIRefHistogram.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptPIRefHistogram::StorageType &value)
	Setter for attribute InOptPIRefHistogram.

template<>
const ipsdk::imaproc::attr::InOptPIHistoMsrParams &	get () const
	Getter for attribute InOptPIHistoMsrParams.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptPIHistoMsrParams::StorageType &value)
	Setter for attribute InOptPIHistoMsrParams.

template<>
const ipsdk::imaproc::attr::OutImg &	get () const
	Getter for attribute OutImg.

template<>
void	set (const typename ipsdk::imaproc::attr::OutImg::StorageType &value)
	Setter for attribute OutImg.

Public Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseRepeatedAsync1Action >
virtual eProcessorType	getProcessorType () const =0

BoolResult	init (const eProcessorRulePolicy rulePolicy=eProcessorRulePolicy::ePRP_DisableSubRules)

const eProcessorRulePolicy &	getProcessorRulePolicy () const

std::string	getFullInfoStr () const

const BaseRule &	getGlobalRule () const

const ProcessorDispatchPolicy &	getDispatchPolicy () const

void	restrictDispatchPolicy (const ProcessorDispatchPolicy &policy)

bool	isProgressAvailable () const

ipsdk::processor::eProcessorProgressAvailability	getProgressAvailability () const

ipsdk::ipUInt64	getTotalNbIterations () const

bool	existsHeaderKey (const std::string &key) const

bool	existsHeaderKey (const std::string &key) const

ItemNames	getHeaderKeys () const

ItemNames	getHeaderKeys () const

const BaseDataItem &	getHeaderItem (const std::string &key) const

BaseDataItem &	getHeaderItem (const std::string &key)

const BaseDataItem &	getHeaderItem (const std::string &key) const

BaseDataItem &	getHeaderItem (const std::string &key)

void	addHeaderItem (const std::string &key, const DataItemPtr &pItem)

void	addHeaderItem (const std::string &key, const DataItemPtr &pItem)

void	removeHeaderItem (const std::string &key)

void	removeHeaderItem (const std::string &key)

void	clearHeader ()

void	clearHeader ()

ipUInt32	getNbAttributes () const

ipUInt32	getNbAttributes () const

const BaseAttribute &	getAttribute (ipUInt32 index) const

BaseAttribute &	getAttribute (ipUInt32 index)

const BaseAttribute &	getAttribute (const std::string &attributeName) const

BaseAttribute &	getAttribute (const std::string &attributeName)

const BaseAttribute &	getAttribute (ipUInt32 index) const

BaseAttribute &	getAttribute (ipUInt32 index)

const BaseAttribute &	getAttribute (const std::string &attributeName) const

BaseAttribute &	getAttribute (const std::string &attributeName)

bool	existsAttribute (const std::string &attributeName) const

bool	existsAttribute (const std::string &attributeName) const

StringVector	getAttributeNameColl () const

StringVector	getAttributeNameColl () const

bool	hasOutputInitializer (const std::string &attributeName) const

bool	hasOutputInitializer (const std::string &attributeName) const

const BaseOutputInitializer &	getOutputInitializer (const std::string &attributeName) const

const BaseOutputInitializer &	getOutputInitializer (const std::string &attributeName) const

Static Public Member Functions
static boost::shared_ptr< MatchHistograms2dImgLvl1 >	createProcessor ()
	processor creation function

static const std::string &	getObjectNameStr ()
	method allowing to retrieve object name

static const std::string &	getToolTipStr ()
	method allowing to retrieve object tooltip

static const boost::filesystem::path	getHeaderPathStr ()
	retrieve relative header path associated to processor

static const std::string	getLibraryNameStr ()
	retrieve library name associated processor

Protected Member Functions
	MatchHistograms2dImgLvl1 ()
	constructor

ipsdk::processor::RetrievalResult	retrieveProvider (const ipsdk::core::BasePriority &priority, ipsdk::ipUInt32 curNbIter, ipsdk::core::ActionProviderPtr &pProvider)
	method allowing to retrieve provider associated to asynchronous processing in derived class More...

processor::RetrievalResult	provideProcessor (const boost::shared_ptr< core::BaseAction > &pProcessor, const core::BasePriority &priority, core::ActionProviderPtr &pProvider)

processor::RetrievalResult	histoMsr (const core::BasePriority &priority, core::ActionProviderPtr &pProvider, const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::PlanIndexedHistogramDataPtr &pPIHisto, bool bIgnoreHistoMsrParams)

processor::RetrievalResult	matchHisto (const core::BasePriority &priority, core::ActionProviderPtr &pProvider)

processor::RetrievalResult	lutTransform (const core::BasePriority &priority, core::ActionProviderPtr &pProvider)

Protected Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseRepeatedAsync1Action >
virtual BoolResult	initDerived (AttributeColl &attributeColl, OutputInitializerColl &outputInitializerColl, ProcessorDispatchPolicy &dispatchPolicy, RulePtr &pGlobalRule, const eProcessorRulePolicy &rulePolicy)=0

Protected Attributes
attr::PlanIndexedIntensityLUTPtr	_pLut
	Intermediate results.

attr::PlanIndexedHistogramDataPtr	_pRefHisto

attr::PlanIndexedHistogramDataPtr	_pInHisto

Attribute members
boost::shared_ptr< ipsdk::imaproc::attr::InImg >	_pInImg

boost::shared_ptr< ipsdk::imaproc::attr::InOptRefImg >	_pInOptRefImg

boost::shared_ptr< ipsdk::imaproc::attr::InOptPIRefHistogram >	_pInOptPIRefHistogram

boost::shared_ptr< ipsdk::imaproc::attr::InOptPIHistoMsrParams >	_pInOptPIHistoMsrParams

boost::shared_ptr< ipsdk::imaproc::attr::OutImg >	_pOutImg

Protected Attributes inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseRepeatedAsync1Action >
eProcessorProgressAvailability	_processorProgressAvailability

ipUInt32	_nbIter

Additional Inherited Members
Protected Types inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseRepeatedAsync1Action >
typedef std::vector< AttributePtr >	AttributeColl

typedef std::map< std::string, OutputInitializerPtr >	OutputInitializerColl

Detailed Description

Level 1 algorithm: adjust image dynamic range from a reference using histograms matching.

See Image Histograms Matching 2d for a complete algorithm description.

Author: H. Delestre

Date: 2017/06/14

Copyright: 2017 Reactiv'IP, all right reserved.

Algorithm associated library :

IPSDKIPLIntensityTransform

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InOptRefImg	[Input Optional] reference image	X
ipsdk::imaproc::attr::InOptPIRefHistogram	[Input] Plan indexed collection of reference histograms	X
ipsdk::imaproc::attr::InOptPIHistoMsrParams	[Input] Plan indexed collection of histogram measure parameters	X
ipsdk::imaproc::attr::OutImg	[Output] image for processing operation	ipsdk::imaproc::duplicateInOut (_pOutImg, _pInImg)

Global attributes rule :

Global rule on attributes is given by
ipsdk::imaproc::matchSize (_pInImg,_pOutImg) &&
ipsdk::processor::If (
ipsdk::processor::isSet (_pInOptRefImg),
ipsdk::processor::Not (
  ipsdk::processor::isSet (_pInOptPIRefHistogram)) &&
((ipsdk::imaproc::is2d (_pInOptRefImg) &&
   ipsdk::imaproc::isGrey (_pInOptRefImg) &&
   ipsdk::imaproc::isSingle (_pInOptRefImg)) ||
  ipsdk::imaproc::matchSize (eMatchImageSizeType::eMIST_ZCT,_pInImg,_pInOptRefImg)),
ipsdk::processor::isSet (_pInOptPIRefHistogram) &&
((ipsdk::imaproc::is2d (_pInOptPIRefHistogram) &&
   ipsdk::imaproc::isGrey (_pInOptPIRefHistogram) &&
   ipsdk::imaproc::isSingle (_pInOptPIRefHistogram)) ||
  ipsdk::imaproc::matchImagePlans (_pInOptPIRefHistogram,_pInImg,eImagePlansMatchPolicy::eIPMP_ZCT))) &&
ipsdk::processor::ifIsSet (
_pInOptPIHistoMsrParams, (
  (ipsdk::imaproc::is2d (_pInOptPIHistoMsrParams) &&
   ipsdk::imaproc::isGrey (_pInOptPIHistoMsrParams) &&
   ipsdk::imaproc::isSingle (_pInOptPIHistoMsrParams)) ||
  ipsdk::imaproc::matchImagePlans (_pInOptPIHistoMsrParams,_pInImg,eImagePlansMatchPolicy::eIPMP_ZCT)))

Member Function Documentation

◆ getStorage()

template<typename TAttribute >

TAttribute::StorageType ipsdk::imaproc::itrans::MatchHistograms2dImgLvl1::getStorage ( )

retrieve storage associated to a given attribute

Note: This method is only available for Output and In/Out attributes

Exceptions

ipsdk::processor::IPSDKBaseProcessingException if isInit() == false

◆ retrieveProvider()

ipsdk::processor::RetrievalResult ipsdk::imaproc::itrans::MatchHistograms2dImgLvl1::retrieveProvider	(	const ipsdk::core::BasePriority &	priority,
		ipsdk::ipUInt32	curNbIter,
		ipsdk::core::ActionProviderPtr &	pProvider
	)

protected

method allowing to retrieve provider associated to asynchronous processing in derived class

Returns: provider retrieval result.

Note: On success provider pointer must not be null nor uninitialized

The documentation for this class was generated from the following file:

/media/reactivipdev/Nightly/IPSDK_Patch/IPSDK_4_1/IPSDK_Nightly/include/public/IPSDKIPL/IPSDKIPLIntensityTransform/Processor/MatchHistograms2dImg/MatchHistograms2dImgLvl1.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes