aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJan Eilers <jan.eilers@arm.com>2021-01-28 15:38:09 +0000
committerJan Eilers <jan.eilers@arm.com>2021-02-02 11:25:49 +0000
commit0919e3b7944333b640332e9e2ac3c62929a2ecd5 (patch)
treecb464af2f2ce23ede1afa8e48cd0644dcdd59364 /docs
parent1ed388f6b400056f5f260163b4b500cfbbd17c28 (diff)
downloadarmnn-0919e3b7944333b640332e9e2ac3c62929a2ecd5.tar.gz
IVGCVSW-5605 Doxygen: Move Converter and Quantizer to Software Tools
* Using README.md files directly to reduce duplications Signed-off-by: Jan Eilers <jan.eilers@arm.com> Change-Id: I6bd6f6326e608939ac244cc32b329e32bb4802f7
Diffstat (limited to 'docs')
-rw-r--r--docs/00_software_tools.dox18
-rw-r--r--docs/03_converter_quantizer.dox60
-rw-r--r--docs/Doxyfile3
3 files changed, 20 insertions, 61 deletions
diff --git a/docs/00_software_tools.dox b/docs/00_software_tools.dox
index 1d30b3ae9c..b151be6d05 100644
--- a/docs/00_software_tools.dox
+++ b/docs/00_software_tools.dox
@@ -17,7 +17,25 @@ other helpful information in each section.
@subpage deserializer
+@subpage md_src_armnnQuantizer_README
+
+@subpage md_src_armnnConverter_README
+
**/
}
+/// Create pages for each tool so they appear nicely in the doxygen tree-view. Subpages are not listed there.
+///
+/// Note: The parser, serializer and deserializer pages are created in 01_parsers.dox or 02_deserializer_serializer.dox
+namespace armnn
+{
+/**
+
+@page md_src_armnnQuantizer_README Quantizer
+
+@page md_src_armnnConverter_README Converter
+
+**/
+}
+
diff --git a/docs/03_converter_quantizer.dox b/docs/03_converter_quantizer.dox
deleted file mode 100644
index 9b643f387a..0000000000
--- a/docs/03_converter_quantizer.dox
+++ /dev/null
@@ -1,60 +0,0 @@
-/// Copyright (c) 2020 ARM Limited.
-///
-/// SPDX-License-Identifier: MIT
-///
-/// Permission is hereby granted, free of charge, to any person obtaining a copy
-/// of this software and associated documentation files (the "Software"), to deal
-/// in the Software without restriction, including without limitation the rights
-/// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-/// copies of the Software, and to permit persons to whom the Software is
-/// furnished to do so, subject to the following conditions:
-///
-/// The above copyright notice and this permission notice shall be included in all
-/// copies or substantial portions of the Software.
-///
-/// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-/// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-/// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-/// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-/// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-/// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-/// SOFTWARE.
-///
-
-namespace armnn
-{
-/**
-@page converter_and_quantizer The ArmNN Converter and Quantizer
-@tableofcontents
-
-@section S10_converter The ArmNN Converter
-
-The `ArmnnConverter` is a program for converting neural networks from other formats to Arm NN format.
-Currently the program supports models in Caffe, Onnx, Tensorflow Protocol Buffers and Tensorflow Lite FlatBuffers formats. Run the program with no arguments to see command-line help.
-
-For more information about the layers that are supported, see <a href="parsers.xhtml">parsers</a>.
-<br/><br/><br/><br/>
-
-@section S11_quantizer The ArmNN Quantizer
-
-The `ArmnnQuantizer` is a program for loading a 32-bit float network into ArmNN and converting it into a quantized asymmetric 8-bit or quantized symmetric 16-bit network.
-It supports static quantization by default, dynamic quantization is enabled if CSV file of raw input tensors is provided. Run the program with no arguments to see command-line help.
-
-
-|Cmd:|||
-| ---|---|---|
-| -h | --help | Display help messages |
-| -f | --infile | Input file containing float 32 ArmNN Input Graph |
-| -s | --scheme | Quantization scheme, "QAsymm8" or "QSymm16". Default value: QAsymm8 |
-| -c | --csvfile | CSV file containing paths for raw input tensors for dynamic quantization. If unset, static quantization is used |
-| -p | --preserve-data-type | Preserve the input and output data types. If unset, input and output data types are not preserved |
-| -d | --outdir | Directory that output file will be written to |
-| -o | --outfile | ArmNN output file name |
-
-<br/>
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~.sh
-./ArmnnQuantizer -f /path/to/armnn/input/graph/ -s "QSymm16" -c /path/to/csv/file -p 1 -d /path/to/output -o outputFileName
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-**/
-}
diff --git a/docs/Doxyfile b/docs/Doxyfile
index a0d6593be5..a50d38112b 100644
--- a/docs/Doxyfile
+++ b/docs/Doxyfile
@@ -816,9 +816,10 @@ WARN_LOGFILE =
INPUT = ./docs/00_software_tools.dox \
./docs/01_parsers.dox \
./docs/02_deserializer_serializer.dox \
- ./docs/03_converter_quantizer.dox \
./docs/04_backends.dox \
./docs/05_other_tools.dox \
+ ./src/armnnQuantizer/README.md \
+ ./src/armnnConverter/README.md \
./include/ \
./src/ \
./tests/ \