Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Deep Learning » DeepLearning_SegmentInstances

DeepLearning_SegmentInstances


Performs instance segmentation using a trained deep-learning model.

Name Type Range Description
inImage Image Input image
inRoi Region* Area of interest
inDeepModel DeepModel_InstanceSegmentation Trained model
inMinDetectionScore Real* 0.0 - 1.0 Minimal score of found objects
inMaxObjectsCount Integer* 1 - Maximal number of found objects
outBoundingBoxes BoxArray Bounding boxes of found objects
outClassIds IntegerArray Ids of found objects classes
outClassNames StringArray Names of found objects classes
outScores RealArray Scores of found objects
outMasks RegionArray Masks of found objects

Requirements

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

Read more about pixel formats in Image documentation.

Hints

Loading Deep Learning Model may take longer timer. Consider using DeepLearning_LoadModel for pre-loading model before execution starts.

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

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

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

Complexity Level

This filter is available on Basic Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Adaptive Vision Studio Professional version.

See Also