1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
.. meta::
:description: MIGraphX driver options
:keywords: MIGraphX, ROCm, driver, options
.. _driver-options:
Driver options
===============
This document lists the MIGraphX driver commands along with the eligible options.
read
----
.. program:: migraphx-driver read
Loads and prints input graph.
.. include:: ../driver/read.rst
compile
-------
.. program:: migraphx-driver compile
Compiles and prints input graph.
.. include:: ../driver/read.rst
.. include:: ../driver/compile.rst
run
---
.. program:: migraphx-driver run
Loads and prints input graph.
.. include:: ../driver/read.rst
.. include:: ../driver/compile.rst
perf
----
.. program:: migraphx-driver perf
Compiles and runs input graph then prints performance report.
.. include:: ../driver/read.rst
.. include:: ../driver/compile.rst
.. option:: --iterations, -n [unsigned int]
Sets number of iterations to run for perf report (Default: 100)
verify
------
.. program:: migraphx-driver verify
Runs reference and CPU or GPU implementations and checks outputs for consistency.
.. include:: ../driver/read.rst
.. include:: ../driver/compile.rst
.. option:: --rms-tol [double]
Sets tolerance for RMS error (Default: 0.001)
.. option:: --atol [double]
Sets tolerance for elementwise absolute difference (Default: 0.001)
.. option:: --rtol [double]
Sets tolerance for elementwise relative difference (Default: 0.001)
.. option:: -i, --per-instruction
Verifies each instruction
.. option:: -r, --reduce
Reduces program and verifies
.. option:: --ref-use-double
Converts floating point values to double for the ref target
.. _roctx:
roctx
------
.. program:: migraphx-driver roctx
``roctx`` provides marker information for each operation which allows MIGraphX to be used with :doc:`rocprof <rocprofiler:rocprofv1>` for performance analysis.
This allows you to get GPU-level kernel timing information.
Here is how you can use ``roctx`` combined with :doc:`rocprof <rocprofiler:rocprofv1>` for tracing:
.. code-block:: bash
/opt/rocm/bin/rocprof --hip-trace --roctx-trace --flush-rate 1ms --timestamp on -d <OUTPUT_PATH> --obj-tracking on /opt/rocm/bin/migraphx-driver roctx <ONNX_FILE> <MIGRAPHX_OPTIONS>
Running :doc:`rocprof <rocprofiler:rocprofv1>` generates trace information for HIP, HCC and ROCTX in separate ``.txt`` files.
To understand the interactions between API calls, utilize the :ref:`roctx.py <tools>` helper script.
.. include:: ../driver/read.rst
.. include:: ../driver/compile.rst
|
