Skip to content

Releases: usnistgov/NFIQ2

v2.3.0

01 Oct 15:46
v2.3.0
76b8c4e
Compare
Choose a tag to compare

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 your MANPATH for correct man 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

12 Nov 16:07
v2.2.0
a219464
Compare
Choose a tag to compare

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] Upgrade libbiomeval, 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 (with dnf install epel-release) to find all required system dependencies for the command-line application.
  • 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.
  • 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 your MANPATH for correct man nfiq2 behavior.

Developer Documentation

Developer documentation for v2.2.0 of the NFIQ 2 API is available on our documentation page.

v2.1.0

15 Jun 10:13
v2.1.0
cbe960b
Compare
Choose a tag to compare

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 (with dnf install epel-release) to find all required system dependencies for the command-line application.
  • 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.
  • 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 your MANPATH for correct man 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

24 May 12:43
v2.1.0-pre.1
7f1efad
Compare
Choose a tag to compare
2.1.0-pre.1 Pre-release
Pre-release

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 and EmptyImageOrContrastTooLow 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 (with dnf install epel-release) to find all required system dependencies for the command-line application.
  • 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.
  • 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

12 Jan 22:32
v2.1.0-pre
b69cd9e
Compare
Choose a tag to compare
2.1.0-pre Pre-release
Pre-release

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 (with dnf install epel-release) to find all required system dependencies
  • 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
  • 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