mln::morpho Namespace Reference

Namespace of mathematical morphology routines. More...

Namespaces
namespace	approx
	Namespace of approximate mathematical morphology routines.
namespace	attribute
	Namespace of attributes used in mathematical morphology.
namespace	elementary
	Namespace of image processing routines of elementary mathematical morphology.
namespace	impl
	Namespace of mathematical morphology routines implementations.
namespace	reconstruction
	Namespace of morphological reconstruction routines.
namespace	tree
	Namespace of morphological tree-related routines.
namespace	watershed
	Namespace of morphological watershed routines.
Functions
template<typename I >
mln::trait::concrete< I >::ret	complementation (const Image< I > &input)
template<typename I >
void	complementation_inplace (Image< I > &input)
template<typename I , typename W >
mln::trait::concrete< I >::ret	contrast (const Image< I > &input, const Window< W > &win)
template<typename I , typename W >
mln::trait::concrete< I >::ret	dilation (const Image< I > &input, const Window< W > &win)
	Morphological dilation.
template<typename I , typename W >
mln::trait::concrete< I >::ret	erosion (const Image< I > &input, const Window< W > &win)
	Morphological erosion.
template<typename Op , typename I , typename W >
mln::trait::concrete< I >::ret	general (const Op &op, const Image< I > &input, const Window< W > &win)
	Morphological general routine.
template<typename I , typename W >
mln::trait::concrete< I >::ret	gradient (const Image< I > &input, const Window< W > &win)
	Morphological gradient.
template<typename I , typename W >
mln::trait::concrete< I >::ret	gradient_external (const Image< I > &input, const Window< W > &win)
	Morphological external gradient.
template<typename I , typename W >
mln::trait::concrete< I >::ret	gradient_internal (const Image< I > &input, const Window< W > &win)
	Morphological internal gradient.
template<typename I , typename Wh , typename Wm >
mln::trait::concrete< I >::ret	hit_or_miss (const Image< I > &input, const Window< Wh > &win_hit, const Window< Wm > &win_miss)
	Morphological hit-or-miss.
template<typename I , typename Wh , typename Wm >
mln::trait::concrete< I >::ret	hit_or_miss_background_closing (const Image< I > &input, const Window< Wh > &win_hit, const Window< Wm > &win_miss)
	Morphological hit-or-miss closing of the background.
template<typename I , typename Wh , typename Wm >
mln::trait::concrete< I >::ret	hit_or_miss_background_opening (const Image< I > &input, const Window< Wh > &win_hit, const Window< Wm > &win_miss)
	Morphological hit-or-miss opening of the background.
template<typename I , typename Wh , typename Wm >
mln::trait::concrete< I >::ret	hit_or_miss_closing (const Image< I > &input, const Window< Wh > &win_hit, const Window< Wm > &win_miss)
	Morphological hit-or-miss closing.
template<typename I , typename Wh , typename Wm >
mln::trait::concrete< I >::ret	hit_or_miss_opening (const Image< I > &input, const Window< Wh > &win_hit, const Window< Wm > &win_miss)
	Morphological hit-or-miss opening.
template<typename I , typename W , typename O >
void	laplacian (const Image< I > &input, const Window< W > &win, Image< O > &output)
template<typename V >
edge_image< util::site_pair < point2d >, V, util::graph >	line_gradient (const mln::image2d< V > &ima)
	Create a line graph image representing the gradient norm of a mln::image2d.
template<typename L , typename I , typename N >
mln::trait::ch_value< I, L >::ret	meyer_wst (const Image< I > &input, const Neighborhood< N > &nbh)
	Meyer's Watershed Transform (WST) algorithm, with no count of basins.
template<typename L , typename I , typename N >
mln::trait::ch_value< I, L >::ret	meyer_wst (const Image< I > &input, const Neighborhood< N > &nbh, L &nbasins)
	Meyer's Watershed Transform (WST) algorithm.
template<typename I , typename J >
mln::trait::concrete< I >::ret	min (const Image< I > &lhs, const Image< J > &rhs)
template<typename I , typename J >
void	min_inplace (Image< I > &lhs, const Image< J > &rhs)
template<typename I , typename J >
mln::trait::concrete< I >::ret	minus (const Image< I > &lhs, const Image< J > &rhs)
template<typename I , typename J >
mln::trait::concrete< I >::ret	plus (const Image< I > &lhs, const Image< J > &rhs)
template<typename I , typename W >
mln::trait::concrete< I >::ret	rank_filter (const Image< I > &input, const Window< W > &win, unsigned k)
	Morphological rank_filter.
template<typename I , typename Wfg , typename Wbg >
mln::trait::concrete< I >::ret	thick_miss (const Image< I > &input, const Window< Wfg > &win_fg, const Window< Wbg > &win_bg)
template<typename I , typename Wfg , typename Wbg >
mln::trait::concrete< I >::ret	thickening (const Image< I > &input, const Window< Wfg > &win_fg, const Window< Wbg > &win_bg)
template<typename I , typename Wfg , typename Wbg >
mln::trait::concrete< I >::ret	thin_fit (const Image< I > &input, const Window< Wfg > &win_fg, const Window< Wbg > &win_bg)
template<typename I , typename Wfg , typename Wbg >
mln::trait::concrete< I >::ret	thinning (const Image< I > &input, const Window< Wfg > &win_fg, const Window< Wbg > &win_bg)
	Morphological thinning.
template<typename I , typename W >
mln::trait::concrete< I >::ret	top_hat_black (const Image< I > &input, const Window< W > &win)
	Morphological black top-hat (for background / dark objects).
template<typename I , typename W >
mln::trait::concrete< I >::ret	top_hat_self_complementary (const Image< I > &input, const Window< W > &win)
	Morphological self-complementary top-hat.
template<typename I , typename W >
mln::trait::concrete< I >::ret	top_hat_white (const Image< I > &input, const Window< W > &win)
	Morphological white top-hat (for object / light objects).

---

Detailed Description

Namespace of mathematical morphology routines.

---

Function Documentation

template<typename I >

mln::trait::concrete< I >::ret mln::morpho::complementation

(

const Image< I > &

input

)

[inline]

Morphological complementation: either a logical "not" (if morpho on sets) or an arithmetical complementation (if morpho on functions).

Referenced by hit_or_miss_background_closing(), hit_or_miss_background_opening(), hit_or_miss_closing(), and thinning().

template<typename I >

void mln::morpho::complementation_inplace

(

Image< I > &

input

)

[inline]

Morphological complementation, inplace version: either a logical "not" (if morpho on sets) or an arithmetical complementation (if morpho on functions).

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::contrast	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological contrast operator (based on top-hats).

This operator is Id + wth_B - bth_B.

References plus(), top_hat_black(), and top_hat_white().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::dilation	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological dilation.

References general().

Referenced by gradient(), gradient_external(), mln::morpho::impl::generic::hit_or_miss(), hit_or_miss_background_opening(), hit_or_miss_opening(), laplacian(), mln::morpho::opening::approx::structural(), and mln::morpho::closing::approx::structural().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::erosion	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological erosion.

References general().

Referenced by gradient(), gradient_internal(), mln::morpho::impl::generic::hit_or_miss(), laplacian(), mln::morpho::opening::approx::structural(), and mln::morpho::closing::approx::structural().

template<typename Op , typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::general	(	const Op &	op,
		const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological general routine.

Referenced by dilation(), and erosion().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::gradient	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological gradient.

This operator is d_B - e_B.

References dilation(), erosion(), minus(), and mln::test::positive().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::gradient_external	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological external gradient.

This operator is d_B - Id.

References dilation(), minus(), and mln::test::positive().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::gradient_internal	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological internal gradient.

This operator is Id - e_B.

References erosion(), minus(), and mln::test::positive().

template<typename I , typename Wh , typename Wm >

mln::trait::concrete< I >::ret mln::morpho::hit_or_miss	(	const Image< I > &	input,
		const Window< Wh > &	win_hit,
		const Window< Wm > &	win_miss
	)			[inline]

Morphological hit-or-miss.

This operator is HMT_(Bh,Bm) = e_Bh /\ (e_Bm o C).

References dilation(), erosion(), mln::data::fill(), mln::initialize(), and mln::literal::zero.

Referenced by thickening(), and thinning().

template<typename I , typename Wh , typename Wm >

mln::trait::concrete< I >::ret mln::morpho::hit_or_miss_background_closing	(	const Image< I > &	input,
		const Window< Wh > &	win_hit,
		const Window< Wm > &	win_miss
	)			[inline]

Morphological hit-or-miss closing of the background.

This operator is C o HMTopeBG o C.

References complementation(), hit_or_miss_background_opening(), and hit_or_miss_closing().

template<typename I , typename Wh , typename Wm >

mln::trait::concrete< I >::ret mln::morpho::hit_or_miss_background_opening	(	const Image< I > &	input,
		const Window< Wh > &	win_hit,
		const Window< Wm > &	win_miss
	)			[inline]

Morphological hit-or-miss opening of the background.

This operator is HMTopeBG = HMTope_(Bm,Bh) o C = d_(-Bm) o HMT_(Bh,Bm).

References complementation(), dilation(), hit_or_miss_opening(), and mln::win::sym().

Referenced by hit_or_miss_background_closing(), and thick_miss().

template<typename I , typename Wh , typename Wm >

mln::trait::concrete< I >::ret mln::morpho::hit_or_miss_closing	(	const Image< I > &	input,
		const Window< Wh > &	win_hit,
		const Window< Wm > &	win_miss
	)			[inline]

Morphological hit-or-miss closing.

This operator is C o HMTope o C.

References complementation(), and hit_or_miss_opening().

Referenced by hit_or_miss_background_closing().

template<typename I , typename Wh , typename Wm >

mln::trait::concrete< I >::ret mln::morpho::hit_or_miss_opening	(	const Image< I > &	input,
		const Window< Wh > &	win_hit,
		const Window< Wm > &	win_miss
	)			[inline]

Morphological hit-or-miss opening.

This operator is HMTope_(Bh,Bm) = d_(-Bh) o HMT_(Bh,Bm).

References dilation(), and mln::win::sym().

Referenced by hit_or_miss_background_opening(), hit_or_miss_closing(), and thin_fit().

template<typename I , typename W , typename O >

void mln::morpho::laplacian	(	const Image< I > &	input,
		const Window< W > &	win,
		Image< O > &	output
	)			[inline]

Morphological laplacian.

This operator is (d_B - Id) - (Id - e_B).

References dilation(), erosion(), mln::data::fill(), and minus().

template<typename V >

edge_image< util::site_pair< point2d >, V, util::graph > mln::morpho::line_gradient

(

const mln::image2d< V > &

ima

)

[inline]

Create a line graph image representing the gradient norm of a mln::image2d.

References mln::math::abs(), mln::image2d< T >::domain(), mln::box< P >::has(), mln::window< D >::insert(), and mln::Box< E >::nsites().

template<typename L , typename I , typename N >

mln::trait::ch_value< I, L >::ret mln::morpho::meyer_wst	(	const Image< I > &	input,
		const Neighborhood< N > &	nbh
	)			[inline]

Meyer's Watershed Transform (WST) algorithm, with no count of basins.

Parameters:

[in]	input	The input image.
[in]	nbh	The connexity of markers.

• L is the type of labels, used to number the watershed itself (with the minimal value), and the basins.
• I is the exact type of the input image.
• N is the exact type of the neighborhood used to express input's connexity.

Note that the first parameter, L, is not automatically valued from the type of the actual argument during implicit instantiation: you have to explicitly pass this parameter at call sites.

template<typename L , typename I , typename N >

mln::trait::ch_value< I, L >::ret mln::morpho::meyer_wst	(	const Image< I > &	input,
		const Neighborhood< N > &	nbh,
		L &	nbasins
	)			[inline]

Meyer's Watershed Transform (WST) algorithm.

Parameters:

[in]	input	The input image.
[in]	nbh	The connexity of markers.
[out]	nbasins	The number of basins.

• L is the type of labels, used to number the watershed itself (with the minimal value), and the basins.
• I is the exact type of the input image.
• N is the exact type of the neighborhood used to express input's connexity.

References mln::data::fill(), mln::p_priority< P, Q >::front(), mln::initialize(), mln::p_priority< P, Q >::pop(), mln::p_priority< P, Q >::push(), mln::labeling::regional_minima(), and mln::literal::zero.

template<typename I , typename J >

mln::trait::concrete< I >::ret mln::morpho::min	(	const Image< I > &	lhs,
		const Image< J > &	rhs
	)			[inline]

Morphological min: either a logical "and" (if morpho on sets) or an arithmetical min (if morpho on functions).

template<typename I , typename J >

void mln::morpho::min_inplace	(	Image< I > &	lhs,
		const Image< J > &	rhs
	)			[inline]

Morphological min, inplace version: either a logical "and" (if morpho on sets) or an arithmetical min (if morpho on functions).

template<typename I , typename J >

mln::trait::concrete< I >::ret mln::morpho::minus	(	const Image< I > &	lhs,
		const Image< J > &	rhs
	)			[inline]

Morphological minus: either a logical "and not" (if morpho on sets) or an arithmetical minus (if morpho on functions).

Referenced by gradient(), gradient_external(), gradient_internal(), laplacian(), thin_fit(), thinning(), top_hat_black(), mln::morpho::elementary::top_hat_black(), top_hat_self_complementary(), mln::morpho::elementary::top_hat_self_complementary(), top_hat_white(), and mln::morpho::elementary::top_hat_white().

template<typename I , typename J >

mln::trait::concrete< I >::ret mln::morpho::plus	(	const Image< I > &	lhs,
		const Image< J > &	rhs
	)			[inline]

Morphological plus: either a "logical or" (if morpho on sets) or an "arithmetical plus" (if morpho on functions).

Referenced by contrast(), thick_miss(), and thickening().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::rank_filter	(	const Image< I > &	input,
		const Window< W > &	win,
		unsigned	k
	)			[inline]

Morphological rank_filter.

References mln::extension::adjust_fill(), mln::geom::delta(), mln::accu::stat::rank< T >::init(), and mln::initialize().

template<typename I , typename Wfg , typename Wbg >

mln::trait::concrete< I >::ret mln::morpho::thick_miss	(	const Image< I > &	input,
		const Window< Wfg > &	win_fg,
		const Window< Wbg > &	win_bg
	)			[inline]

Morphological thick-miss.

This operator is THICK_B = Id + HMTopeBG_B, where B = (Bfg, Bbg).

References hit_or_miss_background_opening(), and plus().

template<typename I , typename Wfg , typename Wbg >

mln::trait::concrete< I >::ret mln::morpho::thickening	(	const Image< I > &	input,
		const Window< Wfg > &	win_fg,
		const Window< Wbg > &	win_bg
	)			[inline]

Morphological thickening.

This operator is THICK_B = Id + HMT_B, where B = (Bfg, Bbg).

References hit_or_miss(), and plus().

Referenced by thinning().

template<typename I , typename Wfg , typename Wbg >

mln::trait::concrete< I >::ret mln::morpho::thin_fit	(	const Image< I > &	input,
		const Window< Wfg > &	win_fg,
		const Window< Wbg > &	win_bg
	)			[inline]

Morphological thin-fit.

This operator is THIN_B = Id - HMTope_B where B = (Bfg, Bbg).

References hit_or_miss_opening(), and minus().

template<typename I , typename Wfg , typename Wbg >

mln::trait::concrete< I >::ret mln::morpho::thinning	(	const Image< I > &	input,
		const Window< Wfg > &	win_fg,
		const Window< Wbg > &	win_bg
	)			[inline]

Morphological thinning.

This operator is THIN_B = Id - HMT_B, where B = (Bfg, Bbg).

References complementation(), hit_or_miss(), minus(), and thickening().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::top_hat_black	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological black top-hat (for background / dark objects).

This operator is clo_B - Id.

References minus(), and mln::test::positive().

Referenced by contrast().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::top_hat_self_complementary	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological self-complementary top-hat.

This operator is
= top_hat_white + top_hat_black
= (input - opening) + (closing - input)
= closing - opening.

References minus(), and mln::test::positive().

template<typename I , typename W >

mln::trait::concrete< I >::ret mln::morpho::top_hat_white	(	const Image< I > &	input,
		const Window< W > &	win
	)			[inline]

Morphological white top-hat (for object / light objects).

This operator is Id - ope_B.

References minus(), and mln::test::positive().

Referenced by contrast().