diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-1.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-1.jpg new file mode 100644 index 00000000..f201b6ff Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-1.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-2.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-2.jpg new file mode 100644 index 00000000..e73d001c Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-2.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-3.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-3.jpg new file mode 100644 index 00000000..20591c2b Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-3.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-4.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-4.jpg new file mode 100644 index 00000000..90b19e8f Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-4.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-5.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-5.jpg new file mode 100644 index 00000000..6105571c Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-5.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-6.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-6.jpg new file mode 100644 index 00000000..56c3e265 Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-6.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-7.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-7.jpg new file mode 100644 index 00000000..2d8978b5 Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-7.jpg differ diff --git a/.gitbook/assets/oriented-b-box/Oriented-bbox-8.jpg b/.gitbook/assets/oriented-b-box/Oriented-bbox-8.jpg new file mode 100644 index 00000000..6a514729 Binary files /dev/null and b/.gitbook/assets/oriented-b-box/Oriented-bbox-8.jpg differ diff --git a/SUMMARY.md b/SUMMARY.md index adba1a4f..7543fcaa 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -119,6 +119,7 @@ * [Navigation & Selection Tools](labeling/labeling-tools/navigation-and-selection-tools.md) * [Point Tool](labeling/labeling-tools/point-tool.md) * [Bounding Box (Rectangle) Tool](labeling/labeling-tools/bounding-box-rectangle-tool.md) + * [Oriented Bounding Box Tool](labeling/labeling-tools/oriented-bounding-box-tool.md) * [Polyline Tool](labeling/labeling-tools/polyline-tool.md) * [Polygon Tool](labeling/labeling-tools/polygon-tool.md) * [Brush Tool](labeling/labeling-tools/brush-tool.md) diff --git a/labeling/labeling-tools/oriented-bounding-box-tool.md b/labeling/labeling-tools/oriented-bounding-box-tool.md new file mode 100644 index 00000000..28943906 --- /dev/null +++ b/labeling/labeling-tools/oriented-bounding-box-tool.md @@ -0,0 +1,75 @@ +--- +description: >- + In this guide, you'll learn how to use oriented-bounding-box tool for video. +--- + +# Oriented Bounding Box Tool + +## What is Oriented Bounding Box Annotation Tool? + +An Oriented Bounding Box (OBB) is a rotated rectangle defined by two corner points and a rotation angle. Unlike an axis-aligned rectangle, an OBB can be rotated to closely fit objects at arbitrary orientations. This makes it especially suitable for annotating elongated or tilted objects such as vehicles, ships, or text. + +{% embed url="https://youtu.be/tGA1-EJOyt4" %} + +## How to use the Bounding Box + +To speed up the annotation process, the Oriented Bounding Box tool can be used together with the Auto Track model. + +### Setup + +1. In the main menu, go to App Ecosystem and start Auto Track. +
+ +2. Then open Tasks & Apps from the main menu. +Navigate to the Apps tab. +Find the recently launched Auto Track application and click Open. +
+ +3. You will be redirected to the settings page containing all annotation tools compatible with Auto Track. +Scroll down to the Oriented Bounding Box section. +In the Select model for predictions dropdown, choose Interpolation (No model). +Return to the labeling tool. +
+ +### Usage Scenarios - Automatic annotation across frames. + +
+ +In the Quick Actions section of the Auto Track settings, there is an option to automatically apply annotations to any desired number of frames in either direction from the frame where the object was annotated using the Oriented Bounding Box tool. + +For Auto Track to work, at least two consecutive frames must be manually annotated. The underlying principle is as follows: the model compares the annotation on one frame with the annotation on another frame, calculates the differences in rotation angle, size, and position of the oriented bounding box, and then propagates these differences forward or backward, creating bounding boxes on subsequent frames as if by inertia. + +This simple method can be used on a small number of frames to quickly verify the correctness and consistency of the annotation. + +### Usage Scenarios - Interpolation between keyframes. + +The most effective use of the Oriented Bounding Box together with Auto Track is achieved using the Interpolate until next real frame function. This allows the system to automatically interpolate object positions and orientations between manually annotated keyframes. + +Let’s consider an example of annotating a vehicle moving along a complex trajectory with changes in body orientation. + +{% hint style="info" %} +**Note:** For interpolation to work correctly, Auto Track must be disabled in the Settings. +{% endhint %} + +
+ +1. First, annotate the object on any desired frame using the Oriented Bounding Box tool. This annotation will serve as the starting point for automatic interpolation. + +
+ +2. Next, move to another frame that will act as the final frame in the sequence forming the object’s motion trajectory, and annotate the object there as well. + +3. After that, click Interpolate until next real frame. As a result, a fully annotated segment will appear on the timeline, covering all frames between the first and the last manually annotated frames. + +
+ +The Interpolate until next real frame function evenly interpolates all parameters between the first and last annotated bounding boxes — including rotation angle, size, and position — across all intermediate frames. + +{% embed url="https://youtu.be/tGA1-EJOyt4" %} + +### Additional Use Case + +Consider another scenario using the same function. +If the object is manually annotated on three frames that are not adjacent, and you then navigate to an annotated frame located between the two outermost ones and apply Interpolate until next real frame, the system will automatically annotate all frames in both directions, up to the two nearest manually annotated frames. + +
\ No newline at end of file