IPSDK  4_1_0_2
IPSDK : Image Processing Software Development Kit
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
ipsdk::imaproc::classif::PCAReductionImgLvl1 Class Reference

Level 1 algorithm: Applies PCA to a sequence image to reduce its dimensionality. More...

#include <PCAReductionImgLvl1.h>

Inheritance diagram for ipsdk::imaproc::classif::PCAReductionImgLvl1:
ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >

Public Member Functions

 ~PCAReductionImgLvl1 ()
 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::InHomogeneousImgget () const
 Getter for attribute InHomogeneousImg.
 
template<>
void set (const typename ipsdk::imaproc::attr::InHomogeneousImg::StorageType &value)
 Setter for attribute InHomogeneousImg.
 
template<>
const ipsdk::imaproc::attr::InOptSingleGreyMaskImgget () const
 Getter for attribute InOptSingleGreyMaskImg.
 
template<>
void set (const typename ipsdk::imaproc::attr::InOptSingleGreyMaskImg::StorageType &value)
 Setter for attribute InOptSingleGreyMaskImg.
 
template<>
const ipsdk::imaproc::attr::InOptPCAReductionParamsget () const
 Getter for attribute InOptPCAReductionParams.
 
template<>
void set (const typename ipsdk::imaproc::attr::InOptPCAReductionParams::StorageType &value)
 Setter for attribute InOptPCAReductionParams.
 
template<>
const ipsdk::imaproc::attr::OutOptSeqImgget () const
 Getter for attribute OutOptSeqImg.
 
template<>
void set (const typename ipsdk::imaproc::attr::OutOptSeqImg::StorageType &value)
 Setter for attribute OutOptSeqImg.
 
template<>
const ipsdk::imaproc::attr::OutPCAEigenValuesget () const
 Getter for attribute OutPCAEigenValues.
 
template<>
void set (const typename ipsdk::imaproc::attr::OutPCAEigenValues::StorageType &value)
 Setter for attribute OutPCAEigenValues.
 
template<>
const ipsdk::imaproc::attr::OutPCAEigenVectorsget () const
 Getter for attribute OutPCAEigenVectors.
 
template<>
void set (const typename ipsdk::imaproc::attr::OutPCAEigenVectors::StorageType &value)
 Setter for attribute OutPCAEigenVectors.
 
template<>
const ipsdk::imaproc::attr::OutPCAMatrixRankget () const
 Getter for attribute OutPCAMatrixRank.
 
template<>
void set (const typename ipsdk::imaproc::attr::OutPCAMatrixRank::StorageType &value)
 Setter for attribute OutPCAMatrixRank.
 
- Public Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
virtual eProcessorType getProcessorType () const =0
 
BoolResult init (const eProcessorRulePolicy rulePolicy=eProcessorRulePolicy::ePRP_DisableSubRules)
 
const eProcessorRulePolicygetProcessorRulePolicy () const
 
std::string getFullInfoStr () const
 
const BaseRulegetGlobalRule () const
 
const ProcessorDispatchPolicygetDispatchPolicy () 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 BaseDataItemgetHeaderItem (const std::string &key) const
 
BaseDataItemgetHeaderItem (const std::string &key)
 
const BaseDataItemgetHeaderItem (const std::string &key) const
 
BaseDataItemgetHeaderItem (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 BaseAttributegetAttribute (ipUInt32 index) const
 
BaseAttributegetAttribute (ipUInt32 index)
 
const BaseAttributegetAttribute (const std::string &attributeName) const
 
BaseAttributegetAttribute (const std::string &attributeName)
 
const BaseAttributegetAttribute (ipUInt32 index) const
 
BaseAttributegetAttribute (ipUInt32 index)
 
const BaseAttributegetAttribute (const std::string &attributeName) const
 
BaseAttributegetAttribute (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 BaseOutputInitializergetOutputInitializer (const std::string &attributeName) const
 
const BaseOutputInitializergetOutputInitializer (const std::string &attributeName) const
 

Static Public Member Functions

static boost::shared_ptr< PCAReductionImgLvl1createProcessor ()
 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

 PCAReductionImgLvl1 ()
 constructor
 
ipsdk::processor::RetrievalResult retrieveFirstProvider (const ipsdk::core::BasePriority &priority, ipsdk::core::ActionProviderPtr &pProvider)
 method allowing to retrieve first provider associated to asynchronous processing in derived class More...
 
ipsdk::processor::RetrievalResult retrieveSecondProvider (const ipsdk::core::BasePriority &priority, ipsdk::core::ActionProviderPtr &pProvider)
 method allowing to retrieve second 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)
 
- Protected Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
virtual BoolResult initDerived (AttributeColl &attributeColl, OutputInitializerColl &outputInitializerColl, ProcessorDispatchPolicy &dispatchPolicy, RulePtr &pGlobalRule, const eProcessorRulePolicy &rulePolicy)=0
 

Protected Attributes

boost::shared_ptr< PCADecompositionLvl1 > _pDecompositionProcessor
 
Attribute members
boost::shared_ptr< ipsdk::imaproc::attr::InHomogeneousImg_pInHomogeneousImg
 
boost::shared_ptr< ipsdk::imaproc::attr::InOptSingleGreyMaskImg_pInOptSingleGreyMaskImg
 
boost::shared_ptr< ipsdk::imaproc::attr::InOptPCAReductionParams_pInOptPCAReductionParams
 
boost::shared_ptr< ipsdk::imaproc::attr::OutOptSeqImg_pOutOptSeqImg
 
boost::shared_ptr< ipsdk::imaproc::attr::OutPCAEigenValues_pOutPCAEigenValues
 
boost::shared_ptr< ipsdk::imaproc::attr::OutPCAEigenVectors_pOutPCAEigenVectors
 
boost::shared_ptr< ipsdk::imaproc::attr::OutPCAMatrixRank_pOutPCAMatrixRank
 
- Protected Attributes inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
eProcessorProgressAvailability _processorProgressAvailability
 
ipUInt32 _nbIter
 

Additional Inherited Members

- Protected Types inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
typedef std::vector< AttributePtrAttributeColl
 
typedef std::map< std::string, OutputInitializerPtrOutputInitializerColl
 

Detailed Description

Level 1 algorithm: Applies PCA to a sequence image to reduce its dimensionality.

See Image dimensionality reduction using PCA for a complete algorithm description.

Author
H. Delestre
Date
2017/06/02

Algorithm associated library :

IPSDKIPLClassification

Attribute description for algorithm :

Name ToolTip Default Initializer
ipsdk::imaproc::attr::InHomogeneousImg [Input] Homogeneous image X
ipsdk::imaproc::attr::InOptSingleGreyMaskImg [Input Optional] Binary image for masking operation for each (x, y, z) coordinate regardless to (c, t) coordinates X
ipsdk::imaproc::attr::InOptPCAReductionParams [Input Optional] Parameters for sequence image dimensionality reduction using a PCA X
ipsdk::imaproc::attr::OutOptSeqImg [Output Optional] sequence image for processing operation X
ipsdk::imaproc::attr::OutPCAEigenValues [Output] Eigen values of matrix computed for PCA ipsdk::processor::allocate (_pOutPCAEigenValues)
ipsdk::imaproc::attr::OutPCAEigenVectors [Output] Eigen vectors of matrix computed for PCA ipsdk::processor::allocate (_pOutPCAEigenVectors)
ipsdk::imaproc::attr::OutPCAMatrixRank [Output] Rank of the matrix computed in PCA X

Global attributes rule :

Global rule on attributes is given by
ipsdk::processor::ifIsSet (_pOutOptSeqImg,
 ipsdk::imaproc::matchSize (eMatchImageSizeType::eMIST_3d,_pInHomogeneousImg,_pOutOptSeqImg) && 
 ipsdk::processor::If (
  ipsdk::processor::isSet (_pInOptPCAReductionParams), ipsdk::processor::isEqual<attr::PCAReductionParams::Criterion>(_pInOptPCAReductionParams,attr::ePCAReductionCriterion::ePCARC_ExpectedNbEltsInSequence) && matchSize<attr::PCAReductionParams::NbExpectedElementsInSequence>(eMatchImageSizeType::eMIST_T,eMatchImageSizeScale::eMISS_FullSize,_pOutOptSeqImg,_pInOptPCAReductionParams),
  img1SizeTLowerEqualImg2SizeCSizeTProduct (_pInHomogeneousImg,_pOutOptSeqImg))) && 
ipsdk::processor::If (
 ipsdk::processor::isSet (_pInOptPCAReductionParams) && ipsdk::processor::isEqual<attr::PCAReductionParams::Criterion>(_pInOptPCAReductionParams,attr::ePCAReductionCriterion::ePCARC_ExpectedNbEltsInSequence),
 expectedEltInOutSeqLowerEqualInImgSizeCSizeTProduct (_pInHomogeneousImg,_pInOptPCAReductionParams),
 ipsdk::processor::none ()) && 
ipsdk::processor::ifIsSet (_pInOptSingleGreyMaskImg,
 ipsdk::imaproc::matchSize (eMatchImageSizeType::eMIST_3d,_pInHomogeneousImg,_pInOptSingleGreyMaskImg))

Member Function Documentation

◆ getStorage()

template<typename TAttribute >
TAttribute::StorageType ipsdk::imaproc::classif::PCAReductionImgLvl1::getStorage ( )

retrieve storage associated to a given attribute

Note
This method is only available for Output and In/Out attributes
Exceptions
ipsdk::processor::IPSDKBaseProcessingExceptionif isInit() == false

◆ retrieveFirstProvider()

ipsdk::processor::RetrievalResult ipsdk::imaproc::classif::PCAReductionImgLvl1::retrieveFirstProvider ( const ipsdk::core::BasePriority priority,
ipsdk::core::ActionProviderPtr pProvider 
)
protected

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

Returns
provider retrieval result.
Note
On success provider pointer must not be null nor uninitialized

◆ retrieveSecondProvider()

ipsdk::processor::RetrievalResult ipsdk::imaproc::classif::PCAReductionImgLvl1::retrieveSecondProvider ( const ipsdk::core::BasePriority priority,
ipsdk::core::ActionProviderPtr pProvider 
)
protected

method allowing to retrieve second 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: