diff options
author | Georgios Pinitas <georgios.pinitas@arm.com> | 2018-07-18 20:01:53 +0100 |
---|---|---|
committer | Anthony Barbier <anthony.barbier@arm.com> | 2018-11-02 16:54:54 +0000 |
commit | 9f28b391ca69e7294ab1a52291f28b44a4ceb409 (patch) | |
tree | e96f74facda94c02546650758af4757f8cdb8959 /utils/CommonGraphOptions.h | |
parent | 9c07c9609dbc9bbeb211b3bd38195f19ab42904c (diff) | |
download | ComputeLibrary-9f28b391ca69e7294ab1a52291f28b44a4ceb409.tar.gz |
COMPMID-1393: Update example documentation
Change-Id: I7251575645b35b611de9d8931bb2b7dbc096de13
Reviewed-on: https://eu-gerrit-1.euhpc.arm.com/140544
Tested-by: Jenkins <bsgcomp@arm.com>
Reviewed-by: Anthony Barbier <anthony.barbier@arm.com>
Diffstat (limited to 'utils/CommonGraphOptions.h')
-rw-r--r-- | utils/CommonGraphOptions.h | 52 |
1 files changed, 51 insertions, 1 deletions
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 |