Back to Aurora Vision Library website

You are here: Start » Function Reference » Surface » Surface Features » SurfaceLocalMinima

SurfaceLocalMinima


Header: AVL.h
Namespace: avl
Module: Vision3DStandard

Finds surface locations characterized by locally minimal heights.

Applications: Detection of characteristic points, usually after some surface transformations.

Syntax

C++
C#
 
void avl::SurfaceLocalMinima
(
	const avl::Surface& inSurface,
	atl::Optional<const avl::Region&> inRoi,
	bool inConsiderLowlands,
	atl::Optional<float> inMinHeight,
	atl::Optional<float> inMaxHeight,
	float inMinDistance,
	atl::Optional<const avl::SurfaceLocalExtremaVerification&> inMinimaVerification,
	atl::Optional<atl::Array<avl::SurfaceExtremum>&> outLocalMinima,
	atl::Optional<atl::Array<avl::Region>&> outMinimaRegions = atl::NIL
)

Parameters

Name Type Range Default Description
Input value inSurface const Surface&
Input value inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value inConsiderLowlands bool Consider multi-pixel minima (lowlands) or not
Input value inMinHeight Optional<float> NIL Minimal height of minimum to be considered
Input value inMaxHeight Optional<float> NIL Maximal height of minimum to be considered
Input value inMinDistance float 0.0 - Minimal distance between two found minima
Input value inMinimaVerification Optional<const SurfaceLocalExtremaVerification&> NIL Minima verification structure
Output value outLocalMinima Optional<Array<SurfaceExtremum>&> Found local minima
Output value outMinimaRegions Optional<Array<Region>&> NIL Regions of local minima (plateaus and singletons)

Optional Outputs

The computation of following outputs can be switched off by passing value atl::NIL to these parameters: outLocalMinima, outMinimaRegions.

Read more about Optional Outputs.

Errors

List of possible exceptions:

Error type Description
DomainError Region of interest exceeds an input surface in SurfaceLocalMinima.