You are here: Start » Function Reference » Deep Learning » DeepLearning_LocatePoints

DeepLearning_LocatePoints

Header:	AVL.h
Namespace:	avl

Performs points localization using a trained deep-learning model.

Syntax

void avl::DeepLearning_LocatePoints
(
	DeepLearningConnectionState& ioState,
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	const avl::DeepModel_PointLocation& inDeepModel,
	const float inMinDetectionScore,
	const atl::Optional<float>& inMinDistanceRatio,
	const bool inOverlap,
	atl::Array<avl::Location>& outLocations,
	atl::Array<int>& outClassIds,
	atl::Array<atl::String>& outClassNames,
	atl::Array<float>& outScores
)

Parameters

Name	Type	Range	Default	Description
ioState	DeepLearningConnectionState&			Object used to maintain state of the function.
inImage	const Image&			Input image
inRoi	Optional<const Region&>		NIL	Area of interest
inDeepModel	const DeepModel_PointLocation&			Trained model
inMinDetectionScore	const float	0.0 - 1.0	0.5f	Minimal score of found points
inMinDistanceRatio	const Optional<float>&	0.01 - 1.0	NIL	Minimal distance between found points defined as portion of Feature Size
inOverlap	const bool		True	Add tiles overlapping to improve results quality
outLocations	Array<Location>&			Locations of found points
outClassIds	Array<int>&			Ids of found point classes
outClassNames	Array<String>&			Names of found point classes
outScores	Array<float>&			Scores of found points

Requirements

For input inImage only pixel formats are supported: 1⨯uint8, 3⨯uint8.

Read more about pixel formats in Image documentation.

Errors

List of possible exceptions:

Error type	Description
DomainError	Empty image in DeepLearning_LocatePoints.
DomainError	Empty ROI region in DeepLearning_LocatePoints
DomainError	Invalid DeepModel in DeepLearning_LocatePoints.
DomainError	Size of ROI differs from size of image in DeepLearning_LocatePoints
IoError	Invalid service response - missing class id
IoError	Invalid service response - missing class name
IoError	Invalid service response - missing score