图像标注工具 semantic-segmentation-editor 的安装与使用

图像标注工具 semantic-segmentation-editor 的安装与使用

此工具主要用于深度学习数据集的制作，最终生成文件格式为json。

一、下载与安装

1. 打 开 网 页 ： https://github.com/Hitachi-Automotive-And-Industry-Lab/semanticsegmentation-editor，点击“Download Zip”，如图，把 zip 文件解压后放在某个文件夹下，如：“D:\Utilities\semantic-segmentation-editor” 。
   

2. 安装 chocolatey 和 meteor。
   以管理员身份打开 PowerShell，如图。
   
   在网页 https://chocolatey.org/install 复制命令行（如图所示），粘贴在 PowerShell 的命令行执行，如果没有错误出现则 chocolatey 安装成功。
   
   然后执行安装 meteor 命令：choco install meteor

3. 安装 32-位的 7-zip 软件, 安装包见下载资源, 然后找到可执行文件 7z.exe，如图所示。
   
   把它复制到以下的位置，替换 meteor 自带的 7z.exe，如图所示，这里需要修改成你自己的用户名。

4. 运行 semantic-segmentation-editor。
   使用 cd 进入 semantic-segmentation-editor 的文件路径下，执行命令：
   
   第一次运行 meteor npm start 可能要花很长的时间下载软件包，可以使用 ctr+c 终止命令，按如下的方法解决：
   
   在其他路径下执行 meteor update，然后回到项目路径下再执行 meteor update

二、启动编辑器

首先在 semantic-segmentation-editor 路径下打开配置文件 settings.json，修改要标注的图片文件夹的位置，如图所示。

以管理员身份启动 PowerShell，执行命令行 meteor npm start，启动可能需要几分钟，
然后用网页浏览器打开本地主机的地址： http://localhost:3000/，启动过程如图所示。

下图是编辑器启动后显示图片的页面，这里显示了设定文件夹下的内容。如果某个图像的右上角有个标志，表明该图片被标注处理过。点击某个图片开始标注操作。

三、使用要点

1. 多边形轮廓工具（P）
   
   创建一个点：点击鼠标左键
   快速创建轮廓：Shfit + 按鼠标左键移动
   完成轮廓：Enter 键自动闭合最后点和起始点

2. 魔术工具（A）
   
   使用灰度门限值自动生成轮廓
   这个工具适用于目标边缘轮廓与背景的对比度很强的情况（如：天空，车道）
   使用右边栏的调节滑动条可以改变轮廓，Enter 键完成轮廓

3. 操作工具（Alt）
   
   该功能对创建的多边形进行选取、移动、增加轮廓点

   点击轮廓内部选取该轮廓
   点击一个点选取该点，进行移动和删除
   在廓边上增加点，拖之则改变轮廓形状
   如果一个点属于一个以上的多边形轮廓，Shift+鼠标移动可以把该点从其的轮廓中分离出来

4. 裁剪/扩展工具（C）
   
   修改多边形轮廓的形状
   在某一多边形轮廓内，从某个轮廓点开始拉条直线到另一个点，把该多边形轮廓内分成两部分，大的部分被保留小的被删除

5. 输出标注结果
   
   点击右上角的输出图标，标注的结果以 json 文件的格式在一个新的浏览网页中显示，通过复制和粘贴保存结果到相应的文件里。

6. 返回
   
   按网页的返回按键，回到编辑器显示图片的页面，点击下一张图片开始标注操作。