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:
- Decompress the
tar.gzfile you have received. The result is a directory with the name
panoptesin your current directory.
- Push this directory and all its subdirectories with
adb pushto a suitable home folder on your device. The Panoptes tool can be found inside the
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
You have to set the
PANOPTES_LICENSEenvironment 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