Panoptes Command Line Tool

The Panoptes command line tool allows you to learn and recognize persons in an image. It also provides you with tools to manage persons in a person database.

Panoptes stores person-related information in a database file with name safr_person.db that is by default stored in your home directory.

To install Panoptes:

  1. Decompress the tar.gz file you have received. The result is a directory with the name panoptes in your current directory.
  2. Push this directory and all its subdirectories with adb push to a suitable home folder on your device. The Panoptes tool can be found inside the panoptes folder.

📘

Note

Many embedded Linux versions set home directory to /.

Panoptes automatically creates the database file if it does not exist, and updates the database file if it exists. You can point Panoptes to a database file stored in a different location by setting the environment variable PANOPTES_DB_PATH before you invoke Panoptes. The value of this variable should be an absolute path to the desired database location.

You invoke Panoptes with an action and action specific parameters. You can see which verbs Panoptes supports by issuing the following command:

> panoptes --help
panoptes <action>
 
Where <action> is one of:
analyze   <path to image(s)> [-Ckey=value ...]
learn     <path to image(s)> [-Dkey=value ...] [-Ckey=value ...]
recognize <path to image(s)> [-Ckey=value ...]
remove    <person id>
list      [person id]
edit      <person id> [-Dkey=value ...] [-Rkey ...]
encrypt   <new password>
 
-Dkey=value       define person metadata key-value pair
-Rkey             remove person metadata key-value pair
 
-Cmin-cpq=value          the required minimum center pose quality [0 - 1]
-Cmin-cq=value           the required minimum contrast quality [0 - 1]
-Cmin-sq=value           the required minimum sharpness quality |0 - 1]
-Cmin-confidence=value   the required minimum confidence [0 - 1]
-Cmin-search-size=value  the minimum face width/height in pixels for detection
-Cmin-size=value         the minimum face width/height in pixels for acceptance
-Cselect=value           the face selection policy: 'any', 'largest' or 'at-location'
-Cloc-x=value            the X coordinate of the location if selection policy is at-location
-Cloc-y=value            the Y coordinate of the location if selection policy is at-location
-Cmax-threads=value      the maximum number of threads to process detection and recogniton (0 - auto detect, 1-100 actual number of threads)
-b                       generate benchmark output (used with learn or recognize actions)
 
Environment variables:
PANOPTES_DB_PATH         if set, specifies the path and file name for the person store file
PANOPTES_DB_PWD          if set, specifies the password for the person store file
PANOPTES_LICENSE         if set, specifies the panoptes license

📘

Important

You have to set the PANOPTES_LICENSE environment variable to the license key you have received from RealNetworks before you invoke Panoptes. On a POSIX comparability system, you can do this by executing the following line in a shell window:

export PANOPTES_LICENSE=<license key>

This line should be added to your shell startup script to ensure it is executed for every new shell window you open.

Updated about a year ago

Panoptes Command Line Tool


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.