coco-annotator的安装与使用

coco-annotator的安装与使用

1. coco-annotator是什么

COCO Annotator是一个基于web的图像标注工具，其多功能性和易用性旨在有效地标记图像，以创建用于图像定位和对象检测的训练数据。
它提供了许多不同的功能，包括标记图像片段（或片段的一部分）、跟踪对象实例、标记具有断开的可见部分的对象、以COCO 格式有效存储和导出标注信息。

2. coco-annotator可以做什么

COCO Annotator允许用户使用自由曲线或多边形对图像进行注释，并提供许多其他注释工具无法提供的附加功能。

• 直接导出为COCO格式
• 对象的分割
• 用于分析数据的有用 API 端点
• 导入已以 COCO 格式注释的数据集
• 标注断开的对象作为单个实例
• 同时用任意数量的标签标记图像片段
• 允许每个实例或对象的自定义元数据
• 魔术棒/选择工具
• 使用谷歌图片生成数据集

3. coco-annotator的安装

3.1 先决条件

目前，Docker 是唯一支持的安装方法。因此，为了使用coco-annotator构建 Docker 和 docker-compose 是必需的。

在Windows下安装docker容器可以参考这篇文章Docker容器—Windows下的安装与使用

3.2 coco-annotator的下载与安装

1. 在Windows终端中，进入要安装coco-annotator的文件路径下（如安装在E盘）。

   

2. 在此文件路径下使用git命令

   	git clone https://github.com/jsbroks/coco-annotator
   

3. 进入coco-annotator安装目录（根据具体安装的目录）

   	cd coco-annotator
   

4. 启用coco-annotator映像（首先运行Docker）

   	docker-compose up
   

   

5. 在浏览器中输入http://localhost:5000/，即可打开coco-annotator页面。

   

6. 停用coco-annotator

   	docker-compose down
   

4. coco-annotator的使用

4.1 创建用户

首次打开coco-annotator时，需要进行注册一个账户，用户权限自动为管理员模式。

• 用户权限
  • Admin：最高权限的用户
  • Owner：具体数据集的创建者
  • User：Admin或Owner与其共享数据集的账户

权限	User	Owner	Admin
查看图片	✔️	✔️	✔️
创建/编辑/删除注释	✔️	✔️	✔️
导入注释	✔️	✔️	✔️
分享/下载/删除数据集		✔️	✔️
添加/下载/删除图像		✔️	✔️
添加图片		✔️	✔️
修改其他用户数据集			✔️

• 在coco-annotator页面上方的导航栏中，单击Admin，可以在此创建用户，并选择是够给予管理员权限。
  

4.2 创建数据集

1. 创建数据集
   单击位于图块Create下方的绿色按钮。Dataset询问名称和类别的弹出窗口。给它一个唯一的名称，选择任何适用的类别（可以直接创建类别，也可以选择已经创建的类别），然后单击Create Dataset。

   

2. 导入图像
   添加图像需要找到coco-annotator安装根目录的数据集目录，在这个文件夹中，可以看到已创建的数据集名称的文件夹。
   只需要将图像放在相应的文件夹中即可将它们添加到数据集中。
   刷新一下coco-annotator页面，图像就会出现在数据集中了。
   这种导入图像的方式优点非常明显，可以轻松导入大型数据集，没有文件大小的限制，但是缺点就是必须要去访问运行coco-annotator的机器，这对于远程访问的用户来说就不那么方便了。

   

   如果一直刷新不出新添加的图像，可以数据集文件夹下新建一个子文件夹，将图像添加至子文件夹中再刷新。

4.3 标注图像

1. 创建标注
   通过单击+每个类别名称旁边的图标，它将在相应的部分中创建一个标注。可以使用眼睛图标来切换注释或类别的可见性。
2. 选择标注工具
   在左侧面板中选择要使用的标注工具。
3. 标注
   在某一对象的具体区域上进行标注，然后，重复这三个步骤，创建同一类别或不同类别的标注信息
   

4.4 下载标注信息

1. 在数据集左侧导航栏点击Export COCO，会弹出如下图中②号页面，选择要导出的类别，单击Export进行导出。然后，在上方二级导航栏中单击Exports，就会出现标注信息的下载信息，直接Download即可。

   

2. 若只需要下载单张图像的标注信息，可以进行以下操作。

   

5. coco-annotator远程访问

5.1 先决条件

如果需要远程访问一个机器运行的coco-annotator标注器，前提就是要允许外网访问自己的端口，在Windows中可以设置相应的入站规则。

1. 首先在控制面板中打开防火墙设置，点击高级设置。

   

2. 然后，依次选择入站规则和新建规则，要创建的规则为端口。

   

3. 最后，逐步进行每一项设置，开放端口为 5000 。

   

5.2 远程访问

首先，可以使用ipconfig命令查询一下自己的IP地址，将原本访问地址http://localhost:5000/中的localhost改为自己的IP地址。如果有公网IP，则外网可以访问，如果是局域网IP，则只能在局域网内访问，想要在外网访问还需要进行IP地址映射。

更多有关coco-annotator的信息，可以访问coco-annotator开源地址https://github.com/jsbroks/coco-annotator。