Evaluation of Latent Friction Ridge Technology
API for participating in NIST's evaluation of latent friction ridge identification algorithms.
|
Interface for feature extraction implemented by participant. More...
#include <elft.h>
Classes | |
struct | SubmissionIdentification |
Identifying information about this submission that will be included in reports. More... | |
Public Member Functions | |
virtual SubmissionIdentification | getIdentification () const =0 |
Obtain identification and version information for the extraction portion of this submission. More... | |
virtual CreateTemplateResult | createTemplate (const TemplateType templateType, const std::string &identifier, const std::vector< std::tuple< std::optional< Image >, std::optional< EFS > > > &samples) const =0 |
Extract features from one or more images and encode them into a template. More... | |
virtual std::optional< std::tuple< ReturnStatus, std::vector< TemplateData > > > | extractTemplateData (const TemplateType templateType, const CreateTemplateResult &templateResult) const =0 |
Extract information contained within a template. More... | |
virtual ReturnStatus | createReferenceDatabase (const TemplateArchive &referenceTemplates, const std::filesystem::path &databaseDirectory, const uint64_t maxSize) const =0 |
Create a reference database on the filesystem. More... | |
ExtractionInterface () | |
virtual | ~ExtractionInterface () |
Static Public Member Functions | |
static std::shared_ptr< ExtractionInterface > | getImplementation (const std::filesystem::path &configurationDirectory) |
Obtain a managed pointer to an object implementing ExtractionInterface. More... | |
|
default |
|
virtualdefault |
|
pure virtual |
Obtain identification and version information for the extraction portion of this submission.
|
pure virtual |
Extract features from one or more images and encode them into a template.
templateType | Where this template will be used in the future. |
identifier | Unique identifier used to identify the returned template in future search operations (e.g., Candidate::identifier). |
samples | One or more biometric samples to be considered and encoded into a template. |
N * M
seconds for each element of samples
, on average, as measured on a fixed subset of data, whereN
M
samples
contained RightThumb
, LeftFour
, and EJIOrTip
, the time requirement would be <= ((5 * 1) + (5 * 4) + (5 * 8)) seconds.
|
pure virtual |
Extract information contained within a template.
templateType | templateType passed to createTemplate(). |
templateResult | Object returned from createTemplate(). |
templateResult
otherwise. If CreateTemplateResult::data contains information separated by position (e.g., when provided a multi-position image) or multiple views of the same image (e.g., a compact and verbose template), there may be multiple TemplateData returned.std::nullopt
. However, if you discovered different Minutia, they should be returned.
|
pure virtual |
Create a reference database on the filesystem.
referenceTemplates | One or more templates returned from createTemplate() with a templateType of TemplateType::Reference. |
databaseDirectory | Entry to a read/write directory where the reference database shall be written. |
maxSize | The maximum number of bytes of storage available to write. |
referenceTemplates
to use SearchInterface. The files pointed to by referenceTemplates
will not exist when SearchInterface is instantiated.maxSize
is not necessarily the amount of RAM that will be available to SearchInterface.
|
static |
Obtain a managed pointer to an object implementing ExtractionInterface.
configurationDirectory | Read-only directory populated with configuration files provided in validation. |
return (std::make_shared<ExtractionImplementation>( configurationDirectory));