Releases: usnistgov/NFIQ2
v2.3.0
About
Alignment with the second edition of the Finger Image Data biometric sample quality standard, ISO/IEC 29794-4:2024.
Notable Details
[CHG]
API alignment with ISO/IEC 29794-1:2024 terminology[CHG]
Random forest model has been retrained after fixing bugs[NEW]
ISO/IEC 39794-2:2023 quality block computation[NEW]
Support for Ubuntu 22.04 LTS, 24.04 LTS[NEW]
CBEFF identifier constants[FIX]
Several code defects from first edition, including block size[FIX]
Update third-party libs, including OpenCV, to latest versions at time of publication[FIX]
Debug builds under Windows using development libraries
Full Changelog: v2.2.0...v2.3.0
Install
- Windows (.msi): Double-click to install and follow prompts
- macOS (.pkg): Double-click to install and follow prompts
- Ubuntu 24.04 LTS (.deb):
sudo apt install *ubuntu24_arm64.deb
- Ubuntu 22.04 LTS (.deb):
sudo apt install *ubuntu22_arm64.deb
- Ubuntu 20.04 LTS (.deb):
sudo apt install *ubuntu20_arm64.deb
- Raspberry Pi OS 12 (.deb):
sudo apt install *rpos_arm64.deb
Run
- Linux/macOS:
/usr/local/bin/nfiq2
- Windows 64-bit:
C:\Program Files\NFIQ 2\bin\nfiq2.exe
- Windows 32-bit:
C:\Program Files (x86)\NFIQ 2\bin\nfiq2.exe
Documentation
- On macOS and Linux, add
/usr/local/nfiq2/share/man
to yourMANPATH
for correctman nfiq2
behavior.
Developer Documentation
Developer documentation for v2.3.0 of the NFIQ 2 API is available on our documentation page, including a crosswalk of v2.2 to v2.3 API methods.
v2.2.0
v2.2.0
About
Bug fixes and performance improvements since v2.1.0.
Details
[FIX]
Fixed off-by-one issue, unfortunately resulting in scoring change since v2.1.0. [#297, #298][FIX]
Upgradelibbiomeval
, now supporting <8 bpp grayscale PNG images.[CHG]
Speed improvement to pre-processing step. [#314, #317][CHG]
Update to OpenCV 4.5.4 [#318][CHG]
Remove minimum image dimension pre-check (smaller images will grow to support FingerJet if necessary) [#309][CHG]
Better error handling with blank images. [#310][NEW]
Added build for Raspberry Pi OS. [#311][NEW]
Constants for CBEFF quality algorithm identifiers. [#323]
Full Changelog: v2.1.0...v2.2.0
Install
- Windows (.msi): Double-click to install and follow prompts
- macOS (.pkg): Double-click to install and follow prompts
- Note: If you have Mac with an M1 CPU, we suggest downloading the arm64 version below for the best performance.
- RHEL/CentOS 8 (.rpm):
sudo dnf install *el8*rpm
- Note: You may need to enable the powertools repo with
dnf config-manager --set-enabled powertools
and EPEL repo (withdnf install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the powertools repo with
- RHEL/CentOS 7 (.rpm):
sudo yum install *el7*rpm
- Note: You may need to enable the EPEL repo (with
yum install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the EPEL repo (with
- Ubuntu 20.04 LTS (.deb):
sudo apt install *arm64.deb
- Raspberry Pi OS (.deb):
sudo apt install *armhf.deb
Run
- Linux/macOS:
/usr/local/bin/nfiq2
- Windows 64-bit:
C:\Program Files\NFIQ 2\bin\nfiq2.exe
- Windows 32-bit:
C:\Program Files (x86)\NFIQ 2\bin\nfiq2.exe
Documentation
- On macOS and Linux, add
/usr/local/nfiq2/share/man
to yourMANPATH
for correctman nfiq2
behavior.
Developer Documentation
Developer documentation for v2.2.0 of the NFIQ 2 API is available on our documentation page.
v2.1.0
v2.1.0
About
Significant bug fixes and performance improvements since NIST's initial 2016 release.
Details
- New command-line interface with pre-compiled binaries (see Assets below)
- Significantly improved API and pre-compiled development libraries (see Assets below)
- Stable feature values and scores across all operating systems
Install
- Windows (.msi): Double-click to install and follow prompts
- macOS (.pkg): Double-click to install and follow prompts
- Note: Depending on GateKeeper settings, you may need to follow the instructions on this page under the heading If you want to open an app that hasn’t been notarized or is from an unidentified developer. We are working with NIST IT to notarize our releases soon and apologize for the inconvenience.
- Note: If you have Mac with an M1 CPU, we suggest downloading the arm64 version below for the best performance.
- RHEL/CentOS 8 (.rpm):
sudo dnf install *el8*rpm
- Note: You may need to enable the powertools repo with
dnf config-manager --set-enabled powertools
and EPEL repo (withdnf install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the powertools repo with
- RHEL/CentOS 7 (.rpm):
sudo yum install *el7*rpm
- Note: You may need to enable the EPEL repo (with
yum install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the EPEL repo (with
- Ubuntu 20.04 LTS (.deb):
sudo apt install ./*deb
Run
- RHEL/CentOS/Ubuntu/macOS:
/usr/local/bin/nfiq2
- Windows 64-bit:
C:\Program Files\NFIQ 2\bin\nfiq2.exe
- Windows 32-bit:
C:\Program Files (x86)\NFIQ 2\bin\nfiq2.exe
Documentation
- On macOS and Linux, add
/usr/local/nfiq2/share/man
to yourMANPATH
for correctman nfiq2
behavior.
Developer Documentation
Developer documentation for v2.1.0 of the NFIQ 2 API is available on our documentation page.
2.1.0-pre.1
v2.1.0-pre.1
About
This pre-release build focuses on command-line application improvements and API updates.
Details
- Improved error messages from command-line application
- Note: All values returned from NFIQ 2 are in the range [0, 100]. The code will no longer produce 254 or 255 values to indicate error, but will instead produce an error message.
- Improved handling of images with no or poor resolution encoding in command-line application
- Improved feature value stability across all operating systems
- Slight modifications to introduce stability to macOS M1 chips
- Improvement and fixes to CSV output from command-line application
- Improved API design (more changes to come)
More Details
- Added ability to resample images from command-line application
- Corrected CSV output from command-line application in several instances
- All non-numeric values are quoted
- Newlines are trimmed from OpenCV exception messages
- Corrected ordering of
UniformImage
andEmptyImageOrContrastTooLow
actionable feedback columns - Use of OpenCV 4.5.2
- Reduced dependencies, including removing BiomDI
- Assorted "under-the-hood" improvements
Install
- Windows (.msi): Double-click to install and follow prompts
- Note: If you previously installed 2.0.999.900 32-bit version, you will need to manually uninstall it first due to a misconfiguration in the 2.0.999.900 installer. This will not be necessary for future versions.
- macOS (.pkg): Double-click to install and follow prompts.
- Note: If you have Mac with an M1 CPU, we suggest downloading the arm64 version below for the best performance.
- Note: x86_64 macOS 11 version has been tested on both macOS 10.15 and 11, but we are providing OS-specific builds anyway.
- RHEL/CentOS 8 (.rpm):
sudo dnf install *el8*rpm
- Note: You may need to enable the powertools repo with
dnf config-manager --set-enabled powertools
and EPEL repo (withdnf install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the powertools repo with
- RHEL/CentOS 7 (.rpm):
sudo yum install *el7*rpm
- Note: You may need to enable the EPEL repo (with
yum install epel-release
) to find all required system dependencies for the command-line application.
- Note: You may need to enable the EPEL repo (with
- Ubuntu 20.04 LTS (.deb):
sudo apt install ./*deb
Run
- RHEL/CentOS/Ubuntu/macOS:
/usr/local/bin/nfiq2
- Windows 64-bit:
C:\Program Files\NFIQ 2\bin\nfiq2.exe
- Windows 32-bit:
C:\Program Files (x86)\NFIQ 2\bin\nfiq2.exe
2.1.0-pre
v2.1.0-pre
About
Pre-release posted for ISO/IEC JTC 1/SC 37/WG 3 January 2021 meeting.
- Stable feature values across all operating systems
- Use of OpenCV 4.5
- Pre-compiled binaries (see below)
Install
- Windows (.msi): Double-click to install and follow prompts
- macOS (.pkg): Double-click to install and follow prompts
- RHEL/CentOS 8 (.rpm):
sudo dnf install *el8*rpm
- Note: You may need to enable the powertools repo with
dnf config-manager --set-enabled powertools
and EPEL repo (withdnf install epel-release
) to find all required system dependencies
- Note: You may need to enable the powertools repo with
- RHEL/CentOS 7 (.rpm):
sudo yum install *el7*rpm
- Note: You may need to enable the EPEL repo (with
yum install epel-release
) to find all required system dependencies
- Note: You may need to enable the EPEL repo (with
- Ubuntu 20.04 LTS (.deb):
sudo apt install ./*deb
Run
- macOS:
/usr/local/bin/nfiq2
- Windows 64-bit:
C:\Program Files\NFIQ 2\bin\nfiq2.exe
- Windows 32-bit:
C:\Program Files (x86)\NFIQ 2\bin\nfiq2.exe
- RHEL/CentOS/Ubuntu:
/usr/bin/nfiq2