Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update item Annotation with points #1597

Merged
merged 3 commits into from
May 27, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
98 changes: 47 additions & 51 deletions cvat/apps/documentation/user_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,10 @@
- [Annotation with rectangle by 4 points](#annotation-with-rectangle-by-4-points)
- [Annotation with polygons](#annotation-with-polygons)
- [Annotation with polylines](#annotation-with-polylines)
- [Annotation with cuboids](#annotation-with-cuboids)
- [Annotation with points](#annotation-with-points)
- [Points in annotation mode](#points-in-annotation-mode)
- [Linear interpolation with one point](#linear-interpolation-with-one-point)
- [Annotation with cuboids](#annotation-with-cuboids)
- [Annotation with Auto Segmentation](#annotation-with-auto-segmentation)
- [Automatic annotation](#automatic-annotation)
- [Shape grouping](#shape-grouping)
Expand Down Expand Up @@ -1107,6 +1107,52 @@ automatically. You can adjust the polyline after it has been drawn.

![](static/documentation/images/image039.jpg)

## Annotation with points

### Points in shape mode

It is used for face, landmarks annotation etc.

Before you start you need to select the ``Points``. If necessary you can set a fixed number of points
in the ``Number of points`` field, then drawing will be stopped automatically.

![](static/documentation/images/image042.jpg)

Click ``Shape`` to entering the drawing mode. Now you can start annotation of the necessary area.
Points are automatically grouped — all points will be considered linked between each start and finish.
Press ``N`` again to finish marking the area. You can delete a point by double-clicking with pressed ``Ctrl``
or right-clicking on a point and selecting ``Delete point``. Double-clicking with pressed ``Shift`` will open the points
shape editor. There you can add new points into an existing shape. You can zoom in/out (when scrolling the mouse wheel)
and move (when clicking the mouse wheel and moving the mouse) while drawing. You can drag an object after
it has been drawn and change the position of individual points after finishing an object.

![](static/documentation/images/image063_affectnet.jpg)

### Linear interpolation with one point

You can use linear interpolation for points to annotate a moving object:

1. Before you start, select the ``Points``.
1. Linear interpolation works only with one point, so you need to set ``Number of points`` to 1.
1. After that select the ``Track``.

![](static/documentation/images/image122.jpg)

1. Click ``Track`` to enter the drawing mode left-click to create a point and after that shape will be automatically completed.

![](static/documentation/images/image163_detrac.jpg)

1. Move forward a few frames and move the point to the desired position,
this way you will create a keyframe and intermediate frames will be drawn automatically.
You can work with this object as with an interpolated track: you can hide it using the ``Outside``,
move around keyframes, etc.

![](static/documentation/images/image165_detrac.jpg)

1. This way you'll get linear interpolation using the `` Points``.

![](static/documentation/images/gif013_detrac.gif)

## Annotation with cuboids

It is used to annotate 3 dimensional objects such as cars, boxes, etc...
Expand Down Expand Up @@ -1163,56 +1209,6 @@ Simply drag the faces to move them independently from the rest of the cuboid.

![](static/documentation/images/CuboidEditing2.gif)

## Annotation with points

### Points in annotation mode

It is used for face landmarks annotation etc.

Before starting, you have to be sure that ``Points`` is selected.

![](static/documentation/images/image042.jpg)

Press ``N`` for entering drawing mode. Now you can start annotating the necessary area.
Press ``N`` again for finishing marking an area. You can delete points
double-clicking them. Double-click with pressed ``Shift`` will open a points
shape editor. There you can create new points into existing shape. Also, you
can set fixed number of points in the "poly shape size" field, then drawing
will be stopped automatically. Points are automatically grouped — all points
will be considered linked between individual start and finish. You can zoom
in/out (when scrolling the mouse wheel) and move (when clicking the mouse
wheel and moving the mouse) while drawing. You can drag object after it has
been drawn and fix a position of individual points after finishing the object.
You can add/delete points after finishing.

![](static/documentation/images/image063.jpg)

### Linear interpolation with one point

You can use linear interpolation for points to annotate a moving object:

1. Before starting, you have to be sure that ``Points`` is selected.
1. Linear interpolation works only with one point, so you need to set ``Poly Shapes Size``: 1.
1. After that select the interpolation mode.

![](static/documentation/images/image122.jpg)

1. Press ``N`` or click ``Create Shape`` for entering drawing mode.
Click LMB to create a point and shape will be automatically completed.

![](static/documentation/images/gif011_DETRAC.gif)

1. Move forward a few frames and move the point to the desired position,
this way you will create a keyframe and intermediate frames will be drawn automatically.
You can work with this object as with an interpolated track: hide with help of ``Outside``,
move around keyframes, etc.

![](static/documentation/images/gif012_DETRAC.gif)

1. This way you'll get linear interpolation using `` Points``.

![](static/documentation/images/gif013_DETRAC.gif)

## Annotation with Auto Segmentation

Used to create a polygon semi-automatically. Before starting, you have to be
Expand Down