Back to Adaptive Vision Studio website
You are here: Start » Filter Reference » Deep Learning » 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
Models for Deep Learning may be created using Adaptive Vision Deep Learning Editor.