From 9f28b391ca69e7294ab1a52291f28b44a4ceb409 Mon Sep 17 00:00:00 2001 From: Georgios Pinitas Date: Wed, 18 Jul 2018 20:01:53 +0100 Subject: COMPMID-1393: Update example documentation Change-Id: I7251575645b35b611de9d8931bb2b7dbc096de13 Reviewed-on: https://eu-gerrit-1.euhpc.arm.com/140544 Tested-by: Jenkins Reviewed-by: Anthony Barbier --- utils/CommonGraphOptions.h | 52 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 51 insertions(+), 1 deletion(-) (limited to 'utils') diff --git a/utils/CommonGraphOptions.h b/utils/CommonGraphOptions.h index 24c8dbb67c..ce4a2c9dd1 100644 --- a/utils/CommonGraphOptions.h +++ b/utils/CommonGraphOptions.h @@ -34,6 +34,56 @@ namespace arm_compute { namespace utils { +/* ![Common graph examples parameters] */ +/* Common graph parameters + * + * --help : Print the example's help message. + * --threads : The number of threads to be used by the example during execution. + * --target : Execution target to be used by the examples. Supported target options: NEON, CL, GC. + * --type : Data type to be used by the examples. Supported data type options: QASYMM8, F16, F32. + * --layout : Data layout to be used by the examples. Supported data layout options : NCHW, NHWC. + * --enable-tuner : Toggle option to enable the OpenCL dynamic tuner. + * --fast-math : Toggle option to enable the fast math option. + * --data : Path that contains the trainable parameter files of graph layers. + * --image : Image to load and operate on. Image types supported: PPM, JPEG, NPY. + * --labels : File that contains the labels that classify upon. + * --validation-file : File that contains a list of image names with their corresponding label id (e.g. image0.jpg 5). + * This is used to run the graph over a number of images and report top-1 and top-5 metrics. + * --validation-path : The path where the validation images specified in the validation file reside. + * --validation-range : The range of the images to validate from the validation file (e.g 0,9). + * If not specified all the images will be validated. + * --tuner-file : The file to store the OpenCL dynamic tuner tuned parameters. + * + * Note that data, image and labels options should be provided to perform an inference run on an image. + * Note that validation-file and validation-path should be provided to perform a graph accuracy estimation. + * Note GLES target is not supported for most of the networks. + * + * Example execution commands: + * + * Execute a single inference given an image and a file containing the correspondence between label ids and human readable labels: + * ./graph_vgg16 --data=data/ --target=cl --layout=nhwc --image=kart.jpeg --labels=imagenet1000_clsid_to_human.txt + * + * Perform a graph validation on a list of images: + * ./graph_vgg16 --data=data/ --target=neon --threads=4 --layout=nchw --validation-file=val.txt --validation-path=ilsvrc_test_images/ + * + * File formats: + * + * Validation file should be a plain file containing the names of the images followed by the correct label id. + * For example: + * + * image0.jpeg 882 + * image1.jpeg 34 + * image2.jpeg 354 + * + * Labels file should be a plain file where each line is the respective human readable label (counting starts from 0). + * For example: + * + * 0: label0_name label0_name + * 1: label1_name or label1_name + * 2: label2_name label2_name + */ +/* ![Common graph examples parameters] */ + /** Structure holding all the common graph parameters */ struct CommonGraphParams { @@ -111,7 +161,7 @@ public: * * @param[in] options Options to consume * - * @return Structure containing the commnon graph parameters + * @return Structure containing the common graph parameters */ CommonGraphParams consume_common_graph_parameters(CommonGraphOptions &options); } // namespace utils -- cgit v1.2.1