AvsFilter_DL_ClassifyObject


Header: AVL.h
Namespace: avl
Module: DL_CO

Executes a Classify Object model on a single input image.

Syntax

void avl::AvsFilter_DL_ClassifyObject
(
	const avl::Image& inImage,
	atl::Optional<const avl::Rectangle2D&> inRoi,
	atl::Optional<const avl::CoordinateSystem2D&> inRoiAlignment,
	const avl::ClassifyObjectModelId& inModelId,
	const bool inCreateHeatmap,
	atl::Array<avl::ClassConfidence>& outConfidences,
	atl::String& outClassName,
	int& outClassIndex,
	float& outScore,
	avl::Heatmap& outRelevanceHeatmap,
	atl::Optional<avl::Rectangle2D&> outAlignedRoi = atl::NIL
)

Parameters

Name Type Default Description
Input value inImage const Image& Input image
Input value inRoi Optional<const Rectangle2D&> NIL Limits the area where a classified object is located
Input value inRoiAlignment Optional<const CoordinateSystem2D&> NIL
Input value inModelId const ClassifyObjectModelId& Identifier of a Classify Object model
Input value inCreateHeatmap const bool False Enables creating a relevance heatmap at the expense of extended execution time
Output value outConfidences Array<ClassConfidence>& Returns confidences for all classes
Output value outClassName String& Returns the name of the class with the highest confidence
Output value outClassIndex int& Returns the index of the class with the highest confidence
Output value outScore float& Returns the value of the highest confidence
Output value outRelevanceHeatmap Heatmap& Returns the heatmap indicating how strong specific parts of image influenced the classification result
Output value outAlignedRoi Optional<Rectangle2D&> NIL Input roi after the transformation

Requirements

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

Read more about pixel formats in Image documentation.

Optional Outputs

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

Read more about Optional Outputs.

Hints

Remarks

This filter should not be executed along with running Deep Learning Service as it may result in degraded performance or even out-of-memory errors.

Errors

List of possible exceptions:

Error type Description
DomainError Not supported inImage pixel format in AvsFilter_DL_ClassifyObject. Supported formats: 1xUInt8, 3xUInt8.

See Also