Compute

Compute unified quality scores, native quality measures, quality block values, and actionable quality feedback. More...

Functions
unsigned int	NFIQ2::Algorithm::computeUnifiedQualityScore (const NFIQ2::FingerprintImageData &rawImage) const
	Compute a unified quality score.
unsigned int	NFIQ2::Algorithm::computeUnifiedQualityScore (const std::vector< std::shared_ptr< NFIQ2::QualityMeasures::Algorithm > > &algorithms) const
	Compute a unified quality score.
unsigned int	NFIQ2::Algorithm::computeUnifiedQualityScore (const std::unordered_map< std::string, double > &features) const
	Compute a unified quality score.
static std::unordered_map< std::string, unsigned int >	NFIQ2::Algorithm::getQualityBlockValues (const std::unordered_map< std::string, double > &nativeQualityMeasureValues)
	Obtain the quality block values (i.e., [0, 100]) for the native quality measure values.
static unsigned int	NFIQ2::Algorithm::getQualityBlockValue (const std::string &nativeQualityMeasureIdentifier, const double nativeQualityMeasureValue)
	Obtain the quality block value (i.e., [0, 100]) for the native quality measure value.
std::vector< std::shared_ptr< NFIQ2::QualityMeasures::Algorithm > >	NFIQ2::QualityMeasures::computeNativeQualityMeasureAlgorithms (const NFIQ2::FingerprintImageData &rawImage)
	Compute native quality measures.
std::unordered_map< std::string, double >	NFIQ2::QualityMeasures::computeNativeQualityMeasures (const NFIQ2::FingerprintImageData &rawImage)
	Compute native quality measure values.
std::unordered_map< std::string, double >	NFIQ2::QualityMeasures::computeActionableQualityFeedback (const NFIQ2::FingerprintImageData &rawImage)
	Compute actionable quality feedback.

Detailed Description

Compute unified quality scores, native quality measures, quality block values, and actionable quality feedback.

Function Documentation

computeUnifiedQualityScore() [1/3]

unsigned int NFIQ2::Algorithm::computeUnifiedQualityScore

(

const NFIQ2::FingerprintImageData &

rawImage

)

const

Compute a unified quality score.

Parameters

rawImage

Fingerprint image.

Returns

Computed unified quality score.

Exceptions

Exception

Called before random forest parameters were loaded.

computeUnifiedQualityScore() [2/3]

unsigned int NFIQ2::Algorithm::computeUnifiedQualityScore

(

const std::vector< std::shared_ptr< NFIQ2::QualityMeasures::Algorithm > > &

algorithms

)

const

Compute a unified quality score.

Parameters

algorithms

Computed quality measure algorithms.

Returns

Computed unified quality score.

Exceptions

Exception

Called before random forest parameters were loaded.

See also

QualityMeasures::computeNativeQualityMeasureAlgorithms

computeUnifiedQualityScore() [3/3]

unsigned int NFIQ2::Algorithm::computeUnifiedQualityScore

(

const std::unordered_map< std::string, double > &

features

)

const

Compute a unified quality score.

Parameters

features

Map of quality measure algorithm identifiers to native quality measures.

Returns

Computed unified quality score.

Exceptions

Exception

Called before random forest parameters were loaded.

See also

QualityMeasures::computeNativeQualityMeasures

getQualityBlockValues()

static std::unordered_map< std::string, unsigned int > NFIQ2::Algorithm::getQualityBlockValues ( const std::unordered_map< std::string, double > & nativeQualityMeasureValues )

static

Obtain the quality block values (i.e., [0, 100]) for the native quality measure values.

Parameters

nativeQualityMeasureValues

Map of keys representing identifiers for the native quality measures (from nfiq2_constants.hpp), and values representing native quality measure values.

Returns

Native quality measure values mapped [0, 100], per ISO/IEC 29794-4:2024, suitable for inclusion in an ISO/IEC 39794-2 quality block.

Exceptions

Exception

Unrecognized key value in nativeQualityMeasureValues

getQualityBlockValue()

static unsigned int NFIQ2::Algorithm::getQualityBlockValue ( const std::string & nativeQualityMeasureIdentifier, const double nativeQualityMeasureValue )

static

Obtain the quality block value (i.e., [0, 100]) for the native quality measure value.

Parameters

nativeQualityMeasureIdentifier	Identifier for the native quality measure (from nfiq2_constants.hpp).
nativeQualityMeasureValue	Native quality measure value.

Returns

Native quality measure value mapped [0, 100], per ISO/IEC 29794-4:2024, suitable for inclusion in an ISO/IEC 39794-2 quality block.

Exceptions

Exception

Unrecognized value for nativeQualityMeasureIdentifier.

computeNativeQualityMeasureAlgorithms()

std::vector< std::shared_ptr< NFIQ2::QualityMeasures::Algorithm > > NFIQ2::QualityMeasures::computeNativeQualityMeasureAlgorithms

(

const NFIQ2::FingerprintImageData &

rawImage

)

Compute native quality measures.

Parameters

rawImage

Fingerprint image in raw format.

Returns

A vector of evaluated native quality measure algorithms.

computeNativeQualityMeasures()

std::unordered_map< std::string, double > NFIQ2::QualityMeasures::computeNativeQualityMeasures

(

const NFIQ2::FingerprintImageData &

rawImage

)

Compute native quality measure values.

Parameters

rawImage

Fingerprint image in raw format.

Returns

A map of quality measure algorithm identifiers to native quality measures.

See also

Identifiers::QualityMeasures

computeActionableQualityFeedback()

std::unordered_map< std::string, double > NFIQ2::QualityMeasures::computeActionableQualityFeedback

(

const NFIQ2::FingerprintImageData &

rawImage

)

Compute actionable quality feedback.

Parameters

rawImage

Fingerprint image in raw format.

Returns

A map of actionable quality identifiers to actionable quality values.

See also

Identifiers::ActionableQualityFeedback

Thresholds::ActionableQualityFeedback