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

DeepLearning_ClassifyObject

Performs whole image classification using a trained deep-learning model.

Syntax

void avl::DeepLearning_ClassifyObject
(
	DeepLearningConnectionState& ioState,
	const avl::Image& inImage,
	const atl::Optional<avl::Region>& inRoi,
	const avl::DeepModel_Classification& inDeepModel,
	atl::Array<avl::ClassConfidence>& outConfidences,
	atl::String& outClassName,
	int& outClassIndex,
	float& outScore
)

void DeepLearning_ClassifyObject
(
	ref DeepLearningConnectionState ioState,
	Image inImage,
	Region? inRoi,
	DeepModel_Classification inDeepModel,
	out ClassConfidence[] outConfidences,
	out System.String outClassName,
	out int outClassIndex,
	out float outScore
)

Parameters

Name	Type	Default	Description
ioState	DeepLearningConnectionState&		Object used to maintain state of the function.
inImage	const Image&		Input image
inRoi	const Optional<Region>&	NIL	Area of interest
inDeepModel	const DeepModel_Classification&		Trained model
outConfidences	Array<ClassConfidence>&		Returns confidences for all classes
outClassName	String&		Returns name of the class with highest confidence
outClassIndex	int&		Returns the index of the class with highest confidence
outScore	float&		Returns the value of the highest confidence

Errors

Error type	Description
DomainError	Empty ROI region in DeepLearning_ClassifyObject
DomainError	Invalid DeepModel in DeepLearning_ClassifyObject.
DomainError	Empty image in DeepLearning_ClassifyObject.
IoError	Unable to connect to Deep Learning Service.
IoError	Connection with service lost.
IoError	Missing results count.
IoError	Missing confidences.