metricsByArea

Evaluate instance segmentation across object mask size ranges

Since R2023b

Syntax

areaMetrics = metricsByArea(metrics,objectAreaRanges)

areaMetrics = metricsByArea(metrics,objectAreaRanges,ClassNames)

Description

areaMetrics = metricsByArea(metrics,objectAreaRanges) evaluates the instance segmentation metrics detection performance for the object size range or ranges, specified as bounding box areas, objectAreaRanges. The function evaluates the specified bounding box size range within the existing instance segmentation metrics.

areaMetrics = metricsByArea(metrics,objectAreaRanges,ClassNames) also specifies the names of the classes for which to evaluate area-based metrics.

Input Arguments

metrics — Instance segmentation metrics

M-by-4 numeric matrix | vector

Instance segmentation metrics, specified as an instanceSegmentationMetrics object.

objectAreaRanges — Area of rectangular bounding boxes

M-by-2 numeric matrix | vector

Area of rectangular bounding boxes which are axis-aligned and surround the object mask, specified as one of the following:

• An M-by-2 numeric matrix, with each row specifying the upper (exclusive) and lower (inclusive) limits of an box area range in evaluation. For example, if the input is [x₁ x₂; x₃ x₄]. The evaluated bounding box area ranges are x₁≤ area <x₂ and x₃≤ area <x₄.

• A vector with M+1 elements, specifying the edge values of M contiguous area ranges. Each range is inclusive in the lower limit, and exclusive in the upper limit. For example, if the input is [x₁ x₂ x₃], the area ranges evaluated are x₁≤ area <x₂ and x₂≤ area <x₃.

ClassNames — Names of classes

'' (default) | string scalar | vector

Names of the classes for which to evaluate area-based metrics. If multiple classes are specified, the function computes averaged metrics across the classes. By default, all classes will be considered and the returned metrics will be the average of all classes.

Output Arguments

areaMetrics — Metrics by area

table

Metrics by area, returned as a table with M rows. Each row contains metrics using objects within an area range (for a total of M area ranges). The first two columns are specified by the table variables:

• AreaRange: The upper and lower limits of each area range.

• NumObjects: The number of objects falling within each area range.

The remaining columns are the same as in the DataSetMetrics table. If ClassNames is specified with a single class, the remaining columns are the same as in the ClassMetrics table.

Version History

Introduced in R2023b