nbis-wrapper-js 0.0.1

package/libnbis/nbis_x86-64_linux/man/man1/an2ktool.1

@@ -0,0 +1,267 @@
+.\" @(#)an2ktool.1 2008/10/02 NIST
+.\" I Image Group
+.\" Michael D. Garris
+.\"
+.TH AN2KTOOL 1F "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+an2ktool \- Parses, manipulates, and/or writes the results to an
+ANSI/NIST 2007 file in batch mode.
+.SH SYNOPSIS
+.B an2ktool
+.I <option>
+.br
+\fB-print \fR<all|\fIr\fR[\fI.f\fR[\fI.s\fR[\fI.i\fR]]]> <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-delete \fIr\fR[\fI.f\fR[\fI.s\fR[\fI.i\fR]]] <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-substitute \fIr.f.s.i\fR <new value> <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-substitute \fIr\fR[\fI.f\fR[\fI.s\fR]] <\fIfmttext file\fR> <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-insert \fIr.f.s.i\fR <new value> <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-insert \fIr\fR[\fI.f\fR[\fI.s\fR]] <\fIfmttext file\fR> <\fIfile in\fR> [\fIfile out\fR]
+.br
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version
+
+.SH DESCRIPTION
+.B An2ktool
+parses a standard  compliant ANSI/NIST-ITL 1-2007 file,
+manipulates its contents, and writes the results back out.
+Batch operations may be conducted at the level of
+record, field, subfield, or information item.  Possible
+operations include printing, deleting, substituting, or
+inserting data.
+
+.SH OPTIONS
+All switch names may be abbreviated; for example,
+\fB-print\fR may be written \fB-p\fR.
+
+.SH PRINT OPTION
+\fB-print \fR<all|\fIr\fR[\fI.f\fR[\fI.s\fR[\fI.i\fR]]]> <\fIfile in\fR> [\fIfile out\fR]
+
+Prints the contents of the specified structure {file, record,
+field, subfield, or information item} to either the specified
+output file or to standard output.
+.PP
+Option settings:
+.RS
+.TP
+all
+The entire contents of the input file is printed.  Any binary image
+fields in the file are stored to temporary files, and their file names
+are externally referenced in the printed output.  This option setting is
+equivalent to running \fBan2ktxt\fR on the input file.
+.TP
+.I r
+The contents of the record at position \fIr\fR in the file is printed.
+.TP
+.I r.f
+The contents of the field at position \fIf\fR within record \fIr\fR
+is printed.
+.TP
+.I r.f.s
+The contents of the subfield at position \fIs\fR within field \fIf\fR
+within record \fIr\fR is printed.
+.TP
+.I r.f.s.i
+The contents of the information item at position \fIi\fR within
+subfield \fIs\fR within field \fIf\fR within record \fIr\fR is printed.
+.PP
+.RE
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be printed.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH DELETE OPTION
+\fB-delete \fIr\fR[\fI.f\fR[\fI.s\fR[\fI.i\fR]]] <\fIfile in\fR> [\fIfile out\fR]
+
+Deletes the contents of the specified structure {record,
+field, subfield, or information item} from the ANSI/NIST
+file, writing the results to either the specified
+output file or to standard output.
+.PP
+Option settings:
+.RS
+.TP
+.I r
+The contents of the record at position \fIr\fR in the file is deleted.
+.TP
+.I r.f
+The contents of the field at position \fIf\fR within record \fIr\fR
+is deleted.
+.TP
+.I r.f.s
+The contents of the subfield at position \fIs\fR within field \fIf\fR
+within record \fIr\fR is deleted.
+.TP
+.I r.f.s.i
+The contents of the information item at position \fIi\fR within
+subfield \fIs\fR within field \fIf\fR within record \fIr\fR is deleted.
+.PP
+.RE
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be modified.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH SUBSTITUTE OPTION 1
+\fB-substitute \fIr.f.s.i\fR <new value> <\fIfile in\fR> [\fIfile out\fR]
+
+Substitutes the contents of the specified information item in an
+ANSI/NIST file with the string value provided on the command line,
+writing the results to either the specified
+output file or to standard output.
+.TP
+.I r.f.s.i
+The position indices of the information item to be
+substituted.
+.TP
+<\fInew value\fR>
+The new string value.
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be modified.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH SUBSTITUTE OPTION 2
+\fB-substitute \fIr\fR[\fI.f\fR[\fI.s\fR]] <\fIfmttext file\fR> <\fIfile in\fR> [\fIfile out\fR]
+
+Substitutes the contents of the specified structure {record,
+field, or subfield} in an ANSI/NIST file with the contents of
+a formatted text file consistent in format to those produced
+by \fBan2k2txt\fR.  The results are written to either the specified
+output file or to standard output.
+.PP
+Option settings:
+.RS
+.TP
+.I r
+The contents of the record at position \fIr\fR in the file is substituted.
+.TP
+.I r.f
+The contents of the field at position \fIf\fR within record \fIr\fR
+is substituted.
+.TP
+.I r.f.s
+The contents of the subfield at position \fIs\fR within field \fIf\fR
+within record \fIr\fR is substituted.
+.TP
+.I r.f.s.i
+The contents of the information item at position \fIi\fR within
+subfield \fIs\fR within field \fIf\fR within record \fIr\fR is substituted.
+.PP
+.RE
+.TP
+<\fIfmttext file\fR>
+The formatted text file containing the new values.
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be modified.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH INSERT OPTION 1
+\fB-insert \fIr.f.s.i\fR <new value> <\fIfile in\fR> [\fIfile out\fR]
+
+Inserts an information item at the specified position within an
+ANSI/NIST file, assigning the new item the string value provided
+on the command line.  The results are written to either the specified
+output file or to standard output.
+.TP
+.I r.f.s.i
+The position indices where the new information item is to be
+inserted.
+.TP
+<\fInew value\fR>
+The new information item's string value.
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be modified.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH INSERT OPTION 2
+\fB-insert \fIr\fR[\fI.f\fR[\fI.s\fR]] <\fIfmttext file\fR> <\fIfile in\fR> [\fIfile out\fR]
+
+Inserts a structure {record, field, or subfield} at the specified
+position within an ANSI/NIST file.  The new structure is assigned
+the contents of a formatted text file consistent in format to
+those produced by \fBan2k2txt\fR. The results are written to either
+the specified output file or to standard output.
+.PP
+Option settings:
+.RS
+.TP
+.I r
+A record at position \fIr\fR is inserted.
+.TP
+.I r.f
+A field at position \fIf\fR within record \fIr\fR is inserted.
+.TP
+.I r.f.s
+A subfield at position \fIs\fR within field \fIf\fR
+within record \fIr\fR is inserted.
+.TP
+.I r.f.s.i
+An information item at position \fIi\fR within subfield \fIs\fR
+within field \fIf\fR within record \fIr\fR is inserted.
+.PP
+.RE
+.TP
+<\fIfmttext file\fR>
+The formatted text file containing the new values.
+.TP
+<\fIfile in\fR>
+The ANSI/NIST file whose content is to be modified.
+.TP
+[\fIfile out\fR]
+The optional output file.  If omitted, results are printed to
+standard output.
+
+.SH EXAMPLES
+From \fItest/an2k/execs/an2ktool/an2ktool.src\fR:
+.PP
+.B % an2ktool -d 2.12.1.4 ../../data/nist.an2 delete.an2
+.br
+deletes the information item recording the first minutia's type.
+
+.B % an2ktool -i 2.12.1.4 A delete.an2 insert.an2
+.br
+inserts an information item setting the first minutia's type to "A".
+
+.B % an2ktool -s 2.12.1.4 A ../../data/nist.an2 subitem.an2
+.br
+replaces the information item recording the first minutia's type
+with the value "A".
+
+.B % an2ktool -s 2.12.1 subfld.fmt ../../data/nist.an2 subfld.an2
+.br
+replaces the subfield containing all the attributes related to
+the first minutia with the contents of the formatted text file
+\fIsubfld.fmt\fR.
+
+.SH SEE ALSO
+.BR an2k2iaf (1F),
+.BR an2ktxt (1F),
+.BR dpyan2k (1F),
+.BR iaf2an2k (1F),
+.BR txt2an2k (1F)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/asc2bin.1

@@ -0,0 +1,38 @@
+.\" @(#)asc2bin.1 2008/10/02 NIST
+.\" I Image Group
+.\" G. T. Candela & Craig I. Watson
+.\"
+.TH ASC2BIN 1B "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+asc2bin \- converts a PCASYS data file from ascii to binary form.
+.SH SYNOPSIS
+.B asc2bin
+.I <ascii_data_in> <binary_data_out>
+.SH DESCRIPTION
+.B Asc2bin
+reads a PCASYS ascii data file of any type, or the standard input,
+and produces a corresponding PCASYS binary data file.
+.SH OPTIONS
+.TP
+.I <ascii_data_in>
+Ascii data file to be read.
+.TP
+.I <binary_data_out>
+Binary data file to be written.
+If this file already exists, asc2bin overwrites it.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH EXAMPLE(S)
+From \fItest/pcasys/execs/asc2bin/asc2bin.src\fR:
+.PP
+.RS
+.B % asc2bin ../../data/oas/fv1.cls fv1.bin
+.br
+Converts the class file from ascii to binary data.
+.SH "SEE ALSO"
+bin2asc (1B)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/bin2asc.1

@@ -0,0 +1,39 @@
+.\" @(#)bin2asc.1 2008/10/02 NIST
+.\" I Image Group
+.\" G. T. Candela & Craig I. Watson
+.\"
+.TH BIN2ASC 1B "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+bin2asc \- converts a PCASYS data file from binary to ascii form.
+.SH SYNOPSIS
+.B bin2asc
+.I <binary_data_in> <ascii_data_out>
+.SH DESCRIPTION
+.B Bin2asc
+reads a PCASYS binary data file of any type, and produces a
+corresponding PCASYS ascii data file or writes the ascii data to the
+standard output.
+.SH OPTIONS
+.TP
+.I <binary_data_in>
+Binary data file to be read.
+.TP
+.I <ascii_data_out>
+Ascii data file to be written. If the file already exists, bin2asc
+overwrites the file.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH EXAMPLE(S)
+From \fItest/pcasys/execs/bin2asc/bin2asc.src\fR:
+.PP
+.RS
+.B % bin2asc ../asc2bin/fv1.bin fv1.cls
+.br
+Converts the class file from binary to ascii data.
+.SH "SEE ALSO"
+asc2bin (1B)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group

package/libnbis/nbis_x86-64_linux/man/man1/bozorth3.1

@@ -0,0 +1,246 @@
+.\" @(#)bozorth3.1 2004/09/24 NIST
+.\" I Image Group
+.\" Stanley A. Janet
+.\"
+.TH BOZORTH3 1E "24 September 2004" "NIST" "NBIS Reference Manual"
+
+
+.SH NAME
+bozorth3 \- Computes match scores between fingerprints
+
+
+.\" [\fIFILE\fR]...
+
+
+.SH SYNOPSIS
+.br
+.B bozorth3
+[\fIoptions\fR]
+.I probe-file.xyt
+.I gallery-file.xyt
+.I ...
+.br
+.B bozorth3
+.RI [ options ]
+.BI \-M " mates.lis"
+.br
+.B bozorth3
+.\" .RI [ options ]
+[\fIoptions\fR]
+.BI \-P " probe.lis"
+.I gallery*.xyt
+.br
+.B bozorth3
+.RI [ options ]
+.BI \-G " gallery.lis"
+.I probe*.xyt
+.br
+.sp
+.B bozorth3
+.\" .RI [ options ]
+[\fIoptions\fR]
+.BI \-p " probe-file.xyt"
+.I gallery*.xyt
+.br
+.B bozorth3
+.RI [ options ]
+.BI \-p " probe-file.xyt " \-G " gallery.lis"
+.br
+.B bozorth3
+.RI [ options ]
+.BI \-g " gallery-file.xyt"
+.I probe*.xyt
+.br
+.B bozorth3
+.RI [ options ]
+.BI \-g " gallery-file.xyt " \-P " probe.lis"
+.br
+
+.SH DESCRIPTION
+The program
+.I bozorth3
+computes match scores from fingerprint minutiae files. The files
+are expected to be in xyt-format, a simple text file format that is
+produced by the minutiae detector program \fImindtct\fR, which is
+also part of the NFIS distribution.
+
+By default, each pair of arguments on the command line is considered
+to be a probe file and a gallery file, in that order, that are to be
+matched to yield a score of similarilty. The higher the score, the more
+closely the minutiae in them match. The match score for known mates
+is often close to the number of minutiae in the probe or gallery file,
+but it can be lower or higher than that number, sometimes much higher.
+
+There are two main mechanisms that allow running the \fIbozorth3\fR
+matcher other than by simply specifying pairs of xyt-files on the
+command line.  The mechanisms are useful or necessary under several
+circumstances.  For example, with large data sets, the number of
+pairs of files to be matched could easily exceed the maximum size
+the user's shell permits on a command line, or that's permitted by
+\fIexec*()\fP system calls.  And there are cases where it's just more
+logical to have input filenames stored in a file.  So one mechanism
+uses \fIlist files\fR \(em they contain xyt-filenames, one per line,
+with newline characters as line-endings.  The other mechanism fixes
+the probe (or gallery) file for an entire run, so that the filename
+doesn't have to be specified over and over again.
+
+One form of the list file mechanism allows the pairs of files to be
+read from a single file.  The \fI-M mates.lis\fR option requires
+a single list file of filenames to be matched against each other.
+The probe filenames are on the odd lines, and the gallery filenames
+are on the even lines.
+
+Similarly, the \fI-P probes.lis\fR option specifies that the probe
+filenames are in the file, and the gallery filenames come from the
+command line. The \fI-G gallery.lis\fR option specifies just the
+opposite. Both options may be present, in which case all filenames
+will be read from the two files, and there will be no xyt-files on
+the command line.
+
+The other subset of mechanisms fix a single file to be matched against
+a gallery (or probe) set of any size. For example, \fI-p probe-file\fR
+fixes the probe file for the entire run; it will be matched against
+a gallery consisting of all other files on the command line (or, if
+\fI-G gallery.lis\fR is specified, against a gallery read from a file).
+
+The \fI-g gallery-file\fR option specifies just the opposite. While
+it may seem illogical to reverse the notion of probe and gallery files
+by allowing a single gallery file to be compared against a probe set,
+it's allowed both for consistency and to make it easier to test how
+close scores are when the files are matched in reverse order.
+
+Fixing both the probe and gallery file is legal, but it's equivalent
+to having just a single pair of filenames on the command line without
+the \fI-p\fR and \fI-g\fR.
+
+The score for a probe file \fIa\fR matched to a gallery file \fIb\fR
+is often identical to the score for \fIb\fR matched to \fIa\fR. One
+one data set, the scores were the same more than 75% of the time,
+and only a very small number were different by more than 3.
+
+.SH "Minutiae file format"
+
+Each line in a minutiae file contains three integers, representing the
+x- and y-coordinates and direction of the minutiae, and an optional
+fourth column of integers representing the quality of the minutiae
+at those coordinates.  If the quality column isn't present in a file,
+all minutiae are assumed to be of the same quality.
+
+A finger typically has 40-80 minutiae. Any automated minutiae extractor
+will, of course, flag some things as minutiae that aren't. To work
+with highly sensitive minutiae detectors such as \fImindtct\fR, the
+\fIbozorth3\fR matcher allows each xyt-file to contain as many as 1000
+minutiae lines.  However, by default, only the 150 highest-quality
+minutiae are used to compute the match score.  That number may be
+changed to any number from 0 to 200.  If multiple minutiae have the
+same quality value at the cut-off point, the tie-breaking method is
+simple truncation of the list, sorted by quality but with an undefined
+sort order among its equal-quality elements.
+
+The optimal number of minutiae that should be used depends on the
+fingerprint images and the minutiae detector that processes them. Using
+more than is necessary typically reduces the accuracy of the matcher
+and increases its run time.
+
+To compute a match score between two fingerprints, both sets must have
+at least a minimum number of minutiae.  That number is 10 by default,
+and can be changed to any non-zero integer.  Otherwise the computation
+returns a match score of 0.
+
+.SH OPTIONS
+The command line options can be logically grouped into
+four classes:
+
+.SH "General options"
+.TP
+-h
+Print a help screen detailing the command line options.
+.TP
+-version
+Print ANSI/NIST stardand and NBIS software version.
+.TP
+-v
+Enable verbose mode.
+.TP
+-A verbose=<section>
+Enable verbose mode in a section of the code; the recognized sections
+are: main, load, bozorth, threshold.
+
+
+.SH "Input options"
+.TP
+-m1
+all xyt files use representation according to ANSI INCITS 378-2004. This
+flag must be used if it was used by the \fBmindtct\fR algorithm when extracting
+the minutiae points.
+.TP
+-n max-minutiae
+Set maximum number of minutiae to use from any file [150];
+the legal range is [0,200].
+.TP
+-A minminutiae=#
+Set minimum number of minutiae required for the match score to be more than 0 [10].
+.TP
+-A maxfiles=#
+Set maximum number of files in any gallery, probe, or mates list file [10000].
+.TP
+-A plines=#-#
+Process a subset of files in the probe file.
+.TP
+-A glines=#-#
+Process a subset of files in the gallery file.
+.TP
+-A dryrun
+Test mode only. Do not compute and print any match scores, just print the
+filenames between which match scores would be computed.
+
+
+.SH "Thresholding options"
+.TP
+-T threshold
+Set match score threshold. By default, all match scores are
+printed. However, when a threshold specified, only match scores
+meeting or exceeding that value are printed.
+.TP
+-q
+Quit processing the probe file when a gallery file
+is found for which the match score meets or exceeds the specified threshold.
+
+.SH "Output options"
+.TP
+-A nooutput
+Compute match scores, but don't print them.
+.TP
+-A outfmt=[spg]*
+Output lines will contain (s)core, (p)robe and/or 
+(g)allery filename. By default, only scores are output.
+.TP
+-O score-dir
+Set the directory to write score files in.
+.TP
+-o score-file
+Set the filename to store scores in.
+.TP
+-e stderr-file
+Set the filename to store all other output in.
+.TP
+-b
+Use the default Standard I/O buffering to print the
+match scores. This is equivalent to line-buffering
+when the output is being printed to a terminal,
+and to block-buffering when the output is being printed
+to a file.
+.TP
+-l
+Use line-buffering to print the match scores.
+By default, output lines are stored and printed
+just prior to the \fIbozorth3\fP exiting.
+
+
+.SH SEE ALSO
+.B mindtct (1C)
+
+
+.SH AUTHOR
+Allan S. Bozorth of the FBI; modified by Michael Garris 
+and Stan Janet, both of NIST/ITL/DIV894/Image Group.

package/libnbis/nbis_x86-64_linux/man/man1/chgdesc.1

@@ -0,0 +1,54 @@
+.\" @(#)chgdesc.1 2008/10/02 NIST
+.\" I Image Group
+.\" G. T. Candela & Craig I. Watson
+.\"
+.TH CHGDESC 1B "02 October 2008" "NIST" "NBIS Reference Manual"
+.SH NAME
+chgdesc \- changes the description string of a PCASYS data file.
+.SH SYNOPSIS
+.B chgdesc
+.I <datafile> <new_desc>
+.SH DESCRIPTION
+.B Chgdesc
+replaces the existing description string of a PCASYS data file with
+the provided string.
+
+The new description can be of any length, but it must not contain
+embedded newline characters.  If it contains spaces, tabs, or shell
+metacharacters that are not to be expanded, then it should be quoted.
+To delete a file's description string, i.e. to replace it with the
+empty string, use '' (quoted empty string) as the string argument.
+
+The command makes, and then removes, a temporary version of the data
+file, in the same directory as the original file; its filename is the
+original filename with _chgdesc<pid> appended, where <pid> is the
+process id of the chgdesc command instance.  (In the unlikely event
+that a file of this name already exists, chgdesc exits with an error
+message, rather than replacing that file.)  If the original data file
+is large, then make sure, before running chgdesc, that the disk
+partition where the original file lives has enough room for the
+temporary copy.
+.SH OPTIONS
+.TP
+.I <datafile>
+Data file whose description field is to be changed.
+.TP
+.I <new_desc>
+The new description string.
+.TP
+\fB-version
+\fRPrint ANSI/NIST stardand and NBIS software version.
+
+.SH EXAMPLE(S)
+From \fItest/pcasys/execs/chgdesc/chgdesc.src\fR:
+.PP
+.RS
+.B % chgdesc fv1.acl 'fv1.cls'
+.br
+Puts the string fv1.cls in the description field of the
+file fv1.acl.
+.SH "SEE ALSO"
+datainfo (1B)
+
+.SH AUTHOR
+NIST/ITL/DIV894/Image Group