selectStrongestBbox
Select strongest bounding boxes from overlapping clusters using nonmaximal suppression (NMS)
Syntax
Description
[
returns
selected bounding boxes that have a high confidence score. The function uses
nonmaximal suppression (NMS) to eliminate overlapping bounding boxes from the
selectedBbox
,selectedScore
]
= selectStrongestBbox(bbox
,score
)bbox
input.
[
additionally
returns the selectedBbox
,selectedScore
,index
]
= selectStrongestBbox(bbox
,score
)index
vector associated with selectedBbox
.
This vector contains the indices of the selected boxes in the bbox
input.
[___]
= selectStrongestBbox(___,
uses additional options specified by one or more Name,Value
)Name,Value
pair arguments.
Examples
Run Nonmaximal Suppression on Bounding Boxes Using People Detector
Load the pretrained aggregate channel features (ACF) people detector.
peopleDetector = peopleDetectorACF();
Detect people in an image. Disable the default nonmaximal suppression used by the detector.
I = imread('visionteam1.jpg'); [bbox,score] = detect(peopleDetector,I,'SelectStrongest',false);
Run nonmaximal suppression with custom threshold.
[selectedBbox,selectedScore] = selectStrongestBbox(bbox,score,'OverlapThreshold',0.3);
Display the results.
I1 = insertObjectAnnotation(I,'rectangle',bbox,score,'AnnotationColor','r'); I2 = insertObjectAnnotation(I,'rectangle',selectedBbox,selectedScore,'AnnotationColor','r'); figure, imshow(I1); title('Detected people and detection scores before suppression');
figure, imshow(I2);
title('Detected people and detection scores after suppression');
Input Arguments
bbox
— Bounding boxes
M-by-4 matrix | M-by-5 matrix
Bounding boxes, specified as an M-by-4 or M-by-5 nonsparse numeric matrix. M is the number of bounding boxes. Each row of the matrix defines a bounding box as either an axis-aligned rectangle or a rotated rectangle. This table describes the format for each bounding box.
Bounding Box | Description |
---|---|
Axis-aligned rectangle |
Defined in spatial coordinates as an M-by-4 numeric matrix with rows of the form [x y w h], where:
|
Rotated rectangle |
Defined in spatial coordinates as an M-by-5 numeric matrix with rows of the form [xctr yctr xlen ylen yaw], where:
|
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
score
— Confidence score
M-by-1 vector
Confidence score, specified as an M-by-1 vector. The Mth
score corresponds to the Mth bounding box in the
bbox
input. The
selectStrongestBbox
function uses nonmaximal
suppression to eliminate overlapping bounding boxes and associate the
confidence score with the boxes. A higher score represents a higher
confidence in keeping the bounding box. The score
input
must be real, finite, and nonsparse.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
Name-Value Arguments
Specify optional pairs of arguments as
Name1=Value1,...,NameN=ValueN
, where Name
is
the argument name and Value
is the corresponding value.
Name-value arguments must appear after other arguments, but the order of the
pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose
Name
in quotes.
Example: 'RatioType'
,'Union'
sets
the 'RatioType'
property to 'Union'
.
RatioType
— Bounding box overlap ratio denominator
'Union'
(default) | 'Min'
Ratio type, specified as the character vector 'Union'
or 'Min'
.
Set the ratio type to
'Union'
to compute the ratio as the area of intersection betweenbboxA
andbboxB
, divided by the area of the union of the two.Set the ratio type to
'Min'
to compute the ratio as the area of intersection betweenbboxA
andbboxB
, divided by the minimum area of the two bounding boxes.
Data Types: char
OverlapThreshold
— Overlap ratio threshold
0.5
(default) | scalar in the range [0 1]
Overlap ratio threshold, specified as the comma-separated pair
consisting of 'OverlapThreshold
' and a scalar
in the range [0 1]. When the overlap ratio is above the threshold
you set, the function removes bounding boxes around the reference
box. Decrease this value to reduce the number of selected bounding
boxes. However, if you decrease the overlap ratio too much, you might
eliminate boxes that represent objects close to each other in the
image.
Data Types: single
| double
NumStrongest
— Maximum number of strongest boxes
inf
(default) | positive scalar
Maximum number of strongest boxes, specified as the comma-separated
pair consisting of 'NumStrongest'
and
inf
or a positive scalar. Use this argument to
reduce processing time when you have a priori knowledge about the
maximum number of boxes. Set the value to inf
to
select all the strongest, non-overlapping, bounding boxes.
Output Arguments
selectedBbox
— Selected bounding boxes
M-by-4 matrix | M-by-5 matrix
Selected bounding boxes, returned as an M-by-4 or an M-by-5 matrix. The 4-element vectors represent axis-aligned rectangles and the 5-element vectors represent rotated rectangles.
The selectedBbox
output returns the selected bounding
boxes from the bbox
input that have the highest
confidence score. The function uses nonmaximal suppression to eliminate
overlapping bounding boxes.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
selectedScore
— Scores of selected bounding boxes
M-by-1 vector
Scores of selected bounding boxes, returned as an M-by-1
vector. The Mth score in the selectedScore
output
corresponds to the Mth bounding box in the selectedBbox
output.
Data Types: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
index
— Index of selected bounding boxes
M-by-1 vector
Index of selected bounding boxes, returned as an M-by-1
vector. The index
vector contains the indices
to the selected boxes in the bbox
input.
Data Types: double
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Usage notes and limitations:
Code generation is only supported for numeric
labels
.
GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.
Usage notes and limitations:
CUDA® code generation is only supported for numeric
labels
.
GPU Arrays
Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.
Usage notes and limitations:
GPU Arrays is not supported for rotated rectangle bounding box inputs.
Version History
Introduced in R2014b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)