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与其共享数据集的账户

权限UserOwner****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。