类圆颗粒分割与识别

一款android手机应用-相机及颗粒检测
 
1. 安装
默认用户接收到的是一个名字：ATCamera-V1.37_F.APK的文件。
请使用数据线，拷贝到手机端某一目录下，如：download目录，然后在手机端文件管理中，进入到目录，点击后，开始安装。

1. 启动
   系统启动后的初始界面如下图（图2.1初始界面）所示：

   
   图2.1初始界面
    

2. 注册
   安装后，首次运行，默认是未经授权的，未经授权的该应用，仅仅是一个多功能相机，仅在获得授权后，方可开启颗粒检测功能。

 注册
参见下图（图3.1系统设置）所示：

图3.1系统设置

 点击如图红框所示按钮，进入到系统设置界面，所见如下图（图3.2系统注册）所示：

图3.2系统注册
 
 点击图3.2系统注册中红框所示选项（选择注册条项），点击进入申请与注册界面，详情参见下图（图3.3条码生成）所示：

图3.3条码生成

 点击生成条码右侧开关组件，则系统自动生成申请所需的条码，并显示在相应条码框中，参见下图（图3.4）所示：

图3.4申请码生成

备注：
1. 申请码，是用户端自动生成，用于标记本机身份的唯一标识；
2. 注册码，是供应商依据申请码，制作的用于用户获得相应软件使用权限的标识；
3. 申请码的本地存储路径，一般在:..\内部存储\DCIM\ATCamera\Barcode目录下；
4. 接收到的注册码，建议同样放置在如条3. 所指明的目录下;
5. 申请码，命名为ATA.JPG;
6. 注册码，命名为ATR.JPG,注意注册过程，不要导入错误。
 
 手指长按申请码条码图像，系统将分享当前条码（用于分享给系统供应商，以获取注册条码），效果如下（图3.5分享条码）：

图3.5分享注册条码
系统供应商，收到申请条码后，会制作注册条码，并回发给用户；每次条码申请与注册，有效时间终止在当天24小时前，且每次的注册条码，仅可使用一次，即行作废。

当用户接收到供应商发回的注册条码后，存放位置，参见第4页备注部分。

 手指点击注册码区域，系统将进入图片选择界面，用于选择收到的注册条码，并显示注册码在相应位置。
参见下图（图3.6导入注册码）所示：

图3.6导入注册码

 手指长按注册码条码图像，完成注册
注册过程中，界面呈现短暂的圆形进度指示。

备注：
1. 注册过程，可能会因设备不同，出现注册不成功现象；
2. 注册结果，会提示成功与否：参见图3.7注册提示所示的红色方框区域（因提示是短时效果，故截图不便，特再次图文说明之）；
3. 若注册成功，再次的尝试注册，将会提示失败，但结果并不影响以前的成功注册；
4. 注册失败时，系统会提供文字输入注册方式，参见图3.8注册失败所示中绿色框；此时，手指长按该绿色框区域，系统会将系统剪贴板中的注册信息，粘贴进所示文本框，参见3.9文本注册所示；
5. 第4步骤完成后，手指长按注册码图像，完成注册（该步骤是复用功能）。

图3.7注册提示

图3.8注册失败

图3.9文本注册

上述图3.7、3.8、3.9中，红色方框为注册提示，会根据注册结果，提示：注册成功、或者注册失败；
绿色方框，为注册失败时，条码控件弹出的文本粘贴控件；若条码注册失败，此文本控件才会出现，请向服务方提出说明，得到注册的文字码后，手指长按此区域，粘贴注册文本码到此，如图3.9文本注册所示；
后续的操作，长按注册条码图像，完成注册-注册的结果，同样会在红色方框区域提示。
 
 验证注册
逐步返回，直到显示最初启动界面，参见第3页，图3.2系统注册界面。

图3.10图像后处理
比较第3页图3.2系统注册与上图区别，完成注册的系统，此处出现了图像后处理参数配置条项……

至此，系统完成了注册流程！

备注：
1. 部分设备，因屏幕密度适配问题，可能导致条码识别失败，若发现此情况，敬请及时联系，以便增补遗漏；
2. 原来验证注册，需要返回到起始界面并重新进入设置界面，增加动态管理后，仅需返回前一界面即可。
 
4. 参数初步设置
使用后处理功能，建议不要设置太高的图像分辨率。
本章节，涉及一些相机公共功能的设置，这里仅简要说明关于分辨率的设置。

图4.1相机设置
 参见上图（图4.1相机设置）红框所示，点击进入相机常用参数设置界面，如下图：

图4.2常规相机参数
调节红框中左右箭头，选择符合本机相机的合适参数，一般地，图像大小，接近1MB即可，如图4.2所示。

太高的分辨率，对于图像处理来说，太占内存，特别是手机APP；其次，不同的分辨率，对于图像中，存在的物体粒度，影响很大，会使得后处理的参数取值，差异很大。

 后处理参数
后处理参数，是本系统颗粒物体检测的关键，设置的进入方式，参见下图：

图4.3后处理参数

点击红框中条项，系统将进入后处理参数设置界面，后处理参数，工包含11项。
其中，包含有3项细节粒度参数、4项多参数组件、以及2组开关选项等，详细的介绍，请结合使用章节了解。

后处理参数界面如下图，这里仅做个概要的印象：

图4.4后处理参数概览

参见上图，图4.4后处理参数概览，形象化的阐述了后处理参数包含有五个部分：
 自动删除
 后处理插件
 十字线
 自动检测
 监控外部应用

其中，自动删除：拍照图像或者来自全局截图的临时图像，分析完成后直接删除；该部分，用户可开可关，受影响的仅仅是否删除图片，以节省空间。

图4.5后处理参数（一）

图4.6后处理参数（二）

图4.7后处理参数（三）

图4.5后处理参数（一）、图4.6后处理参数（二）及图4.7后处理参数（三），介绍后处理插件部分，其中：
 物体半径：颗粒物体的大小
 极限算子：检测算法极限算子
 模糊算子：检测算法模糊算子
 物体中心点间距：颗粒物体可分割距离算子
 参数索引值：多组参数索引
 半径偏差：上述参数误差范围
 尺度空间：尺度空间参数，该值不建议动
 缩放：缩放最大值，可决定后处理界面双击、双指缩放率
 预设左右裁剪值：分析界面预设伪裁剪左右参数
 预设上下裁剪值：分析界面预设伪裁剪上下参数
 尺寸：栅格单格实际像素值，参见后文使用时的说明
 外圆：是否对检测的结果显示外部圆形轮廓
 圆点大小：检测结果的质心点大小
 圆点颜色：检测结果的质心点颜色
 外圆颜色：外部圆形轮廓颜色
 增补点颜色：手动增补遗漏使用的区别于自动检测的质心点颜色

图4.8自动检测设置

图4.9外部应用监测设置

图4.8自动检测设置，其中：
 自动检测物体半径参数，根据选择点周边像素偏差值，自动计算半径值

图4.9外部应用监测设置，其中：
 监控应用：参见后文使用时说明
 监控位置：参见后文使用时说明
 全局截图：在第三方应用不具备截图功能时开启
 悬浮窗：用于第三方应用界面过度复杂时开启
 操作按钮：用于截图界面中，是否出现确认等按钮
 最近存储区域：开启时会自动保存矩形信息，方便下次使用

图4.10十字线设置

图4.11十字线厚度

图4.12十字线颜色

图4.10、图4.11及图4.12，描述后处理界面显示十字线部分，用于明确四个象限，便于分区快人工辨识结果及增补遗漏，其中：
 十字线 ：开关项，决定是否显示中心十字线
 十字线厚度：画十字线的画笔的厚度
 十字线颜色：画十字线的画笔的颜色

图4.13开启十字线界面效果

1. 使用后处理功能
   除了后处理，系统就是一个移动端相机；因此，除了简单的参数设置，其他的相机功能，敬请用户自己研究下使用方法。
   使用后处理颗粒检测，除来自直接拍照取得图像外，还有直接使用图库图像的方式-此部分，一般仅作为调节参数使用；实际的应用过程，还是更得益于直接拍照取得图像。

   
   图5.1拍照
    上图（图5.1）中：
   1所示，是拍照使能按钮，点击即可拍照；也可以在参数设置中，自定义手势动作，作为拍照的快捷功能键；
   2所示，是使用手机系统图库入口点；用户可以在此进入，选择已有的图片，直接加载进后处理，进行测试验证工作（注意：当开启第三方应用监控时，原系统图库替换为启动应用功能，若同时开启了全局截图开关，则允许进入截图界面，悬浮窗开关决定了是直接进入截图界面，还是通过点击悬浮窗后再进入截图界面）。
   后续的说明，图像后处理部分，对上述拍照获取、以及外部打开的图像，是一致的。
    取得图像后，系统自动进入后处理界面，参见下图：
   
   图5.2后处理界面
   图中：
    红色方框，指示图像显示区；在后处理参数中，可以设置放大倍率；
    绿色数字，指示可裁剪区域的8个自由度；缺省加载图像后，裁剪区等于实际的图像区（等效于无裁剪）
    紫色方框，是常用调节参数，可结合参数设置部分了解；
    紫色椭圆，指示系统网格，用于大致了解物体的大小；关于网格的使用，请参阅参数设置部分，对于网格单元大小的指示；
    黄色圆角方框，开启上图直接计算分析；关闭以调试参数；
    绿色方框，是多组参数的切换索引键值；系统默认可保存三组参数；
    黄色框中，指示分析结果；同时点击该框区域，将返回拍照界面；也可以直接使用手机返回键，返回到拍照界面；（注意：当开启第三方应用监控时，该功能替换为应用前台化功能，若同时开启了全局截图开关，则同时进入截图界面）。
    红色椭圆，点击将启动分析；

 裁剪操作
本系统裁剪操作，并不执行实际的图像裁剪，但在实际处理过程中，处理的是裁剪有效区的子图像；一方面，可以减小处理区域，加快速度；其次，减小因拍照不便可能拍到的无效、或对分析结果能够产生影响的噪声图像。

图5.3 图像裁剪

参见图5.3及结合图5.2中，关于裁剪区的8个自由度，调节合适的裁剪区；
系统采用了对称调节模式，当您调节任何一个自由度时，对称的相关自由度，会相应跟着调整，以减少操作步骤；
例如：当左边界，向右方向调整时，其相应的对称自由度（右边界），会同步向左方向调整；此处细节，请亲身操作以贴身领会之。
 
 执行分析
执行分析后，原有的裁剪区标识，将自动消失，以免影响结果观察；但最初设置的裁剪区域是实际存在的，多次的分析动作，将重复使用同一裁剪区域。

图5.4分析结果示意

 在分析界面，实时调节参数值，将直接保存在索引键值指示的注册表中
如图5.4中，实时改变的CDN、CAO、MDC的参数值，将保存在索引键值为1的注册表里；

注意：
若要针对不同的物体粒度，在保存参数值时，请记得：合理选择索引值，千万不要调试着后面，覆盖了前面保存好的参数!
 
 使用系统网格，大致测量CDN值
为了在标定阶段，准确确定CDN数值，可以使用该功能；使用方法如下：

参见左图：
当选择分辨率为4DP时，每个栅格的像素尺寸为12像素-这点务必注意，在测量界面，测量的实际像素值，和此有密切关系。

图5.5网格设置

参见左图，在测量界面，开启了网格测量功能。
结合图5.5的设置部分的单位换算，在此，我们计数图中红色圆内物体所占的网格数量：大概是4格半，估计，则，该图的CDN = 4.5 * 12 / 2 = 27
大概在27左右，你则可以把检测的CDN初步设置为27，后面再做进一步的细节调整即可。

图5.6网格测量
 不精确结果手动增减操作
任何的机器视觉检测，相对于人眼来说，机器并非完全智能的-虽然当下的人工智能，诸如自动驾驶、人脸识别、车牌识别等，甚或ALPHAGO围棋对决，获得了一定的进展，但在颗粒计数方向，似乎没看到99.9%的、如黄金纯度那样的准确率的，难道仅仅是课题太小吗？

下面结合图示，说明手工增减的操作，参见下图：

图5.7手动增减

上图中，可以看到，漏检出1个颗粒，对类似不精确结果，这时，就要用到手动增减来弥补。
 

图5.8适当缩放

图5.9增减示意

比较图5.8和图5.9，图5.8适当缩放，以使得图像更易于手动标记，在手机上，实际就是一些手势动作，具体到此处，就是手指轻触（类似电脑上的鼠标点击），操作如下：
1. 轻点漏点则新增的检测到的圆心以蓝色点标识；参见图5.9，三个蓝色圆心部分；
2. 轻点多出点，则原有的点，马上消失；参见图5.9中，最下面的白点；
3. 图5.9，第2.演示，实际非多出点，此处仅为演示；
4. 图5.9，第3.所述演示，实际非多出点，在此可以理解为误操作-那么，此时再次点该点，此点将重新标记，但是是以红色圆心标记，表示检出点的误操作复原；
5. 对于漏点，增加检出后，若认为有误，再次轻点，同样可以消除掉；
6. 上述5步操作描述，请自己体验几次，实践中领会。

 远程分析
在实际的使用中，就有用户提出，远程操作理念，大概是使用远程设备（可以是手机拍照、电脑驱动的摄像头拍照等）现场拍照，用具备后处理功能的手机（一台拍照，另一台分析），做后台分析，这样的故事场景。
经实际验证，ATCamera程序，具备该服务提供功能，具体的操作步骤，描述如下：
A. 先开启ATCamera程序，保持不关闭（类似最小化）；
B. 打开图库，选中图片（第一次会提示选择打开的程序，按步骤设置用ATCamera，永远）；
C. 打开，然后直接进入分析界面，分析操作如在ATCamera中操作；
D. 点返回，直接返回系统图库，再选其他，则重复3的步骤。
备注：
如上所述，远程操作，必然会涉及远程网络传输，这就对速度提出了一定的要求，那么适当的缩小拍照的图片分辨率，保证充分的网络传输带宽，都是保障最小时间内，得到结果的一种措施。
另外，使用分析端移动设备的全局截图功能，或者第三方应用接收远程分享图片，内含截图功能，则可以使用其截图，保存在分析端SD卡中，然后加载分析，也不失为面向市场快速产品化的一种方案。
 远程使用场景分析
后续改善过程中，有需求指出，使用一款远程看图工具，在其界面中，使用其内部的截图功能，保存图片在当前手机某个目录下；为此，后续部分，将就因需而增加的涉及配置、功能点及操作步骤，描述如下：
A. 设 置：
设置部分，新增加七个选项，参见下图：

监控目录-开关项，开启后，该新增功能起作用，默认开启；
其下属六个选项：
1. 一个是监控应用，主要用于分析完成后，原来的返回拍照界面，在此使得直接返回第三方应用的截图界面；
2. 另一个是监控位置，指定监控的第三方截图软件，存放截图的具体目录；
3. 全局截图开关，是针对第三方应用，不具备截图功能时，本系统自备的全局截图功能开关；
4. 悬浮窗开关，是针对第三方应用，界面选图比较复杂、且需要在第三方应用内存在多步操作（全局截图窗口，覆盖其他一切，会影响窗口下第三方应用的操作）；
5. 操作按钮，显示或隐藏截图界面确认等按钮；
6. 最近区域存储，是简化操作，对于固定的截图界面、选区简略化的预设。

图5.10 监控设置
 
当点击监控应用选项时，弹出的用户界面如下图：

缺省是没有选择项的，图中是结合用户选择的一款掌上看家软件；
该功能将列出手机上安装的所有第三方应用，有助于用户去明确标定使用软件，选项的有效设置，将在后处理分析完成后，通过点击分析总数界面区，返回到当前指定的应用，并将其显示在前端。
参阅图5.2部分，关于返回功能的描述。

图5.11 监控应用界面

当点击监控位置选项时，弹出的用户界面如下图：

没有设置的初始界面如左图，列出了可能的第三方应用使用的数据目录。
你可以点击父文件夹区域，使得目录路径向上返回一级；也可以直接在下面的子目录中，选择正确的文件目录。

图5.12 监控位置界面

左图是结合掌上看家软件，分析其存储截屏位置后的具体设置，涉及其他应用，敬请具体分析后，合理配置。

图5.13 根下两级子目录

B. 操 作：
本部分的操作描述，原则上是对前面部分的扩充，并不影响原有后处理分析的操作流程。
这里仅描述差异部分：
1. 第三方（掌上看家）截图后，直接把图显示在分析界面-等效ATCAamera原来的拍照分析和打开本机图片分析（注意：无限拍应用，本身不具备截图功能，请参见图5.10 监控设置部分描述）；
2. 分析结束后，处理返回操作，直接把第三方（掌上看家）调到前台，便于连续截图操作；
3. 重复1.2.步骤，实现连续不间断作业。
 
 预裁剪
预裁剪是对前述裁剪功能的扩充，对于一些可重复的、需要裁剪的部分，使用固定的预设值使能裁剪。

图5.14预裁剪配置

图5.15设置预裁剪

图5.16设置效果

参见上述三图，分别就配置选项、设置对话框以及设置效果进行了图示；下图-图5.17展示了使用预裁剪后的最终效果。

图5.17预裁剪效果

 自动检测半径
该功能主要满足移动镜头因距离不同，导致的产生的截图图像中，待检测的物体的大小，存在连续不一致问题。

图5.18自动检测参数

图5.19自动检测设置

参见上述二图，分别就配置选项、设置对话框进行了图示；下图-图5.20等展示了使用流程之区别。

图5.20初始加载

图5.21适当放大

图5.22自动检测后

结合上述三图，简要描述下开启自动检测半径的流程：
图5.20初始加载-显示图像刚刚打开时的状态，相比较于没有开启该功能界面，区别在于：没有了预裁剪的调节框；
图5.21适当放大-适当放大图像，有助于精准选择一个单独的物体，此时，请手指轻触一个（最佳是完全独立的物体中心点，避免泛洪填充时的粘连）屏幕点，程序马上开始检测，并显示检测结果，参见图5.22自动检测后；
图5.22自动检测后-此图就恢复到以前没开启自动检测前的状态，初始加载的图像，自适应窗口显示、显示预裁剪调节框；后续的操作，就和原来的流程一样了；
见图，区别的地方表现在：
1. 图5.22中，最上面的物体，存在一绿色的方框（检测结果图示）；
2. 图5.22中，半径参数，已经用检测的值取代（注意和图5.21中的同参数比较）；

备注：
1. 通过开启和关闭参数设置中的自动检测项，来开启和关闭此功能；
2. 关闭该功能后，分析流程，和最初一致；
3. 色度偏差值，属于调节检测灵敏度；
4. 因选择点的不同，检测的半径，存在精度误差，实际的分析结果，可能与原来流程的误差较大，请选择性的使用该功能。
 
6. 全局截图
全局截图功能，是对第5部分之远程分析的补充和增强（参见本说明第19页相关描述），在选择市场支持远程的第三方应用中，有的应用本身支持截图功能，而有的不支持，但却对图像的支持功能更好（诸如无限拍应用VS掌上看家应用），基于此，应用户需求，增加此功能。
参数设置部分，敬请参见第5部分之远程远程使用场景分析（图5.10应用监控界面）部分，新增加了三个功能选择开关，此处不做重复赘述。

 启动应用开启截图
参见第5部分之使用后处理功能章节，见图5.1（注意：当开启第三方应用监控时，原系统图库替换为启动应用功能，若同时开启了全局截图开关，则允许进入截图界面，悬浮窗开关决定了是直接进入截图界面，还是通过点击悬浮窗后再进入截图界面）之备注部分，结合设置参数开关。

图6.1初始界面

图6.2选择图像

图6.3开始截图

上述图6.1、图6.2、图6.3等三幅图示，阐述了开启的过程，详细的介绍，描述如下：
图6.1，是点击原系统图库按钮后，程序启动第三方应用无限拍，启动成功后的初始界面（启动过程，可能还存在其他的提示界面，请合理处理），此时，若打开了悬浮窗开关，则悬浮窗显示-悬浮窗是开启截图的功能按钮（用于处理第三方应用界面元素的复杂性）；若没有打开悬浮窗开关，则初始界面，类似图6.3，假设，选择的远程拍照应用，可以更合适的显示我们需要的截图界面（如图6.1的无限拍，这样的界面，是不适合直接截图的）。

图6.2，是在无限拍中，点击一副图片缩略图后，进入图像细节界面的图示，这样的界面，截取的图像，是适合后期分析处理的。

图6.3所示，是在图6.2的基础上，点击红框的悬浮窗后的结果；此时，依据截图界面提示，“在屏幕手画区域截图”也好，使用“点我截取全屏”，依据需要选择。
 
 截图与后处理分析
这部分的处理，就和程序原有的后处理分析，完整的对接起来了。

图6.4手画区域

图6.5首次系统提示

图6.6后处理分析

上述图6.4、图6.5、图6.6等三幅图示，阐述了截图与后处理分析的过程，详细的介绍，描述如下：
图6.4，就是手动在屏幕画出矩形选择区的效果，对此处理，可以放弃，也可以接受，还可以在屏幕上点击四个边角的色点调节大小，也可以点住区域中的非边角点位置，移动整个选择区，以使得截图的效果最为理想（程序设置确认和放弃的步骤，就是为了完美）。
其次，若在系统设置中，开启了“最近区域存储”开关，参见图6.7使用最近存储选区；则系统会在确认截图时，保存这个画出的区域，下次使用时，从图6.2到图6.4的情形，则会跳过图6.3，直接出现图6.4的效果，但原图6.4中的放弃按钮，会被系统替换为复位按钮（复位按钮，是恢复到：重新需要手动画区域）。

图6.7使用最近存储选区

点击接受（若关闭操作按钮，则此点击被忽略），首次使用，系统将进入图6.5所示。
备注：
若在设置中，关闭了操纵按钮开关，则保存最近区域开关也将关闭；
操纵按钮开关关闭后，图6.4出现的时间很短，且图6.4将不出现确认与取消按钮，四个边角的调节点也不会出现，矩形区域不可调节也不可移动；
图6.7也将不会出现；且每次都需要手动画出截图矩形。

图6.5，是安卓系统处于安全考虑的提示，勾选不再显示后，以后的过程，图6.5将不再出现，直接进入到图6.6界面；否则，截图过程会重复出现图6.5所示的提示。

图6.6，看看，多么熟悉的后处理分析界面啊，此处不再赘述；但需要注意的是：原有的返回将重复分析的流程，在操作时，结合此处讲述，将回到图6.2所示（这属于安卓系统的功能）；当然，怎样从图6.2回到图6.1，或者直接在图6.2中，左右滑动选择其他的图，考虑受无限拍应用的制约，请酌情考虑。

 完整流程
综合上述的描述，全局截图，已经与原有的后处理分析，完整的对接。
如前所述，使用开启悬浮窗或不开启悬浮窗，取决于被截图应用的界面复杂度（诚如深圳产品的演示效果，若是存在更合适的第三方应用，则我们的流程，会比较深圳产品，流程更流畅）。

注意：
启用全局截图功能，涉及到本机暂存保存图像需求，这些暂存的图像，会在下次程序重启时，全部清除，以保持手机存储空间可用！
因此，在设置界面，指定监控目录时，区别于掌上看家看图端（需要指定掌上看家截图的存储目录），这里建议指定一空的目录，以防误删除有用的内容！
另，本次增加的启动时清除监控目录功能，只要是监控目录指定的目录，启动时都会进行清除，同样适合对掌上看家应用指定的监控目录！

新增功能及改进
1. 新增条码注册失败时，补充文本粘贴完成注册功能；
2. 新增图像分析后，总数求数字4的余数给你，格式：N：000 M：000；
3. 新增分析裁剪预设，分上下与左右，可以对分析的图像使用设定的裁剪；
4. 分析界面，极限参数调节的最大值，由原来的30调整到50；
5. 参数设置界面，放大倍率缺省值，由原来的2.5调整为3.0；
6. 修正放大倍数默认值；
7. 增加自动检测物体半径功能；
8. 增加第7条之参数设置部分；
9. 增加按天数授权许可功能；
10. 系统设置部分，针对部分开关子项，增加动态收缩/扩展功能；
11. 增加全局截图功能，支持画矩形并自动重复使用该矩形；
12. 当开启外部APP监控时，原拍照UI之画廊按钮，起到打开外部APP功能；
13. 部分参数设置项，界面增加自动显示参数选择结果；
14. 增加显示与隐藏操作按钮选项；
15. 后处理参数部分，增加点、圆、增补点的大小、颜色，以及是否显示外圆轮廓等参数
16. 增加界面显示十字线功能，及对应的参数设置；
17. 修改部分中文翻译，以使文字表意更贴切；
18. 增加开关项。有选择的上图直接分析；
19. 删除闪屏界面，优化启动速度及启动预览窗口；
20. 注册成功即动态管理后处理参数设置项，不必如以前，需逐级返回并重新进入参数设置界面；
21. 为监控第三方应用截图，建立临时目录；