介绍一款改版的好用的labelimg

一 准备工作

1、服务器

硬件：GPU 2070以上显卡

操作系统：Linux系统

软件：Docker、Nividia-Docker

部署方式：Docker部署

2、客户端

操作系统：windows或者ubuntu

安装：免安装exe或可执行文件

网络需要和服务器端连接

二 软件使用说明

如上图所示，分为6个区，分别为：

A 软件基本信息区——展示软件基本信息，打开图片路径时，会显示当前打开的图片路径、图片序号以及图片张数；

B 功能菜单区——软件功能列表，包含文件、编辑、视图、帮助四部分；

C 功能快捷栏区——常用功能列表；

D 图片展示区——展示图片以及图上的标注框；

E 标注信息区——图片标注信息，包括该图片的所有标签信息，筛选等；

F 图片列表区——打开的图片路径下所有图片列表；

如上图所示，打开图片路径之后，各个区展示信息，下面对常用功能进行一一说明。

1、打开图片路径

单击功能快捷栏区打开图片路径或者文件——打开图片路径，并选中图片路径，点打开，左上角软件基本信息就会实时展示打开张数以及总张数，并打开第一张图片（图片路径顺序）；如果标注路径（参考选择保存路径）中有图片标注信息，将会在图片展示区展示标注信息，如下图所示；

2、选择保存路径

单击功能快捷栏区选择保存路径或者文件——选择保存路径，该路径为标注文件所在路径，简称为标注路径；当打开图片时，在标注路径下查询是否有该图片名称的标注文件（图片名称一样，扩展名不一样），若存在，自动展示标注信息，包括图片展示区中的标注框和右上角的标注信息展示区，若不存在，则不会展示；其中打开图片，包括上一张、下一张、打开图片路径等方式，都可视为打开图片，只是打开的图片不一样；

3、下一张(D)/上一张(A)

单击下一张或者敲键盘D，直接跳转到当前图片的下一张图片，更新图片展示区E中的图片和标注框，以及图片标注信息展示区的标注信息和软件基本信息区的图片路径、序号；同理，点上一张，也会更新相关信息；

4、创建标注(W)

单击创建标注或者敲键盘W，新增标注框，如下图所示，选择待标注区域和标签即可新增标注框；

5、复制标注

选中标注框，单击快捷栏区复制标注，或者右键选中复制标注，在当前位置形成一个完全一样的标注框，包括标签类别，然后拖拽移动，调整大小即可；

6、删除标注

选中标注框，单击快捷栏区删除标注或者右键选中删除标注，即可删除当前选中的标注框；

7、编辑标注

选中标注框，右键选中编辑标注，鼠标移动到标注框的左上角点或右下角点时，可以调整大小，选中中间时，可以调整位置，右键编辑标签，可以修改标签类别；

可以通过右上角的标签信息展示区，进行标签筛选，方便快速定位到对应的标签位置；

可以通过ctrl和鼠标滚轮，调整图片大小，方便标注；

8、智能识别

点击【智能识别】之后，会有下图所示弹窗。

服务器IP：默认为本机地址127.0.0.1。若是以链接服务器形式使用，请填写服务器IP！！！

服务器端口：（默认为8080）请修改为19008！！！

检测模型：sd_defect  默认为输电检测模型，若使用不同算法模型请注意修改！

检测深度：输电：56（仅有缺陷标签） 、5（除小金具以外的全部标签，用于标注），3（全部标签）；变电：1表示全部标签（含部分设备和正常），3表示只识别缺陷。

检测参数：基本不需要设定

检测图片，分三种情况：第一种，全量检测：把所选文件夹的图片全部识别标注；第二种，增量检测：把文件中没有XML的图片进行识别标注；第三种，当前图像识别：对当前这一张图片进行识别标注。

检测模式，分三种情况：第一种，根据图片名称检测：对于图片名称中所带有的某些名词进行选定类别进行识别；

名词：

引流线、地线、杆号牌、挂点、通道、塔头、塔全貌、塔身、塔基、绝缘子。（可以添加，见设置参数。）

第二种，完整缺陷类别检测：即对每一张图片进行全部缺陷检测；

第三种，指定关键词检测：即指定某个名词进行识别检测。

注：这个名词是选择设置参数中已经设定好的一个。

【保存中文标签】，对于输电缺陷，默认勾选的，直接生成标签后，所有的标签将会是中文显示，这个中文标签是可以直接更改的。

9、一键生成报告

点击【一键生成报告】，会有弹窗，如下图所示。

线路名称：默认会写入第一张图片名称，请注意修改确认。

杆塔号（起）：第一张图片，请注意修改确认。

杆塔号（止）：最后一张图片，请注意修改确认。

巡检班组/巡检人：可填可不填。

巡检时间：自行修改，默认2020-00-00

检测人：可填可不填，若设置了检测人员，会自动填入。

检测时间：默认读取电脑日期，可以修改。

报告保存位置：点击浏览，自行选择。

是否按照子文件夹生成报告：勾选之后，打开的图片目录下，每个子文件夹生成一个相应的报告。

以上完毕之后，即可点击生成报告。

【报告完成】会有弹窗（图2），请勿提前关闭。

提前关闭可能会导致当前【一键生成报告】功能错误。

生成的报告请以（Microsoft Office Word）查看，否则文档中会缺失图片超链接功能，如下图所示。

10、文件——重命名(唯一)

单击文件——重命名(唯一)，对当前打开的图片进行重命名，打开图片路径有多个子目录，且子目录下图片名称有重复时，可通过该功能，将图片名称唯一化，便于后期的图片识别，重命名完成后，弹出框如下，提示图片总张数，重命名张数；

11、文件——图片脱敏

单击文件——图片脱敏，对当前打开的图片进行脱敏，主要删除图片中GPS信息以及拍摄时间信息等；

12、文件——双盲标注比对

该功能主要用于双盲对照标注，即A、B两组人同时对一批图进行标注，标注文件分别为标注A文件夹和标注B文件夹，标注完成后，通过生成交集差集，然后分别置于标注交集文件夹和标注差集文件夹，然后由第三者对差集进行查看，判定A、B两组标签差异，并选择正确标签保留；然后通过合并交集差集按钮，形成新的标注文件，置于标注合并文件夹；

可以通过标注A统计，统计A组正确率，标注B统计，统计B组正确率，标注AB统计，统计A组和B组正确率；此处正确率包括标准框个数，漏检框、误检框个数；默认IoU大于0.5且标签类别相同即为正确，IoU阈值可通过界面IOU阈值(0-1之间)进行配置）；统计时，参考标准框为标注合并文件夹，可利用该功能进行标注准确率比较；

13、文件——设置参数

只针对输电缺陷检测，新增或修改识别字库对应的识别标签信息；当图片名称中包含该字库时，智能识别，检测模式选中”根据图片名称检测”，此时识别标签和阈值，根据该配置文件进行检测；

比如导入塔基，如上图所示，选中的标签有烟雾山火、冲刷坍塌滑坡、杂物堆积、沉降取土、其他基础类缺陷，对应的阈值分别为0.4, 0.4, 0.4, 0.4, 0.6，可通过该功能进行修改，比如新增或删除待修改标签类别及检测阈值修改；当智能检测，检测模式选中”根据图片名称检测”，时，图片名称中含有字库“塔基”时如”***_塔基.jpg”，只检测以上选中的标签类别，且检测阈值超过设定阈值，才定义为缺陷；对于有多个关键字库的图片名称，识别标签进行叠加；

14、文件——选择展示标签

单击文件——选择展示标签，弹出框如上，选中ok弹出框，如下，每个标签都可查看标签数量以及相应的图片数量，比如dachicun_fzc_xs(2/3)表示共计2张图出现3个dachicun_fzc_xs标签，可以勾选相应的标签对图片进行过滤；

未标注标签表示没有标注图片数量，仅表示有图片但在标注路径下没有相应的xml文件的图片数量；空标注表示有标注文件，但是标注文件中没有标签；仅预选标签表示只勾选预选的标签，其中预选标签通过编辑—切换预选标签进行切换；仅非预选标签，选中所有不在预选标签中的图片，不包含空标注和未标注；

15、文件——分类别统计标签数量

该功能主要用于标注人员统计标签数量，单击之后，弹出框如下，选择位置，保存结果为excel，包含标注图片与未标注图片数量，各个标签图片数量和标签数量；

16、文件——根据业务区分图片

该功能主要用于收集地市提供的样本，并按照业务进行分类拷贝，比如输电的样本放到输电文件夹下等，分类文件参考./data/sub_business_dict，单击之后，弹出框如下，前缀表示图片名称新增前缀名称，比如福州局提供的样本，图片名称改为，福州_***.jpg；本功能，会将图片扩展名统一改为jpg格式，方便后续自动标注；

17、文件——分类别另存为

根据标签类别进行图片分类，可根据需要选择标签进行保存；需要手动选择标签保存位置；汇总保存，表示将选中标签对应的图片汇总到一起进行保存，其中重复的图片只保存一次；

18、文件——批量修改标签

主要用于标签修改，当某个标签需要改名称时，可通过该功能进行修改，如下图所示；

19、文件——MD5剔重

该功能主要用于标注人员进行标注之前，防止图片重复标注，需要通过该功能进行剔重，即图片一样，但名称不一样均可剔除；如果有历史标注图片，需要选择之前图片生成的原MD5文件，若想本次生成MD5文件，需要选择新MD5文件(手动创建一个空txt文件)；需要手动选择图片删除目录，自动在该目录下创建两个文件夹JPEGImagesMD5和AnnotationsMD5，分别用于存放删除的图片和标注文件；

20、文件——查看删除图片目录

如下图所示，默认打开删除目录和MD5剔重删除目录一致；

21、文件——删除图片

单击该功能，直接删除当前图片以及相应的标注文件，删除位置为删除图片目录；

22、编辑——切换预选标签

切换预选标签，通过浏览按钮选择默认的标签类别，比如输电、变电等，默认标签类别保存位置在‘./data/predefined_labels’,可通过手动增删改插该文件夹下的标签列表，从而实现不同标签类型的标签列表设置；

23、编辑——检测人员

用于责任定位，输入之后，标注文件会留有该人员名称；

24、视图——自动保存模式

单击之后，若左侧有个对号，表明已选中，否则未选中；选中之后，标注文件修改时，不需要保存，否则会提示有修改，是否保存，如下图所示；

25、视图——深度显示模式

选中深度显示模式，右上角标注信息区会跟随改变，显示中文标签名称，同时会显示检测置信度，且该模式下，无法进行标注信息修改；对于线夹倾斜或均压环倾斜，如果能检测到直线，会显示倾斜角度(90°为正常角度)；

26、视图——高阈值检测

选中后，会采用data/name2classes1中的阈值进行检测，该目录下的阈值一般配置会更高；

27、视图——显示标签名称

选中后，图片展示区不仅展示标签框，也展示标签名称；

28、平台——同步

同步功能用于数据库初始化，即已有分类标注完成的图片和标注文件，纳入数据库进行管理，该功能只能用于存储服务器端，即原有数据纳入管理；图片删除目录，主要用于MD5重复的图片进行删除，图片大小超过100M也将会删除；

初始化图片和标注文件分别为当前加载的图片和标注文件，即打开图片路径下的图片，选择保存路径下的标注文件；原则上，为了方便管理，图片文件和标注文件，所在上一级为图片类别目录，如图中所示，JPEGImages上一级目录为1输电，和图片类别一致；主要方便后续新增图片时，自动匹配到该目录；

29、平台——新增

“平台——新增”功能和“文件——根据业务区分图片”功能一致，主要增加了数据库更新功能，省份默认为福建，地市可选填；前缀表示修改图片名称，即在图片名称前面增加前缀；图片备注指本次新增的图片flag；标签备注指本次新增的标签flag，主要用于后续条件下载；该功能只能用于存储服务器端；

目标目录的结构类似于下图，包含输电、变电等，该目录可以为空，新增时将会自动创建；

源目录结构类似于下图，其路径中包含关键字，比如输电、变电等，具体可参考./data/sub_business_dict，如果图片有标注，需要将图片和标注文件放在同一目录下；

30、平台——分组

“平台——分组”功能主要对当前打开的图片进行分组，其分组号保存于数据库，主要方便后续标注，比如一批图片1万张，标注人员10人，那么可以将其分为10组，每组1000张，将会自动形成分组，没人选择一组下载标注；该功能只能用于存储服务器端；

开始分组前，需要点测试数据库，进行数据库连接；是否重新分组，勾上将会对该类别下所有数据进行重新分组，否则只对新增的图片，没有分组号的图片进行分组；

31、平台——统计

“平台——统计”功能主要用于标注文件统计，包括上传图中张数，有效图片张数，剔重图片张数，标注图片张数，未标注图片张数；标签个数，标签图片张数，空白标注图片数目等；

32、平台——分组下载

“平台——下载”主要用于各标注人员本地电脑，通过该功能下载分配的标注分组图片，进行标注；

开始下载之前，需要测试连接，完成测试连接后，可选择分组，当选分组时，状态栏会显示该分组下图片张数，以及标注文件个数；标注人员不能同时下载同一个标注分组；

33、平台——分组上传

“平台——上传”功能主要用于标注人员完成标注功能之后，上传标注文件；

开始上传之前，需要点测试连接，然后选择分组，标签备注主要用于给本次上传的标签打一个flag，比如精标；

当前目录下图片没有包含全部所选分组下的图片时，会进行提示，一般出现该情况主要是因为下载图片后，标注时，发现图片模糊直接删除了，服务器端该分组下的图片相比于本地标注图片，会多出删除的图片；当图片数量差距较大时，请注意是否选择了错误分组；如下图所示；

34、平台——条件下载

根据选定的筛选条件选择图片和标注文件下载到本地，条件包括类别、地市、图片备注、标签备注、所选标签、图片上传时间区间；下载前需要测试连接；

下载时会自动在保存文件夹内保存一个图片名列表文件download_imglist.txt文件，方便后续条件上传；

35、平台——条件上传

该功能和分组上传类似，唯一区别在于分组上传图片列表是通过指定分组号获取，而条件上传图片列表是通过指定图片列表download_imglist.txt文件获取；

36、帮助——版本

展示软件版本信息

37、帮助——查看日志

查看日志信息，主要查看双盲对照标注时的比对信息；可通过清除日志，清空日志信息；

38、帮助——模型开关

单击后，弹出框如上，服务器IP和服务器端口，需要设置为当前连接的服务器信息；单击显示所有模型，如下图所示，显示服务器所有部署的模型信息以及是否开关信息；勾选相应模型，通过设置模型开关按钮，对相应模型进行开关；

39、帮助——模型上传

对需要更新或者上传的模型进行上传，文件路径指的是待上传模型压缩包(Zip包)；

40、帮助——秘钥上传

用于模型部署前，上传秘钥，如下图所示；