|
|
|
|
@ -7,19 +7,22 @@ weight: 2
|
|
|
|
|
1. Create an annotation task pressing `Create new task` button on the tasks page or on the project page.
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
2. Specify parameters of the task:
|
|
|
|
|
1. Specify parameters of the task:
|
|
|
|
|
|
|
|
|
|
#### Basic configuration
|
|
|
|
|
## Basic configuration
|
|
|
|
|
|
|
|
|
|
**Name** The name of the task to be created.
|
|
|
|
|
### Name
|
|
|
|
|
The name of the task to be created.
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
**Projects** The project that this task will be related with.
|
|
|
|
|
### Projects
|
|
|
|
|
The project that this task will be related with.
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
**Labels**. There are two ways of working with labels (available only if the task is not related to the project):
|
|
|
|
|
### Labels
|
|
|
|
|
There are two ways of working with labels (available only if the task is not related to the project):
|
|
|
|
|
|
|
|
|
|
- The `Constructor` is a simple way to add and adjust labels. To add a new label click the `Add label` button.
|
|
|
|
|

|
|
|
|
|
@ -35,19 +38,19 @@ weight: 2
|
|
|
|
|
The following actions are available here:
|
|
|
|
|
|
|
|
|
|
1. Set the attribute’s name.
|
|
|
|
|
2. Choose the way to display the attribute:
|
|
|
|
|
1. Choose the way to display the attribute:
|
|
|
|
|
- Select — drop down list of value
|
|
|
|
|
- Radio — is used when it is necessary to choose just one option out of few suggested.
|
|
|
|
|
- Checkbox — is used when it is necessary to choose any number of options out of suggested.
|
|
|
|
|
- Text — is used when an attribute is entered as a text.
|
|
|
|
|
- Number — is used when an attribute is entered as a number.
|
|
|
|
|
3. Set values for the attribute. The values could be separated by pressing `Enter`.
|
|
|
|
|
1. Set values for the attribute. The values could be separated by pressing `Enter`.
|
|
|
|
|
The entered value is displayed as a separate element which could be deleted
|
|
|
|
|
by pressing `Backspace` or clicking the close button (x).
|
|
|
|
|
If the specified way of displaying the attribute is Text or Number,
|
|
|
|
|
the entered value will be displayed as text by default (e.g. you can specify the text format).
|
|
|
|
|
4. Checkbox `Mutable` determines if an attribute would be changed frame to frame.
|
|
|
|
|
5. You can delete the attribute by clicking the close button (x).
|
|
|
|
|
1. Checkbox `Mutable` determines if an attribute would be changed frame to frame.
|
|
|
|
|
1. You can delete the attribute by clicking the close button (x).
|
|
|
|
|
|
|
|
|
|
Click the `Continue` button to add more labels.
|
|
|
|
|
If you need to cancel adding a label - press the `Cancel` button.
|
|
|
|
|
@ -62,7 +65,8 @@ weight: 2
|
|
|
|
|
|
|
|
|
|
In `Raw` and `Constructor` mode, you can press the `Copy` button to copy the list of labels.
|
|
|
|
|
|
|
|
|
|
**Select files**. Press tab `My computer` to choose some files for annotation from your PC.
|
|
|
|
|
### Select files
|
|
|
|
|
Press tab `My computer` to choose some files for annotation from your PC.
|
|
|
|
|
If you select tab `Connected file share` you can choose files for annotation from your network.
|
|
|
|
|
If you select ` Remote source` , you'll see a field where you can enter a list of URLs (one URL per line).
|
|
|
|
|
If you upload a video or dataset with images and select `Use cache` option, you can attach a `manifest.jsonl` file.
|
|
|
|
|
@ -70,22 +74,67 @@ weight: 2
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
#### Advanced configuration
|
|
|
|
|
### Data formats for a 3D task
|
|
|
|
|
|
|
|
|
|
To create a 3D task, you need to use the following directory structures:
|
|
|
|
|
{{< tabpane >}}
|
|
|
|
|
{{< tab header="Velodyne" >}}
|
|
|
|
|
VELODYNE FORMAT
|
|
|
|
|
Structure:
|
|
|
|
|
velodyne_points/
|
|
|
|
|
data/
|
|
|
|
|
image_01.bin
|
|
|
|
|
IMAGE_00 # unknown dirname, Generally image_01.png can be under IMAGE_00, IMAGE_01, IMAGE_02, IMAGE_03, etc
|
|
|
|
|
data/
|
|
|
|
|
image_01.png
|
|
|
|
|
{{< /tab >}}
|
|
|
|
|
{{< tab header="3D pointcloud" >}}
|
|
|
|
|
3D POINTCLOUD DATA FORMAT
|
|
|
|
|
Structure:
|
|
|
|
|
pointcloud/
|
|
|
|
|
00001.pcd
|
|
|
|
|
related_images/
|
|
|
|
|
00001_pcd/
|
|
|
|
|
image_01.png # or any other image
|
|
|
|
|
{{< /tab >}}
|
|
|
|
|
{{< tab header="3D Option 1" >}}
|
|
|
|
|
3D, DEFAULT DATAFORMAT Option 1
|
|
|
|
|
Structure:
|
|
|
|
|
data/
|
|
|
|
|
image.pcd
|
|
|
|
|
image.png
|
|
|
|
|
{{< /tab >}}
|
|
|
|
|
{{< tab header="3D Option 2" >}}
|
|
|
|
|
3D, DEFAULT DATAFORMAT Option 2
|
|
|
|
|
Structure:
|
|
|
|
|
data/
|
|
|
|
|
image_1/
|
|
|
|
|
image_1.pcd
|
|
|
|
|
context_1.png # or any other name
|
|
|
|
|
context_2.jpg
|
|
|
|
|
{{< /tab >}}
|
|
|
|
|
{{< /tabpane >}}
|
|
|
|
|
|
|
|
|
|
## Advanced configuration
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
**Use zip chunks**. Force to use zip chunks as compressed data. Actual for videos only.
|
|
|
|
|
### Use zip chunks
|
|
|
|
|
Force to use zip chunks as compressed data. Actual for videos only.
|
|
|
|
|
|
|
|
|
|
**Use cache**. Defines how to work with data. Select the checkbox to switch to the "on-the-fly data processing",
|
|
|
|
|
### Use cache
|
|
|
|
|
Defines how to work with data. Select the checkbox to switch to the "on-the-fly data processing",
|
|
|
|
|
which will reduce the task creation time (by preparing chunks when requests are received)
|
|
|
|
|
and store data in a cache of limited size with a policy of evicting less popular items.
|
|
|
|
|
See more [here](/docs/manual/advanced/data_on_fly/).
|
|
|
|
|
|
|
|
|
|
**Image Quality**. Use this option to specify quality of uploaded images.
|
|
|
|
|
### Image Quality
|
|
|
|
|
Use this option to specify quality of uploaded images.
|
|
|
|
|
The option helps to load high resolution datasets faster.
|
|
|
|
|
Use the value from `5` (almost completely compressed images) to `100` (not compressed images).
|
|
|
|
|
|
|
|
|
|
**Overlap Size**. Use this option to make overlapped segments.
|
|
|
|
|
## Overlap Size
|
|
|
|
|
Use this option to make overlapped segments.
|
|
|
|
|
The option makes tracks continuous from one segment into another.
|
|
|
|
|
Use it for interpolation mode. There are several options for using the parameter:
|
|
|
|
|
|
|
|
|
|
@ -107,19 +156,24 @@ weight: 2
|
|
|
|
|
Polygons, polylines, points don't support automatic merge on overlapped segments
|
|
|
|
|
even the overlap parameter isn't zero and match between corresponding shapes on adjacent segments is perfect.
|
|
|
|
|
|
|
|
|
|
**Segment size**. Use this option to divide a huge dataset into a few smaller segments.
|
|
|
|
|
### Segment size
|
|
|
|
|
Use this option to divide a huge dataset into a few smaller segments.
|
|
|
|
|
For example, one job cannot be annotated by several labelers (it isn't supported).
|
|
|
|
|
Thus using "segment size" you can create several jobs for the same annotation task.
|
|
|
|
|
It will help you to parallel data annotation process.
|
|
|
|
|
|
|
|
|
|
**Start frame**. Frame from which video in task begins.
|
|
|
|
|
### Start frame
|
|
|
|
|
Frame from which video in task begins.
|
|
|
|
|
|
|
|
|
|
**Stop frame**. Frame on which video in task ends.
|
|
|
|
|
### Stop frame
|
|
|
|
|
Frame on which video in task ends.
|
|
|
|
|
|
|
|
|
|
**Frame Step**. Use this option to filter video frames.
|
|
|
|
|
### Frame Step
|
|
|
|
|
Use this option to filter video frames.
|
|
|
|
|
For example, enter `25` to leave every twenty fifth frame in the video or every twenty fifth image.
|
|
|
|
|
|
|
|
|
|
**Chunk size**. Defines a number of frames to be packed in a chunk when send from client to server.
|
|
|
|
|
### Chunk size
|
|
|
|
|
Defines a number of frames to be packed in a chunk when send from client to server.
|
|
|
|
|
Server defines automatically if empty.
|
|
|
|
|
|
|
|
|
|
Recommended values:
|
|
|
|
|
@ -129,7 +183,8 @@ weight: 2
|
|
|
|
|
- 4k or less: 4 - 8
|
|
|
|
|
- More: 1 - 4
|
|
|
|
|
|
|
|
|
|
**Dataset Repository**. URL link of the repository optionally specifies the path to the repository for storage
|
|
|
|
|
### Dataset Repository
|
|
|
|
|
URL link of the repository optionally specifies the path to the repository for storage
|
|
|
|
|
(`default: annotation / <dump_file_name> .zip`).
|
|
|
|
|
The .zip and .xml file extension of annotation are supported.
|
|
|
|
|
Field format: `URL [PATH]` example: `https://github.com/project/repos.git [1/2/3/4/annotation.xml]`
|
|
|
|
|
@ -142,17 +197,19 @@ weight: 2
|
|
|
|
|
|
|
|
|
|
The task will be highlighted in red after creation if annotation isn't synchronized with the repository.
|
|
|
|
|
|
|
|
|
|
**Use LFS**. If the annotation file is large, you can create a repository with
|
|
|
|
|
### Use LFS
|
|
|
|
|
If the annotation file is large, you can create a repository with
|
|
|
|
|
[LFS](https://git-lfs.github.com/) support.
|
|
|
|
|
|
|
|
|
|
**Issue tracker**. Specify full issue tracker's URL if it's necessary.
|
|
|
|
|
### Issue tracker
|
|
|
|
|
Specify full issue tracker's URL if it's necessary.
|
|
|
|
|
|
|
|
|
|
Push `Submit` button and it will be added into the list of annotation tasks.
|
|
|
|
|
Then, the created task will be displayed on a tasks page:
|
|
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
3. The tasks page contains elements and each of them relates to a separate task. They are sorted in creation order.
|
|
|
|
|
1. The tasks page contains elements and each of them relates to a separate task. They are sorted in creation order.
|
|
|
|
|
Each element contains: task name, preview, progress bar, button `Open`, and menu `Actions`.
|
|
|
|
|
Each button is responsible for a in menu `Actions` specific function:
|
|
|
|
|
|
|
|
|
|
@ -172,8 +229,12 @@ weight: 2
|
|
|
|
|
- [MOT](https://motchallenge.net/)
|
|
|
|
|
- [LabelMe 3.0](http://labelme.csail.mit.edu/Release3.0/)
|
|
|
|
|
- [Datumaro](https://github.com/openvinotoolkit/cvat/tree/develop/cvat/apps/dataset_manager/formats/datumaro)
|
|
|
|
|
- Point Cloud Format 1.0 (Available in 3d task)
|
|
|
|
|
- Velodyn points format 1.0 (Available in 3d task)
|
|
|
|
|
- `Upload annotation` is available in the same formats as in `Dump annotation`.
|
|
|
|
|
- [CVAT](/docs/manual/advanced/xml_format/) accepts both video and image sub-formats.
|
|
|
|
|
- Point Cloud Format 1.0 (Available in 3d task)
|
|
|
|
|
- Velodyn points format 1.0 (Available in 3d task)
|
|
|
|
|
- `Automatic Annotation` — automatic annotation with OpenVINO toolkit.
|
|
|
|
|
Presence depends on how you build CVAT instance.
|
|
|
|
|
- `Move to project` — Moving the task to the project (can be used to move a task from one project to another).
|
|
|
|
|
@ -182,4 +243,6 @@ weight: 2
|
|
|
|
|
Some task labels can be matched with the target project labels.
|
|
|
|
|
- `Delete` — delete task.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Push `Open` button to go to [task details](/docs/manual/basics/task-details/).
|
|
|
|
|
|