A robust Command Line Interface (CLI) wrapping key API functions. The CLI is ideal for headless server environments or scripts that perform face recognition tasks. It is designed to mesh well with standard Unix commands.

Note: Be sure to export the ROC_LIC environment variable with the path to ROC.lic before using the CLI applications. Alternatively, this path can be specified with the --license flag supported by each CLI application. See roc_initialize for details.

Applications

Here's a list of the applications along with a brief description of each.

Application	Description
roc-amqp-worker	Create a worker pod for Enterprise Search with roc_start_amqp_server.
roc-at	Extract templates in a gallery with the specified indicies.
roc-cluster	Cluster a gallery into persons.
roc-compare	Measure the similarity between galleries.
roc-consolidate	Remove redundant templates for each person in a gallery.
roc-database	Extract a value from a roc_database for a specified key.
roc-enroll	Append templates from one gallery to another.
roc-evaluate	Generate accuracy metrics from a similarity matrix.
roc-plot	Plot accuracy metrics.
roc-host-id	Print the Host ID required for license generation.
roc-log	Print usage logging statistics.
roc-metadata	Extract metadata from a gallery.
roc-remove	Remove templates in a gallery at the specified indicies.
roc-represent	Construct templates from images.
roc-search	Retrieve a sorted list of the top candidate templates for a probe.
roc-serve	Start a server for host remote access.
roc-track	Construct templates from a video feed, tracking persons and/or objects between frames.
roc-validate	Check the contents of a gallery for data corruption.

Gallery Files

See roc_gallery_file for a description of the ROC gallery file format that is an integral aspect of the CLI.

Usage Logging

If your license requires usage logging, first export the ROC_LOG environment variable before using the CLI. See Usage Logging for details.