[TOC]
算法操作手册
1. 算法配置界面安装
1.1 下载算法前端配置界面
下载当前最新的版本,新版本都会兼容旧版本
目前支持Windows x86和x64操作系统,Ubuntu18.04 64位操作系统和MacOS
1.2 版本介绍
Portable代表纯净版,不包含算法
完整版集成了通用版本的箱号识别算法
1.3. 安装算法前端配置界面
一直下一步即可,直到安装完成
1.4.打开算法前端配置界面
- 目前支持箱号识别服务,视频拼接服务,自动验残服务,厂内车牌识别服务,多车牌识别服务,视频计数服务
集成了通用版本的箱号识别算法
2. 算法配置界面功能介绍
2.1 文件
2.1.1 新建通道功能
- tab页面在哪就对应的新建什么样的算法通道,如当前在箱号识别服务就是新建箱号通道。
- 新建通道只针对于服务器上没有安装过算法服务，如果服务器上已存在算法服务，会导致新建通道失败
详情配置信息见不同算法配置界面
新建通道，保存配置会在主界面生成一条通道配置信息，点击启动服务会将算法程序下发到服务器上，并启动算法服务
实时日志界面
2.1.2 更新通道
更新通道界面
- 服务器上安装过算法的，先更新通道，输入服务器的ip,用户名和密码,点击更新配置文件按钮
华为小站的SSH端口号默认为2222
2.1.3 清除数据
- 清空本地配置信息，斌不会删除服务器上的配置信息
- 主要用于使用自己的笔记本部署算法，切换到不同现场时，需要将本地的配置信息清空
2.1.4 清除服务
清除服务界面
- 清除服务器上安装的程序文件，并删除文件
- 停止服务器上所有运行的Docker容器，并删除容器
- 主要用于现场安装的算法服务版本较老，无法通过更新通道的方式获取服务器上安装的算法信息
2.1.5 退出程序
即程序退出功能
2.2 查看
2.2.1 箱号历史数据查询
查询箱号识别记录，必须先更新通道或新建通道之后，才可以查询箱号识别记录
箱号历史数据查询界面
- 通道名称: 可以根据配置的通道信息进行切换
- 可以根据时间段去查询箱号识别记录
- 运行脚本支持图片下载，视频下载，数据导出等
详情见过卡详情界面
2,2.2 云平台历史查询
云平台历史查询界面
- 配置云平台数据库信息，可以在算法配置客户端上直接查询云平台的过卡信息
- 运行脚本运行保存车牌图片，保存箱号图片，数据导出为excel等
- 支持筛选禁行条件，可以有多个禁行条件筛选，方便排查禁行原因
- 支持云平台记录直接匹配箱号记录，可以查看识别原图，和识别日志
详情见过卡详情界面
2.2.3 验残和车牌数据和其他查询
与箱号数据查询类似，其中云平台Lite指的就是云平台码头版本与云平台查询类似
2.3 功能
2.3.1 服务器测试工具
2.3.1.1 测试箱号识别服务
测试箱号识别服务界面
- 通过算法配置客户端所在机器向不同的通道服务发送请求，可以用来确认箱号服务是否正常
- 查看箱号识别结果，根据识别结果可以查看详情
- 可以模拟循环测试
- 也可以通过开始时间和结束时间来模拟测试
2.3.1.2 测试视频拼接服务
- 模拟没有车辆车辆进来信号和车辆离开信号拼接视频
2.3.1.3 测试视频计数服务
- 模拟计数开始和计数结束信号，开始计数算法
2.3.1.4 测试过卡数据
- 过卡数据库可视化
2.3.1.5 模拟21报文转发
- 转发卡口的0x21报文给视频拼接服务，或者其他服务
2.3.1.6 统计真实箱号和测试箱号通道
- 算法更新时，可以在现场直接新增一条测试通道，在正式通道上配置转发地址，将车辆进来信号转发给测试通道
- 测试通道的数据与正式通道的数据进行比对，查看新算法是否在识别率上有提升，不影响现场正常工作。
2.3.2 服务器设置工具
2.3.2.1 设置FTP工具
- 选择对应的服务器IP地址，将服务器上安装FTP服务，目前视频拼接服务必须要安装FTP服务。
2.3.2.2 磁盘清理工具
- 支持手动清理和安装自动清理服务自动清理
- 清理类型如果视频录制功能打开的话，根据现场走车清空，来自定义设置
2.3.2.3 加密狗工具
- 查看当前服务器上加密狗是否正常
- 在浏览器中查看加密狗的并发数是否遇到限制
2.3.2.4 时钟同步工具
- 支持将算法客户端运行的机器设置为时钟同步服务器(仅支持Windows端)
- 设置服务器的IP地址，将服务器的时间与本机时间进行同步，设置同步频率
2.3.2.5 重启加密狗工具
- 重启加密狗服务，相当于物理上将加密狗进行拔插
- 为了解决服务停止时，可能会存在锁不释放的问题，会导致服务重启时报加密狗异常的问题
2.3.2.6 升级加密狗驱动
- 解决算法服务启动过程遇到升级加密狗的问题处理
2.3.3 调试工具
2.3.3.1 相机调试工具
- 输入相机的ip，用户名和密码，点击测试连接出现相机实时画面页面
- 根据画面中出现的辅助线来调节相机的角度
2.3.3.2 网络调试工具
- 选择通道名称或所有通道，点击测试按钮
- 会测试该通道的所有网络设备的情况，包括服务器本身
网络测试详情界面
2.3.3.3 视频拼接管理服务
- 视频拼接管理服务是用来接受验残平台下发的视频拼接通道配置信息
- 统一由算法配置界面进行管理，无需在像之前在各个服务器上部署管理服务
3. 箱号识别服务部署
3.1 环境准备
3.2 箱号识别服务流程
- 分为箱号服务，箱号图像抓拍，箱号识别三个任务
3.2.1 箱号服务
主要工作，将实时识别过程中的识别记录，通过逻辑优化多个相机的识别结果，选取最优图片和最优结果组成一个完成的包并与前端通信。
如果配置的相机有三个，并且三个相机都获取到识别结果的话，则返回箱号识别结果，如果有一个相机没有识别结果，会继续等待直到满足最大超时时间，强制返回结果
如果空车超时时间内，没有抓拍到集装箱图片则会返回空车结果
3.2.2 箱号图像抓拍
- 接入相机实时流，进行箱门检测任务，抓拍到的箱门图片与箱号识别服务通信获取识别结果。
- 获取箱门信息，检测视频流中是否还有箱门信息
- 视频录制功能
- 集装箱的危险品检测
3.2.3 箱号识别
- 负责箱号图片的识别
3.3 箱号识别服务配置界面
参考算法配置界面的 新建通道
服务器ip地址: 箱号识别服务所需要安装的服务器地址
通道名称: 需要与云平台的通道名称保持一致
端口号: 通过该端口号区分同一台服务器上部署的多通道，并与卡口交互
是否返回识别错误的箱号: 默认是不返回识别错误的箱号，仅针对单箱的情况下
是否开启危化品检测: 识别结果返回危化品标志的检测
是否转发: 新增测试通道没有设备与之交互，可以将正式通道的信号转发给测试通道
设备类型参数: 默认(限于30显卡以下)，ONNX(30显卡及以上)，华为小站，博时特盒子，和P360(同方定制设备，Intel I7 Cpu重新编译)，默认的算法配置界面仅支持默认的设备类型，其他的需要在线更新或离线下载的方式，并根据设备类型的不同选择不一样的Docker镜像 更新操作
相机类型: 区分海康相机与大华相机
服务类型: 默认的服务类型为三宝科技，是传统WebService交互，车辆进来时就开始和箱号服务交互，并一直等待箱号识别服务返回识别结果，前端配置地址栏：显示的是以WSDL结尾的关键词，同方威视是与同方威视定制的协议，有车辆进来时间和车辆离开时间。新版三宝科技协议是目前再用的Http通讯协议: 卡口端以车辆离开为信号，并传入车辆进来的时间，通过多次请求，来访问箱号识别结果。
视频录制开关: 如果打开视频录制开关，需要注意磁盘的使用情况，将自动清理服务的时间缩短
区域限制: 如下图，红色的线就代表识别区域外，为了解决现场通道邻近，同时来车，会将临道的识别结果作为本次识别结果返回(也可以使用相机本身涂鸦功能，将区域外的地方进行涂鸦)
空车超时时间: 指的就是在14s内所有相机都没有抓拍到集装箱图片，则认定当前是空车，根据现场实际走车情况进行设置
最大超时时间：指的是在20s内有部分相机抓拍到集装箱图片或识别图片，不在等待其他相机识别结果直接返回识别结果给前端，如果现场普遍走车慢可以将此参数适当增大，最大超时时间一定要大于空车超时时间
异常结束时间冗余: 是指卡口没有车辆进来信号，发全0序列号，往前推移15s的数据，(目前是卡口日志上有全0序列号，但实际全没有和箱号交互)
向前冗余时间指的是收到车辆进来信号之前，往前在推移2s，防止侧面箱号在车辆进来之前就已经识别，如果是离开信号，则在偏移时间基础上再往前推移2s
固定箱数: 对于一些场站只存在拉一种箱子的情况，可以将固定箱数的值设为1，这样就不会存在误识别成双箱的问题
3.2.1 通讯协议的变化
新版三宝科技与三宝科技比较，优势在于可以过滤一部分的不规划行驶，如车压在车检器时间过长的问题，现在以车辆离开为请求开始时机，可以避免这种情况。如果这种不规范情况比较多，可以打开时间偏移参数，将开关关闭，这样就是在以车辆离开计时，一直到最大超时时间后结束，这一段的识别记录都会作为最后结果返回给前端。如果打开时间偏移参数，长时间压车检器的化，一收到请求就会立马返回结果，这样会缺少后箱号的图片。目前这个功能在金坛现场测试，后续这个开关就会默认关闭了。新版本加入心跳监测实时判断箱号服务运行是否正常。
3.4 箱号识别服务过卡详情界面
- 支持过卡视频查看:前提是配置了所有视频录制功能
- 支持过卡日志查看
- 支持保存过卡所有的图片
3.5 问题排查
3.5.1 日志查看
3.5.1.1 详情中查看过卡日志
点击过卡详情中的过卡日志，可以查看当前记录的过卡日志
可以手动修改到达时间和结束时间，根据时间去筛选日志，日志界面支持ctrp+F 搜索日志
3.5.1.2 详情中查看过卡日志
在主界面中点击查看历史日志
3.5.1.3 云平台中看日志
云平台历史查询
- docker.log 中记录了完整的日志
- info.log 记录了箱号服务的日志
- capture_log 记录了抓拍日志
- conta_ocr_log 记录了识别日志
3.5.2 常见问题
云平台识别标志显示异常:
1.1 无车辆进来信号，卡口没有和箱号服务交互
1.2 箱号识别服务异常: 可以通过测试工具去测试箱号服务是否在线
1.3 其他问题，
识别的问题
2.1 规范行驶的问题，有无跟车或长时间压车检器或停在通道中间等异常行为
2.2 检查箱子有无污损，如果没有抓拍图片则查看录制的视频，污损容易导致不识别或单箱识别成双箱
2.3 磁盘满， 安装自动清理服务
2.4 特定集装公司号，需要重新训练
2.5 软件运行出错，通过升级解决 检查更新
部署问题:
3.1 确保服务器正常运行
3.2 实时日志报错:
镜像不存在,请在帮助中点击镜像下载并安装
加密狗异常: 先停止服务，重启加密狗，在启动服务
升级加密狗驱动
4. 视频拼接服务部署
4.1 环境准备
4.2 启动视频拼接管理服务
点击启动视频拼接管理服务，这样就可以从验残平台中下发相机配置到算法配置界面中，不在由之前的每台服务器分别管理，由算法配置界面统一管理
4.3 视频拼接服务界面
接收到验残平台下发的配置信息并显示
点击启动即可完成视频拼接服务的启动
4.4 视频拼接服务配置界面
是否开启自动验残，开启自动验残需要配置正确的自动验残服务，如下图，选择自动验残服务，或者手动配置自动验残的ip地址和自动验残的端口号
其他参数均为默认无需修改。
5. 自动验残服务部署
5.1 自动验残服务界面
在自动验残服务中新建通道
5.2 自动验残服务配置界面
自动验残服务可以管多个视频拼接服务通道。
