数据标注
========

数据标注的主要作用是对文本、图像、语音、视频等原始数据进行归类、整理、编辑、纠错、标记和批注等操作，为原始数据增加标签，生产满足机器学习训练要求的机器可读数据编码。常见的数据标注类型有分类标注、框图标注、区域识别标注、描点标注等。

Coovally系统中标注涵盖2个模块样本管理、\ :doc:`标注 <./smart_annotation>`。主要功能如下: 

* 样本管理: 新建样本集；样本集删除、发布、下载；样本集标签管理；成员管理；标注任务管理。

* 标注: 四边形&多边形标注(新增标注，编辑标注，删除标注)；预标注；外观设置。

样本管理
--------

样本集: 原始数据集 (原始数据集 + 标签 = 数据集)

点击Coovally官网顶部导航栏标注\ |icon|\ 按钮，打开样本集管理页。用户可点击创建样本集按钮新建样本集；输入查询文本查询目标样本集；勾选单个/多个样本集发布；点击某目标样本集末端操作按钮进入样本集详情页、样本集统计页面；下载或删除此样本集…

.. image:: ../../img/labeling/sample_manage01.png

新建样本集
~~~~~~~~~~

方式一: 上传图片压缩包新建

   Step1: 样本集管理页 点击 创建样本集打开样本集创建弹窗

   Step2: 点击本地上传按钮

   Step3: 输入样本集基本信息并上传图片压缩包

.. image:: ../../img/labeling/sample_create01.png

方式二: 上传视频文件抽帧新建

   Step1: 样本集管理页 点击 创建样本集打开样本集创建弹窗

   Step2: 点击本地上传tab切按钮

   Step2: 输入样本集基本信息并上传视频文件

.. image:: ../../img/labeling/sample_create02.png

方式三: 数据集导入新建

   Step1: 样本集管理页 点击 创建样本集打开样本集创建弹窗

   Step2: 点击数据集导入tab切按钮

   Step2: 选择导入的数据集及其他数据信息

.. image:: ../../img/labeling/sample_create03.png

注意: 

* 创建样本集弹窗，用户可点击创建标签右侧的新增按钮向当前创建的样本集中创建标签，或点击创建标签下方的下拉选择框选择已有数据集中的标签为当前创建的样本集创建。

* 创建样本集弹窗，用户可点击参与者右侧的新增按钮向当前创建样本集中添加成员。

* 创建样本集弹窗，用户可选择是否分组(有序分组 & 无序分组)并设置分组数量。若未开启分组样本集创建时系统将仅为此样本集创建一个标注任务，若开启分组样本集创建时系统将根据设置的分组数量将样本集图片划分并创建多个标注任务。

样本集统计
~~~~~~~~~~

样本集管理页，点击某样本集末端统计按钮打开样本集统计页面，可总览样本集标注人员分配的任务完成情况 & 样本集已标注数据中标签占比情况。

.. image:: ../../img/labeling/sample_manage02.png

样本集发布
~~~~~~~~~~

Step1: 样本集管理页勾选单个或多个样本集并单击发布按钮。

Step2: 发布弹窗，选择发布生成新的数据集(选择任务类型 &
设置数据集拆分比例)/ 选择发布到已有数据集 (选择已有数据集 &
已有数据集下的某COCO标签 & 设置数据集拆分比例)。

Step3: 点击确定完成发布。

.. image:: ../../img/labeling/sample_public.png

注意: 

* 用户仅可发布所有标注任务状态为已完成的样本集。
* 目前系统仅支持发布目标检测类&实例分割类数据集。
* 当样本集中存在疑问样本，此样本集则暂不可被删除。

样本集详情
----------

样本集管理页，点击某目标样本集名称进入此样本集详情页。用户在此页面可编辑样本集基本信息、下载样本集、上传标注、预览并管理疑问样本；还可管理样本集标签、样本集成员，样本集标注任务。

.. image:: ../../img/labeling/sample_detailmanage.png

样本集标签管理
~~~~~~~~~~~~~~

**创建标签**

方式一: 

Step1: 点击创建标签按钮打开创建标签弹窗。

Step2: 点击新增标签右侧新增按钮并输入标签名称、描述并选择标签颜色。

Step3: 点击确定按钮完成标签创建。

.. image:: ../../img/labeling/sample_label01.png

方式二: 

Step1: 点击标签模块的操作按钮并点击导入标签选项。

Step2: 上传标签文件并确定完成导入标签文件新建标签。

.. image:: ../../img/labeling/sample_label02.png

**标签更改&删除**

点击目标标签的更改图标，打开标签编辑弹窗可更改标签名称、描述和标签颜色。

点击目标标签的删除图片并二次确认删除后可删除此标签。

.. image:: ../../img/labeling/sample_label03.png

**标签导出**

Step1: 点击标签模块的操作按钮并点击导出标签选项。

Step2: 选择需要导出的标签并点击确定按钮完成导出。

.. image:: ../../img/labeling/sample_label04.png

注意: 

-  用户不可删除已被使用的标签。

样本集成员管理
~~~~~~~~~~~~~~

样本集详情页，点击操作 -
成员管理按钮打开成员管理弹窗，用户可向样本集中新增成员、更改样本集成员角色、移除样本集成员。

**新增成员**

成员管理弹窗，点击新增按钮 -
输入成员邮箱并点击确定完成向样本集中新增成员。 |annotation|

**更改成员角色**

成员管理弹窗，点击某样本集成员的角色下拉框更换选择并点击确定完成样本集某成员角色的更改。

**移除成员**

成员管理弹窗，点击某样本集成员的删除按钮完成移除某样本集成员。 |image1|

**角色说明**

Coovally 系统标注模块 用户角色分为 管理者 & 标注者。某样本集标注者和样本集管理者对此样本集的权限区别如下: 

====== ========== ========== ========== ======== ======== ============
—      发布样本集 编辑样本集 删除样本集 标签管理 成员管理 标注任务管理
====== ========== ========== ========== ======== ======== ============
管理者 √          √          √          √        √        √
标注者 X          X          X          仅可使用 不可见   仅可标注
====== ========== ========== ========== ======== ======== ============

注意: 

* 若某成员已分配标注任务时，则暂不可移除此成员。
* 样本集管理员不可更改样本集创建者角色也不可移除样本集创建者。

疑问样本管理
~~~~~~~~~~~~

样本集详情页，用户可点击操作 - 疑问样本打开疑问样本管理页。
用户在此页面可查询特定名称的疑问样本图片、批量取消标记图片为疑问样本、可下载所有的疑问样本。

.. image:: ../../img/labeling/sample_issue.png

标注任务管理
~~~~~~~~~~~~

样本集详情页，用户可点击创建任务按钮创建标注任务、删除某标注任务、选择单个或多个标注任务发布生成数据集或更新到已有数据集、分配并审核标注任务，也可点击详情按钮进入任务详情页预览、删除任务中的图片，处理疑问图片。

.. image:: ../../img/labeling/sample_task01.png

**创建任务**

点击创建任务按钮打开创建任务弹窗 -
设置分组，上传图片压缩包并点击确定完成任务创建。

.. image:: ../../img/labeling/sample_task02.png

**分配任务**

点击目标标注任务分配选择下拉框，选择/更换样本集成员。完成分配标注任务给某样本集成员或更换某标注任务的标注人员。

.. image:: ../../img/labeling/sample_task03.png

当标注人员完成标注后，可将标注任务的状态更改为 “待审核”
移交给管理员审核(当状态为待审核后，标注者不可再次对此任务进行标注)。

**标注任务审核**

管理员将标注任务中所有图片审核后，判定此标注任务标注的不合格需标注者重新标注时，可更改此标注任务的状态为待修改；若判定此标注任务标注的合格，可更改此标注任务的状态为已完成。

注意: 

* 仅样本集管理员有审核权限(审核权限: 将任务状态更改为待修改/已完成)。

* 标注人员仅可见已分配给自己的未标注的/标注中的/待审核的/待修改的标注任务，对状态为已完成的任务不再可见。

* 管理员暂不可移除已分配任务的成员。

**标注任务发布**

Step1: 样本集详情页，勾选单个或多个已完成状态的标注任务并点击发布按钮打开发布弹窗。

Step2: 选择发布生成新的数据集(选择任务类型 & 设置数据集拆分比例)/
选择发布到已有数据集 (选择已有数据集 & 已有数据集下的某COCO标签 &
设置数据集拆分比例)。

Step3: 点击确定完成发布。

.. image:: ../../img/labeling/sample_public.png

注意: 

-  用户仅可发布状态为已完成的标注任务。
-  目前仅支持用户发布生成目标检测类&实例分割类数据集或发布到已存在的目标检测类&实例分割类数据集的COCO标签。

:doc:`如何标注？ <./smart_annotation>`

.. |icon| image:: ../../img/labeling/icon/labeling.png
.. |annotation| image:: ../../img/labeling/sample_user01.png
.. |image1| image:: ../../img/labeling/sample_user02.png