You are here: Start » AVL.NET » AVL.DeepLearning_SegmentInstances

AVL.DeepLearning_SegmentInstances

Performs instance segmentation using a trained deep-learning model.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void DeepLearning_SegmentInstances
(
	ref AvlNet.DeepLearningConnectionState ioState,
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	string inDeepModel,
	float? inMinDetectionScore,
	int? inMaxObjectsCount,
	out AvlNet.Box[] outBoundingBoxes,
	out int[] outClassIds,
	out string[] outClassNames,
	out float[] outScores,
	out AvlNet.Region[] outMasks
)

Parameters

Name Type Range Default Description
ioStateAvlNet.DeepLearningConnectionState
inImageAvlNet.ImageInput image.
inRoiAvlNet.RegionArea of interest. Default value: atl::NIL, or null.
inDeepModelstringTrained model.
inMinDetectionScorefloat?<0.0f, 1.0f>Minimal score of found objects. Default value: atl::NIL, or null.
inMaxObjectsCountint?<1, INF>Maximal number of found objects. Default value: atl::NIL, or null.
outBoundingBoxesAvlNet.Box[]Bounding boxes of found objects.
outClassIdsint[]Ids of found objects classes.
outClassNamesstring[]Names of found objects classes.
outScoresfloat[]Scores of found objects.
outMasksAvlNet.Region[]Masks of found objects.

Remarks

  • Model provided on inDeepModel input will be loaded to service automatically on first usage of Deep Learning filters.
  • Service automatically releases and loads model into its memory. It may result in releasing model previously loaded using DeepLearning_LoadModel filter.
  • These filters only communicates with service and cannot be use for parallel computation.

Errors

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

See also