Imago Console Application¶
The utility is called
imago_console.exe in Windows distribution or
imago_console in Linux and Mac OS X distributions. Binaries
are offered in 32-bit and 64-bit versions.
Command-line parameters reference¶
imago_console tool has an additional command line switches and
possibilities in comparison to OCR Visual Tool.
The help message from the program is the following:
Usage: imago_console.exe [option]* [batches] [mode] [image_path] [-o output_file] MODE SWITCHES: image_path: full path to image to recognize (may be omitted if other switch is specified) -o output_file: save single recognition result to the specified file -characters: extracts only characters from image(s) and store in ./characters/ -learn dir_name: process machine learning for specified collection -compare molfile1 molfile2: calculate similarity between molfiles -retcode: returns similarity 0..100 in ERRORLEVEL -test dir_name: calculate similarity score on specified test collection OPTION SWITCHES: -config cfg_file: use specified configuration cluster file -log: enables debug log output to ./log.html -logvfs: stores log in single encoded file ./log_vfs.txt -noexp: do not expand chemical abbreviations -pr: use probabilistic separator (experimental) -tl time_in_ms: timelimit per single image process (default is 10000) -similarity tool [-sparam additional_parameters]: override the default comparison method -pass: don't process images, only print their filenames -override config_string: override config by applying specified string BATCHES: -dir dir_name: process every image from dir dir_name -rec: process directory recursively -images: skip non-supported files from directory SHORTCUTS: -learnd dir_name: -learn -dir dir_name -images
The simplest use case is
imago_console image.png which recognizes
image and saves output to
- You can easily process multiple images from same directory by specifying the -dir switch.
- The -rec switch allows recursively process and the -images
switch skips all non-image data from directories. For example:
imago_console -dir C:\test -rec -images
- The -config switch allows to select configuration cluster
manually, for instance
imago_console -config indigo_render.txt image_rendered_by_indigo.png
- The -log switch enables debug logging to
log.htmlfile (the required images will be stored in
htmlimgsdir). The -logvfs stores all log data in single file
- The -compare switch allows to compare two molfiles and print the
similarity value. If the -retcode switch specified also the
result will be returned as error level variable (can be obtained
under Windows by
- The -learn switch performs the machine learning process. Before
you start you need to create the test collection: folder (subfolders
are allowed too) where the original images and corresponding
recognized structures are placed (for instance:
image2.mol, …). The program will try to generate the configuration cluster which gives the better recognition rate on the specified test collection. If so, the cluster will be saved in current folder as
config_NNNOK_MMM.txt. You can use this config further by specifying the
- The -test switch allows quickly check recognition result on a specified test collection (organized the same way as for machine learning) and returns count of correctly recognized images and average time. Can be combined with -retcode switch to return average recognition rate as process return code.
- The -tl switch can be used for limiting the recognition time per image. If the recognition process takes more time than specified - the process will be stopped.
- The -override switch can be used for setting config parameters.
-override "prefilterCV.MinGoodPixelsCount=30;"drops all connected segments with pixel count less than 30.
- The -o switch sets the output filename for single image recognition.