工具箱
======

Coovally 工具箱包含三大类工具：增强工具，转换工具，生成工具。可辅助用户生成高质量图像，多种标签文件类型转换，生成数据集分析报告等。
通过点击右上角的工具图标或者图像数据下左侧工具图标均可进入工具界面。

功能概览
--------

.. list-table:: 工具箱功能列表
   :header-rows: 1
   :widths: 20 30 50

   * - 增强工具
     - 转换工具
     - 生成工具
   * - 变换
     - VOC <-> COCO
     - 目标检测数据集分析报告生成
   * - 模糊变换
     - VOC <-> YOLO
     - 图像分类数据集分析报告生成
   * - 几何变换
     - COCO <-> YOLO
     - 分类数据集生成
   * - 裁剪变换
     - VOC <-> Labelme
     - VOC标签合并
   * - —
     - COCO <-> Labelme
     - 掩码图片生成
   * - —
     - —
     - 含标签图片生成

增强工具
--------

Coovally 提供4类增强工具且每类增强工具包含多种增强算法。用户使用增强工具对图像进行增强时可预览增强效果，下载增强处理后的图像。

**操作步骤**

点击所需的图像增强工具，打开增强页面 -> 上传待增强图像 -> 选择增强算法 -> 点击开始增强 -> 预览结果和下载增强图片。

.. image:: ../../img/coovally/tool_trans.png

转换工具
--------

Coovally 支持多种类型标签相互转换，如：VOC<->COCO、 VOC<->YOLO、VOC<->labelme、COCO <-> YOLO、COCO<->labelme（<->：双向转换符）。

**操作步骤**

step1：点击转换工具tab页，选择某种转换工具打开转换页面。

step2：上传样本集 、上传样本集标签 。

step3：输入标签映射字典、忽略类别（此两项输入为非必填项）。

step4：选择样本集图片后缀，点击开始转换，转换成功后可下载转换后样本集标签。

.. image:: ../../img/coovally/tool_labelconvert.png

**特殊转换—YOLO转VOC—操作步骤**

step1：点击转换工具tab页，点击YOLO转VOC打开转换页面。

step2：上传样本集、上传YOLO格式样本集标签、上传包含标签id名称映射关系的.txt 文件。

step3：输入标签映射字典、忽略类别（此两项输入为非必填项）。

step4:
选择样本集图片后缀，点击开始转换，转换成功后可下载转换后样本集标签。

.. image:: ../../img/coovally/tool_yolo2voc.png

生成工具
--------

Coovally 系统提供3大类共6种生成工具。

**数据统计分析**

目标检测数据集分析报告生成：系统可统计分析用户上传的VOC、COCO格式样本集（包含图片和标签）进行分析，生成图片和标签的分析报告。支持下载分析报告。

图像分类数据集分析报告生成：系统可统计分析用户上传的图像分类数据集并生成图片分类数据分析报告。

**标签转换**

分类数据集生成：系统可根据用户上传VOC格式样本集（包含图片和标签），将标注框中的内容从原图上裁剪出来，并生成分类图片数据集，用于将目标检测任务转换到图像分类任务。支持下载分类图片数据集。

VOC标签合并：系统可根据用户上传VOC格式标签，将标签中的类别合并到同一个类别，用于将多个目标合并为一个目标进行检测的任务。支持下载归一化后的数据集。

掩码图片生成：系统可根据用户上传COCO格式标签，将COCO标签中的Segmentation，以掩码的格式绘制到图片上，用于语义分割任务。支持下载生成的掩码图片。

**标注校验**

含标签图片生成：系统可根据用户上传的VOC格式样本集（包含图片和标签），将标签中的内容绘制到图片上，用于审查标注样本的正确性。支持下载绘制标签后的图片。