Skip to content

usnistgov/openlqm

Repository files navigation

OpenLQM NIST Information Technology Laboratory

About

Open Latent Quality Metric, or "OpenLQM," analyzes friction ridge images and returns latent quality metrics.

History

OpenLQM was developed by Noblis, Inc. under contract to the National Institute of Standards and Technology in 2024-2025, as a port of "LQMetric," which was developed by Noblis, Inc. under contract to the Federal Bureau of Investigation's Criminal Justice Information Services Division in 2012-2014. More information about LQMetric can be found in the article:

Kalka N. D., Beachler M., Hicklin R. A. "LQMetric: A Latent Fingerprint Quality Metric for Predicting AFIS Performance and Assessing the Value of Latent Fingerprints," Journal of Forensic Identification, vol. 70, no. 4, pp. 443–463, Oct 2020.

Download

Pre-built versions of the OpenLQM standalone executable and library for many platforms are available to download on the GitHub Releases page.

Build Dependencies

Building OpenLQM requires the following dependencies:

We use vcpkg to gather and build these packages, including their dependencies.

Quick Build

Important

Unless you are actively developing code for OpenLQM, we highly suggest you download from Releases instead of attempting to compile.

Note

Due to vcpkg use for finding dependencies, Internet access is required during configuration in the default configuration.

git clone https://github.com/usnistgov/openlqm.git

# Set location of vcpkg
VCPKG_ROOT=path/to/vcpkg

# Configure build
cd openlqm
mkdir build
cd build

# Config + vcpkg installation (single-config generator: gcc/clang)
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE="${VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake"
# Config + vcpkg installation (Multi-config generator: Visual Studio, Xcode)
cmake .. -DCMAKE_CONFIGURATION_TYPES=Release -DCMAKE_TOOLCHAIN_FILE="${VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake"

# Build (single-config generator)
cmake --build .
# Build (multi-config generator)
cmake --build . --config Release

# Package
cpack

Communication

Please note that there are no plans for NIST to further enhance or change OpenLQM. It is meant to be an open source snapshot of LQMetric. Development of latent image quality algorithms will happen at the international standards level in the development of ISO/IEC 29794-12.

If you found a bug and can provide steps to reliably reproduce it, or if you have a feature request, please open an issue. Other questions may be addressed to the project maintainers.

License

OpenLQM is released under the Apache 2.0 license. See the LICENSE for details.

About

Latent Fingerprint Quality Metrics

Topics

Resources

License

Stars

Watchers

Forks

Contributors