SourceAFIS » CLI

SourceAFIS CLI is a command-line interface for SourceAFIS libraries (Java, .NET). At the moment, it can benchmark algorithm accuracy, template footprint, and implementation speed. It also includes tools that aid in development of SourceAFIS, specifically transparency data logging and output checksums.


In order to benchmark SourceAFIS on particular hardware, clone the repository on the target machine and execute it.

git clone
cd sourceafis-cli-java
mvn compile exec:java -Dexec.args="benchmark"

Give it a few minutes to download data and populate caches. You should then see benchmark report.

Dataset       EER    FMR100  FMR1K  FMR10K
High quality  2.23%  3.66%   5.80%  7.50%
All           8.62%  13.1%   18.3%  22.0%

Dataset       Serialized  Memory   Minutiae
High quality  585 B       16.9 KB  35
All           584 B       16.9 KB  35

Operation        Iterations  Gross       Net         Thread      Mean     Min      Max      Sample  Median   SD       Geom.mean  GSD
extraction       4,285       107 fp/s    111 fp/s    27.7 fp/s   36.1 ms  5.20 ms  190 ms   4,285   32.8 ms  17.4 ms  33.3 ms    1.48x
identification   1,808,565   44.7 Kfp/s  46.3 Kfp/s  11.6 Kfp/s  86.4 us  40.0 ns  19.8 ms  6,755   79.4 us  180 us   76.2 us    1.85x
verification     52,307      1.30 Kfp/s  1.30 Kfp/s  326 fp/s    3.07 ms  87.0 ns  63.7 ms  6,675   1.64 ms  4.60 ms  1.72 ms    3.39x
deserialization  2,029,266   50.8 Kfp/s  50.8 Kfp/s  12.7 Kfp/s  78.7 us  957 ns   24.3 ms  6,694   53.7 us  247 us   57.2 us    2.10x


SourceAFIS CLI accepts a number of subcommands and options. You can enumerate them by executing the CLI with no arguments.

mvn compile exec:java

SourceAFIS CLI will show information about every subcommand and option.

SourceAFIS CLI for Java

Available subcommands:
        Report version of SourceAFIS library being used.
        Measure algorithm accuracy, template footprint, and implementation speed.
    benchmark accuracy
        Measure algorithm accuracy.
    benchmark speed
        Measure algorithm speed.
    benchmark speed extraction
        Measure speed of feature extraction, i.e. FingerprintTemplate constructor.
    benchmark speed identification
        Measure speed of identification, i.e. calling match() with non-matching candidate.
    benchmark speed verification
        Measure speed of verification, i.e. creating FingerprintMatcher and calling match() with matching candidate.
    benchmark speed deserialization
        Measure speed of template deserialization.
    benchmark footprint
        Measure template footprint.
        Compute consistency checksum of all algorithm outputs.
    checksum templates
        Compute consistency checksum of templates.
    checksum scores
        Compute consistency checksum of similarity scores.
    checksum extraction
        Compute consistency checksum of extractor transparency data.
    checksum probe
        Compute consistency checksum of transparency data generated when preparing probe for matching.
    checksum comparison
        Compute consistency checksum of transparency data generated during comparison of probe to candidate.
    log extraction <dataset> <key>
        Log extractor transparency data for given key.
    log probe <dataset> <key>
        Log transparency data for given key while preparing probe for matching.
    log comparison <dataset> <key>
        Log transparency data for given key during comparison of probe to candidate.
    export grayscale
        Convert sample images to grayscale.
        Remove cached data except downloads.

Available options:
    --home <path>
        Location of cache directory.
        Default: /home/rv/.cache/sourceafis
        Log normalized transparency data instead of raw data obtained from the library.
    --baseline <path>
        Compare with output of another SourceAFIS CLI. Path may be relative to cache directory, e.g. 'java/1.2.3'.

Subcommand name is passed to SourceAFIS CLI as part of command-line arguments. The following example will run subcommand "benchmark accuracy".

mvn compile exec:java -Dexec.args="benchmark accuracy"

Library version

You can view version of the currently used SourceAFIS library by executing "version" subcommand.

mvn compile exec:java -Dexec.args="version"

SourceAFIS CLI will identify the underlying SourceAFIS library.