Family of attribute-based image filtering operators on morphological trees. More...

#include <AttributeFilters.hpp>

Public Member Functions
	AttributeFilters (AltitudeView view)
	Creates filtering operators over a non-owning weighted tree view.

	AttributeFilters (const WeightedMorphologicalTree< T > &weighted)
	Creates filtering operators over an owned weighted tree.

std::vector< bool >	getAdaptiveCriterion (std::vector< bool > &criterion, AltitudeDiff< T > delta)
	Builds an MSER-assisted pruning criterion from an existing keep/reject mask.

std::vector< bool >	getAdaptiveCriterionByDepth (std::vector< bool > &criterion, int depthDelta)
	Builds a depth-stability pruning criterion from an existing mask.

template<std::floating_point Real>
ImagePtr< T >	filteringByPruningMin (const std::shared_ptr< Real[]> &attr, Real threshold)
	Applies pruning-min filtering from an attribute buffer.

template<std::floating_point Real>
ImagePtr< T >	filteringByPruningMin (const Real *attr, Real threshold)
	Applies pruning-min filtering from a raw internal-node attribute buffer.

template<std::floating_point Real>
ImagePtr< T >	filteringByPruningMax (const std::shared_ptr< Real[]> &attr, Real threshold)
	Applies pruning-max filtering from an attribute buffer.

template<std::floating_point Real>
ImagePtr< T >	filteringByPruningMax (const Real *attr, Real threshold)
	Applies pruning-max filtering from a raw internal-node attribute buffer.

template<std::floating_point Real>
ImagePtr< T >	filteringByViterbiRule (const Real *attr, Real threshold)
	Applies Salembier-style Viterbi filtering from a raw attribute buffer.

ImagePtr< T >	filteringByPruningMin (std::vector< bool > &criterion)
	Applies pruning-min filtering from a dense internal-node criterion.

ImagePtr< T >	filteringByPruningMax (std::vector< bool > &criterion)
	Applies pruning-max filtering from a dense internal-node criterion.

ImagePtr< T >	filteringByDirectRule (std::vector< bool > &criterion)
	Applies the direct filtering rule from a dense internal-node criterion.

ImagePtr< T >	filteringBySubtractiveRule (std::vector< bool > &criterion)
	Applies the subtractive filtering rule from a dense internal-node criterion.

ImageFloatPtr	filteringBySubtractiveScoreRule (std::vector< float > &prob)
	Applies the subtractive score rule from dense per-node scores.

Static Public Member Functions
static void	filteringBySubtractiveScoreRule (const WeightedTreeView< T > &weighted, std::vector< float > &prob, ImageFloatPtr imgOutputPtr)
	Writes subtractive-score filtering into a caller-owned output image.

static void	filteringBySubtractiveScoreRule (const WeightedMorphologicalTree< T > &weighted, std::vector< float > &prob, ImageFloatPtr imgOutputPtr)
	Writes subtractive-score filtering from a weighted owner into an output image.

static void	filteringBySubtractiveRule (const WeightedTreeView< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes subtractive-rule filtering into a caller-owned output image.

static void	filteringBySubtractiveRule (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes subtractive-rule filtering from a weighted owner into an output image.

static void	filteringByDirectRule (const WeightedTreeView< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes direct-rule filtering into a caller-owned output image.

static void	filteringByDirectRule (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes direct-rule filtering from a weighted owner into an output image.

static void	filteringByPruningMin (const WeightedTreeView< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from a criterion into an output image.

static void	filteringByPruningMin (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from a weighted owner into an output image.

static void	filteringByPruningMax (const WeightedTreeView< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from a criterion into an output image.

static void	filteringByPruningMax (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from a weighted owner into an output image.

template<std::floating_point Real>
static void	filteringByPruningMin (const WeightedTreeView< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from an owned attribute buffer into an output image.

template<std::floating_point Real>
static void	filteringByPruningMin (const WeightedMorphologicalTree< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from a weighted owner and owned attribute buffer.

template<std::floating_point Real>
static void	filteringByPruningMin (const WeightedTreeView< T > &weighted, const Real *attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from a raw attribute buffer into an output image.

template<std::floating_point Real>
static void	filteringByPruningMin (const WeightedMorphologicalTree< T > &weighted, const Real *attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-min filtering from a weighted owner and raw attribute buffer.

template<std::floating_point Real>
static void	filteringByPruningMax (const WeightedTreeView< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from an owned attribute buffer into an output image.

template<std::floating_point Real>
static void	filteringByPruningMax (const WeightedMorphologicalTree< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from a weighted owner and owned attribute buffer.

template<std::floating_point Real>
static void	filteringByPruningMax (const WeightedTreeView< T > &weighted, const Real *attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from a raw attribute buffer into an output image.

template<std::floating_point Real>
static void	filteringByPruningMax (const WeightedMorphologicalTree< T > &weighted, const Real *attribute, Real threshold, ImagePtr< T > imgOutputPtr)
	Writes pruning-max filtering from a weighted owner and raw attribute buffer.

template<std::floating_point Real>
static std::vector< bool >	getAdaptiveCriterion (const WeightedMorphologicalTree< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, AltitudeDiff< T > delta)
	Builds an MSER-assisted pruning criterion from an attribute threshold.

template<std::floating_point Real>
static std::vector< bool >	getAdaptiveCriterion (const WeightedMorphologicalTree< T > &weighted, const Real *attribute, Real threshold, AltitudeDiff< T > delta)
	Builds an MSER-assisted pruning criterion from a raw attribute buffer.

static std::vector< bool >	getAdaptiveCriterion (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, AltitudeDiff< T > delta)
	Builds an MSER-assisted pruning criterion from an existing criterion mask.

template<std::floating_point Real>
static std::vector< bool >	getAdaptiveCriterionByDepth (const WeightedMorphologicalTree< T > &weighted, const std::shared_ptr< Real[]> &attribute, Real threshold, int depthDelta)
	Builds a depth-stability pruning criterion from an attribute threshold.

template<std::floating_point Real>
static std::vector< bool >	getAdaptiveCriterionByDepth (const WeightedMorphologicalTree< T > &weighted, const Real *attribute, Real threshold, int depthDelta)
	Builds a depth-stability pruning criterion from a raw attribute buffer.

static std::vector< bool >	getAdaptiveCriterionByDepth (const WeightedMorphologicalTree< T > &weighted, std::vector< bool > &criterion, int depthDelta)
	Builds a depth-stability pruning criterion from an existing criterion mask.

Detailed Description

template<AltitudeValue T>
class mmcfilters::AttributeFilters< T >

Family of attribute-based image filtering operators on morphological trees.

AttributeFilters groups the classical reconstruction rules used in this project: direct filtering, subtractive filtering, pruning-based filtering, and a few residual/score-based variants. The operators consume criteria or attribute buffers defined on dense node ids and reconstruct proper-part images as their output.

Contract and node-domain assumptions:

every criterion, score, and attribute buffer is indexed by the dense internal NodeId slot domain, not by exported Higra ids;
only alive nodes are reconstructed, but buffers must still cover every internal slot so callers can reuse the tree-wide attribute layout;
output pixels are written through direct proper-part ownership. A node represents the support of its full subtree, while getProperParts(node) contains only the pixels owned directly by that node;
propagation rules are evaluated in explicit root-to-leaf order because the dense NodeId slot order is not a topological order after Higra import or structural edits;
public object methods snapshot the topology mutation version at construction and reject use after the tree structure changes.

Reconstruction rule summary:

direct rule: a kept node maps to its own altitude; a rejected node inherits the already-filtered level of its parent;
subtractive rule: a kept node adds its altitude residue to the filtered parent level; a rejected node inherits that parent level;
subtractive score rule: each residue is multiplied by a per-node score and accumulated in floating point;
Viterbi rule: a dynamic program chooses a connected preserved set from threshold-derived preserve/remove costs, then reconstructs it with the direct rule;
pruning-min rule: rejected branches are cut immediately and their whole subtree is painted at the current accepted ancestor level;
pruning-max rule: only subtrees whose nodes are all rejected are cut, and such subtrees are painted at the rejected subtree root level.

Definition at line 66 of file AttributeFilters.hpp.

Constructor & Destructor Documentation

◆ AttributeFilters() [1/2]

template<AltitudeValue T>

mmcfilters::AttributeFilters< T >::AttributeFilters ( AltitudeView view )

inlineexplicit

Creates filtering operators over a non-owning weighted tree view.

The view must remain valid for the lifetime of the filter object. Public methods reject use after the underlying topology mutates.

Definition at line 524 of file AttributeFilters.hpp.

◆ AttributeFilters() [2/2]

template<AltitudeValue T>

mmcfilters::AttributeFilters< T >::AttributeFilters ( const WeightedMorphologicalTree< T > & weighted )

inlineexplicit

Creates filtering operators over an owned weighted tree.

This overload keeps a pointer to the owner so methods that require tree-owned altitude state, such as MSER-assisted adaptive criteria, can be used.

Definition at line 538 of file AttributeFilters.hpp.

Member Function Documentation

◆ filteringByDirectRule() [1/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByDirectRule	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes direct-rule filtering from a weighted owner into an output image.

Definition at line 738 of file AttributeFilters.hpp.

◆ filteringByDirectRule() [2/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByDirectRule	(	const WeightedTreeView< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes direct-rule filtering into a caller-owned output image.

Definition at line 731 of file AttributeFilters.hpp.

◆ filteringByDirectRule() [3/3]

template<AltitudeValue T>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByDirectRule ( std::vector< bool > & criterion )

inline

Applies the direct filtering rule from a dense internal-node criterion.

Accepted nodes use their own altitude; rejected nodes inherit the filtered level propagated from their parent.

Definition at line 667 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [1/9]

template<AltitudeValue T>

template<std::floating_point Real>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const Real *	attr,
		Real	threshold
	)

inline

Applies pruning-max filtering from a raw internal-node attribute buffer.

Definition at line 612 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [2/9]

template<AltitudeValue T>

template<std::floating_point Real>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const std::shared_ptr< Real[]> &	attr,
		Real	threshold
	)

inline

Applies pruning-max filtering from an attribute buffer.

Nodes with attribute values above threshold are kept, and fully rejected subtrees are reconstructed at their own subtree levels.

Definition at line 604 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [3/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedMorphologicalTree< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from a weighted owner and raw attribute buffer.

Definition at line 830 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [4/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedMorphologicalTree< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from a weighted owner and owned attribute buffer.

Definition at line 814 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [5/9]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from a weighted owner into an output image.

Definition at line 766 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [6/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedTreeView< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from a raw attribute buffer into an output image.

Definition at line 822 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [7/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedTreeView< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from an owned attribute buffer into an output image.

Definition at line 806 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [8/9]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMax	(	const WeightedTreeView< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-max filtering from a criterion into an output image.

Definition at line 759 of file AttributeFilters.hpp.

◆ filteringByPruningMax() [9/9]

template<AltitudeValue T>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMax ( std::vector< bool > & criterion )

inline

Applies pruning-max filtering from a dense internal-node criterion.

Definition at line 654 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [1/9]

template<AltitudeValue T>

template<std::floating_point Real>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const Real *	attr,
		Real	threshold
	)

inline

Applies pruning-min filtering from a raw internal-node attribute buffer.

Definition at line 589 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [2/9]

template<AltitudeValue T>

template<std::floating_point Real>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const std::shared_ptr< Real[]> &	attr,
		Real	threshold
	)

inline

Applies pruning-min filtering from an attribute buffer.

Nodes with attribute values above threshold remain traversable; rejected subtrees are reconstructed at the ancestor level selected by the pruning-min rule.

Definition at line 581 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [3/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedMorphologicalTree< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from a weighted owner and raw attribute buffer.

Definition at line 798 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [4/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedMorphologicalTree< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from a weighted owner and owned attribute buffer.

Definition at line 782 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [5/9]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from a weighted owner into an output image.

Definition at line 752 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [6/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedTreeView< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from a raw attribute buffer into an output image.

Definition at line 790 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [7/9]

template<AltitudeValue T>

template<std::floating_point Real>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedTreeView< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from an owned attribute buffer into an output image.

Definition at line 774 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [8/9]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringByPruningMin	(	const WeightedTreeView< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes pruning-min filtering from a criterion into an output image.

Definition at line 745 of file AttributeFilters.hpp.

◆ filteringByPruningMin() [9/9]

template<AltitudeValue T>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByPruningMin ( std::vector< bool > & criterion )

inline

Applies pruning-min filtering from a dense internal-node criterion.

Definition at line 644 of file AttributeFilters.hpp.

◆ filteringBySubtractiveRule() [1/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringBySubtractiveRule	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes subtractive-rule filtering from a weighted owner into an output image.

Definition at line 724 of file AttributeFilters.hpp.

◆ filteringBySubtractiveRule() [2/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringBySubtractiveRule	(	const WeightedTreeView< T > &	weighted,
		std::vector< bool > &	criterion,
		ImagePtr< T >	imgOutputPtr
	)

inlinestatic

Writes subtractive-rule filtering into a caller-owned output image.

Definition at line 717 of file AttributeFilters.hpp.

◆ filteringBySubtractiveRule() [3/3]

template<AltitudeValue T>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringBySubtractiveRule ( std::vector< bool > & criterion )

inline

Applies the subtractive filtering rule from a dense internal-node criterion.

Accepted nodes add their residue to the propagated reconstruction level; rejected nodes inherit the parent level.

Definition at line 680 of file AttributeFilters.hpp.

◆ filteringBySubtractiveScoreRule() [1/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringBySubtractiveScoreRule	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< float > &	prob,
		ImageFloatPtr	imgOutputPtr
	)

inlinestatic

Writes subtractive-score filtering from a weighted owner into an output image.

Definition at line 710 of file AttributeFilters.hpp.

◆ filteringBySubtractiveScoreRule() [2/3]

template<AltitudeValue T>

static void mmcfilters::AttributeFilters< T >::filteringBySubtractiveScoreRule	(	const WeightedTreeView< T > &	weighted,
		std::vector< float > &	prob,
		ImageFloatPtr	imgOutputPtr
	)

inlinestatic

Writes subtractive-score filtering into a caller-owned output image.

Definition at line 703 of file AttributeFilters.hpp.

◆ filteringBySubtractiveScoreRule() [3/3]

template<AltitudeValue T>

ImageFloatPtr mmcfilters::AttributeFilters< T >::filteringBySubtractiveScoreRule ( std::vector< float > & prob )

inline

Applies the subtractive score rule from dense per-node scores.

Each node residue is weighted by prob[nodeId] before accumulation, and the result is reconstructed as a floating-point image.

Definition at line 693 of file AttributeFilters.hpp.

◆ filteringByViterbiRule()

template<AltitudeValue T>

template<std::floating_point Real>

ImagePtr< T > mmcfilters::AttributeFilters< T >::filteringByViterbiRule	(	const Real *	attr,
		Real	threshold
	)

inline

Applies Salembier-style Viterbi filtering from a raw attribute buffer.

The internal detail implementation turns attr and threshold into preserve/remove costs and solves the optimal connected keep mask on the tree. The root is always preserved. Once the Viterbi path removes a node, every descendant is removed as well; preserved descendants can only appear below preserved ancestors. The final image is reconstructed by the direct rule using that connected keep criterion.

Definition at line 631 of file AttributeFilters.hpp.

◆ getAdaptiveCriterion() [1/4]

template<AltitudeValue T>

template<std::floating_point Real>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterion	(	const WeightedMorphologicalTree< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		AltitudeDiff< T >	delta
	)

inlinestatic

Builds an MSER-assisted pruning criterion from a raw attribute buffer.

Definition at line 846 of file AttributeFilters.hpp.

◆ getAdaptiveCriterion() [2/4]

template<AltitudeValue T>

template<std::floating_point Real>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterion	(	const WeightedMorphologicalTree< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		AltitudeDiff< T >	delta
	)

inlinestatic

Builds an MSER-assisted pruning criterion from an attribute threshold.

Definition at line 838 of file AttributeFilters.hpp.

◆ getAdaptiveCriterion() [3/4]

template<AltitudeValue T>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterion	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		AltitudeDiff< T >	delta
	)

inlinestatic

Builds an MSER-assisted pruning criterion from an existing criterion mask.

Definition at line 853 of file AttributeFilters.hpp.

◆ getAdaptiveCriterion() [4/4]

template<AltitudeValue T>

std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterion	(	std::vector< bool > &	criterion,
		AltitudeDiff< T >	delta
	)

inline

Builds an MSER-assisted pruning criterion from an existing keep/reject mask.

Parameters

criterion	Dense internal-node mask. Nodes with `false` are candidates for adaptive pruning.
delta	Altitude distance used by the MSER stability computation.

Returns: Dense internal-node pruning mask.

Definition at line 553 of file AttributeFilters.hpp.

◆ getAdaptiveCriterionByDepth() [1/4]

template<AltitudeValue T>

template<std::floating_point Real>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterionByDepth	(	const WeightedMorphologicalTree< T > &	weighted,
		const Real *	attribute,
		Real	threshold,
		int	depthDelta
	)

inlinestatic

Builds a depth-stability pruning criterion from a raw attribute buffer.

Definition at line 869 of file AttributeFilters.hpp.

◆ getAdaptiveCriterionByDepth() [2/4]

template<AltitudeValue T>

template<std::floating_point Real>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterionByDepth	(	const WeightedMorphologicalTree< T > &	weighted,
		const std::shared_ptr< Real[]> &	attribute,
		Real	threshold,
		int	depthDelta
	)

inlinestatic

Builds a depth-stability pruning criterion from an attribute threshold.

Definition at line 861 of file AttributeFilters.hpp.

◆ getAdaptiveCriterionByDepth() [3/4]

template<AltitudeValue T>

static std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterionByDepth	(	const WeightedMorphologicalTree< T > &	weighted,
		std::vector< bool > &	criterion,
		int	depthDelta
	)

inlinestatic

Builds a depth-stability pruning criterion from an existing criterion mask.

Definition at line 876 of file AttributeFilters.hpp.

◆ getAdaptiveCriterionByDepth() [4/4]

template<AltitudeValue T>

std::vector< bool > mmcfilters::AttributeFilters< T >::getAdaptiveCriterionByDepth	(	std::vector< bool > &	criterion,
		int	depthDelta
	)

inline

Builds a depth-stability pruning criterion from an existing mask.

depthDelta is a number of tree edges. The stability computation does not read altitude, so it is suitable for tree-of-shapes and self-dual residual trees where max/min altitude polarity is not defined.

Definition at line 568 of file AttributeFilters.hpp.

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

mmcfilters/filters/AttributeFilters.hpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ AttributeFilters() [1/2]

◆ AttributeFilters() [2/2]

Member Function Documentation

◆ filteringByDirectRule() [1/3]

◆ filteringByDirectRule() [2/3]

◆ filteringByDirectRule() [3/3]

◆ filteringByPruningMax() [1/9]

◆ filteringByPruningMax() [2/9]

◆ filteringByPruningMax() [3/9]

◆ filteringByPruningMax() [4/9]

◆ filteringByPruningMax() [5/9]

◆ filteringByPruningMax() [6/9]

◆ filteringByPruningMax() [7/9]

◆ filteringByPruningMax() [8/9]

◆ filteringByPruningMax() [9/9]

◆ filteringByPruningMin() [1/9]

◆ filteringByPruningMin() [2/9]

◆ filteringByPruningMin() [3/9]

◆ filteringByPruningMin() [4/9]

◆ filteringByPruningMin() [5/9]

◆ filteringByPruningMin() [6/9]

◆ filteringByPruningMin() [7/9]

◆ filteringByPruningMin() [8/9]

◆ filteringByPruningMin() [9/9]

◆ filteringBySubtractiveRule() [1/3]

◆ filteringBySubtractiveRule() [2/3]

◆ filteringBySubtractiveRule() [3/3]

◆ filteringBySubtractiveScoreRule() [1/3]

◆ filteringBySubtractiveScoreRule() [2/3]

◆ filteringBySubtractiveScoreRule() [3/3]

◆ filteringByViterbiRule()

◆ getAdaptiveCriterion() [1/4]

◆ getAdaptiveCriterion() [2/4]

◆ getAdaptiveCriterion() [3/4]

◆ getAdaptiveCriterion() [4/4]

◆ getAdaptiveCriterionByDepth() [1/4]

◆ getAdaptiveCriterionByDepth() [2/4]

◆ getAdaptiveCriterionByDepth() [3/4]

◆ getAdaptiveCriterionByDepth() [4/4]