mitre/biqt

NOTICE

This software (or technical data) was produced for the U. S. Government under contract, and is subject to the Rights in Data-General Clause 52.227-14, Alt. IV (DEC 2007)

(C) 2019 The MITRE Corporation. All Rights Reserved. Approved for Public Release; Distribution Unlimited. Public Release Case Number 18-0812.

概述

生物特征图像质量工具包（BIQT）是一个可扩展的生物特征图像质量评估框架。它提供厂商无关的接口，通过该接口可将新的模态和算法集成到框架中，同时还提供高级Quality API，用于将框架集成到更大的系统中。

快速开始

使用Docker Hub上托管的https://hub.docker.com/r/mitre/biqt%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8F%AF%E8%AE%BF%E9%97%AE%E9%A2%84%E9%85%8D%E7%BD%AE%E7%9A%84CentOS 7环境及BIQT命令行界面。该镜像包含BIQTIris和BIQTFace提供程序。

以下基于Linux的示例展示如何启动mitre/biqt容器，以访问和使用主机文件系统中/path/to/biometric/images目录下存储的生物特征图像：

bash
user@localhost:~/$ docker run --rm -v /path/to/images:/data -it mitre/biqt
[root@66d3679381d0 /]# biqt -m iris iris-image-001.png 

安装

该框架支持Windows 10和CentOS Linux 7.4系统。

Docker、CentOS Linux 7.4和Windows 10的构建与安装说明可参见INSTALL.md。

集成提供程序

BIQT框架可轻松扩展以集成额外的质量库。通常，提供程序必须符合以下要求：

• 提供程序必须包含descriptor.json文件，以便向用户传达提供程序的元数据。
• 提供程序必须安装到$BIQT_HOME/providers（Linux）或%BIQT_HOME%/providers（Windows）目录。
• 提供程序目录名称、提供程序库名称以及提供程序描述符中指定的名称必须一致。

设置新提供程序

setup_provider.py Python脚本可生成包含模板文件的目录结构，作为新提供程序的基础。以下示例演示如何生成名为MyNewProvider的新提供程序。

CentOS Linux 7.4

python $BIQT_HOME/scripts/setup_provider.py MyNewProvider

Windows 10

python %BIQT_HOME%/scripts/setup_provider.py MyNewProvider

在上述示例中，脚本会在当前目录创建名为MyNewProvider的目录，并填充最小化的描述符、头文件、代码文件和CMakeLists.txt。这些文件中的TODO元素指示必须处理的部分。

实现后，可使用以下命令构建提供程序并将其安装到框架中。注意，BIQT框架必须已安装，且必须设置BIQT_HOME环境变量。

CentOS Linux 7.4

bash
cd ~/MyProvider
mkdir build
cd build
cmake3 -DCMAKE_BUILD_TYPE=Release ..
make
make install

Windows 10

cd C:\Users\user\MyProvider
mkdir build
cd build
cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release ..
nmake
nmake install

相关资源

GitHub上提供了面部和虹膜图像的参考图像质量库：

• https://github.com/mitre/biqt-face
• https://github.com/mitre/biqt-iris