未验证 提交 6acf244d 编写于 作者: M Mariia Acoca 提交者: GitHub

Documentation for multitask updated (#5590)

上级 dfb65865
---
title: 'Create multi tasks'
linkTitle: 'Create multi tasks'
weight: 3
description: 'Step-by-step guide on how to create and set up multiple tasks'
---
Use **Create multi tasks** to create multiple video annotation tasks with the same configuration.
> The **Сreate multi tasks** feature is available for videos only.
To create the multi tasks, on the **Tasks** page click **+** and
select **Create multi tasks**.
![](/images/image254.jpg)
See:
- [Create multi tasks](#create-multi-tasks)
- [Example](#example)
- [Errors](#errors)
- [Advanced configuration](#advanced-configuration)
## Create multi tasks
To add several tasks in one go, open the task configurator:
![Multitack configurator](/images/multitask_configurator.png)
And specify the following parameters:
1. In the **Name** field, enter the name of the new task:
- Enter the name of the task. If the name includes more than one word, use the underscore: `Word1_word2_word3`
- (Optional) `{{index}}` adds an index to the file in the set (starting from 0).
- (Optional) `{{file_name}}` adds the file's name to the task's name.
> **Note:** use hyphen between three parameters: `Word1_word2_word3-{{index}}-{{file_name}}`
2. (Optional) From the **Projects** drop-down, select a project for the tasks.
<br>Leave this field empty if you do not want to assign tasks to any project.
![Select project](/images/image193.jpg)
> **Note:** Following steps are valid if the tasks do not belong to a project.
> <br>If the tasks have been assigned to a project, the project's labels will be applied to the tasks.
3. On the **Constructor** tab, click **Add label**.
4. In the **Label name** field, enter the name of the label.
5. (Optional) Select the color for the label.
6. (Optional) Click [**Add an attribute**](/docs/manual/basics/create_an_annotation_task/#add-an-attribute)
and set up its properties.
7. Click [**Select files**](/docs/manual/basics/create_an_annotation_task/#select-files)
to upload files for annotation.
> **Note:** You cannot upload multiple tasks from the cloud storage.
8. Click **Submit `N` tasks**
## Example
A step-by-step example for creating the multiple tasks:
1. In the **Name** field, enter the `Create_multitask-{{index}}-{{file_name}}`.
2. Add labels.
3. Select files. <br>In case there are more than four files,
only the total number of selected files will be displayed:
![](/images/image258.jpg)
4. Click **Submit `N` tasks**
![](/images/image257.jpg)
5. You will see a progress bar that shows the progress of the tasks being created:
![](/images/image259.jpg)
6. Click **Ok**.
![](/images/image260.jpg)
The result will look like the following:
![](/images/image261.jpg)
## Errors
During the process of adding multiple tasks, the following errors may occur:
<!--lint disable maximum-line-length-->
| Error | Description |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ![](/images/image262.jpg) | Wrong file format. You can add only video files. |
| ![](/images/image263.jpg) | In the process of creating a task, CVAT was not able to process the video file. <br>The name of the failed file will be displayed on the progress bar. <br><br> To fix this issue: <li> If you want to try again, click **Retry failed tasks**. <li> If you want to skip the file, click **OK**. |
<!--lint enable maximum-line-length-->
## Advanced configuration
Use advanced configuration to set additional parameters for the task
and customize it to meet specific needs or requirements.
For more information, see
[Advanced configuration](/docs/manual/basics/create_an_annotation_task/#advanced-configuration)
......@@ -14,7 +14,7 @@ select **Create new task**.
See:
- [Creating a task](#creating-a-task)
- [Create a task](#create-a-task)
- [Label shape](#label-shape)
- [Add an attribute](#add-an-attribute)
- [Select files](#select-files)
......@@ -22,7 +22,7 @@ See:
- [Data formats for a 3D task](#data-formats-for-a-3d-task)
- [Advanced configuration](#advanced-configuration)
## Creating a task
## Create a task
To create a new task, open task configurator:
......@@ -39,7 +39,7 @@ And specify the following parameters:
![Select project](/images/image193.jpg)
> **Note:** Followin steps are valid if the task does not belong to a project.
> **Note:** Following steps are valid if the task does not belong to a project.
> <br>If the task has been assigned to a project, the project's labels will be applied to the task.
3. On the **Constructor** tab, click **Add label**.
......
---
title: 'Creating multi tasks'
linkTitle: 'Creating multi tasks'
weight: 3
description: 'Instructions on how to create and configure multi tasks.'
---
In case when you have a few videos and you don't want to set up CVAT tasks one-by-one manually,
you can use the `multi tasks` option.
> This feature is available for videos only.
Create several tasks pressing `+` button and select `Create multi tasks` on the tasks page or on the project page.
![](/images/image254.jpg)
Specify the task parameters:
- In the `Name` text field, there is a template you can use for quick and simple task naming.
![](/images/image255.jpg)
In the template you can manage the following:
- some_text - any text that will be entered into the template will be the same for all created tasks.
- {{index}} - index file in set (sets a number of a task starting from 0).
- {{file_name}} - name of file (sets a task name from a filename).
You can find out a prompt by hovering the mouse over the text `When forming the name, a template is used`.
![](/images/image256.jpg)
- [Project](/docs/manual/basics/creating_an_annotation_task/#projects), [labels](/docs/manual/basics/creating_an_annotation_task/#labels), [select files](/docs/manual/basics/creating_an_annotation_task/#select-files) and [advanced configuration](/docs/manual/basics/creating_an_annotation_task/#advanced-configuration) are filled in the same way as when [creating an annotation task](/docs/manual/basics/creating_an_annotation_task/).
> It is not possible yet to use cloud storages for multi tasks creation.
![](/images/image257.jpg)
1. Let's specify in the `Name` field the `Road_annotation-{{index}}-{{file_name}}` string,
where `Road_annotation` is “any text” (let it match to the task type name). The task index number and the video file
name will be specified after it.
1. After selecting files, file names will be shown under the `Select files` section.
In case of there are more than 4 files, the total number of selected files will be displayed only.
![](/images/image258.jpg)
1. The `Submit` button indicates how many tasks will be created.
After clicking on the `Submit` button, information about tasks creation process will be displayed.
![](/images/image259.jpg)
If there were no errors during the process of creating tasks, we can complete this by clicking on `Ok`.
![](/images/image260.jpg)
This is how the created tasks will look like.
![](/images/image261.jpg)
## Errors
You can face with the following errors during multi tasks creation:
- If where were no video files selected, this warning will be shown.
![](/images/image262.jpg)
- If during tasks creation there was not possible to process with some videos,
the names of such videos will be displayed in the `Failed files` list. In this case, you can try
to create tasks for these videos one more time by clicking on the `Retry failed tasks` button,
or you can click on the `Ok` button to skip these videos.
![](/images/image263.jpg)
此差异由.gitattributes 抑制。
此差异由.gitattributes 抑制。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册