Driver options

Driver options#

2024-12-04

3 min read time

Applies to Linux

This document lists the MIGraphX driver commands along with the eligible options.

read#

Loads and prints input graph.

compile#

Compiles and prints input graph.

run#

Loads and prints input graph.

perf#

Compiles and runs input graph then prints performance report.

--iterations, -n [unsigned int]#

Sets number of iterations to run for perf report (Default: 100)

verify#

Runs reference and CPU or GPU implementations and checks outputs for consistency.

--rms-tol [double]#

Sets tolerance for RMS error (Default: 0.001)

--atol [double]#

Sets tolerance for elementwise absolute difference (Default: 0.001)

--rtol [double]#

Sets tolerance for elementwise relative difference (Default: 0.001)

-i, --per-instruction#

Verifies each instruction

-r, --reduce#

Reduces program and verifies

--ref-use-double#

Converts floating point values to double for the ref target

roctx#

roctx provides marker information for each operation which allows MIGraphX to be used with rocprof for performance analysis. This allows you to get GPU-level kernel timing information. Here is how you can use roctx combined with rocprof for tracing:

/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 rocprof generates trace information for HIP, HCC and ROCTX in separate .txt files. To understand the interactions between API calls, utilize the roctx.py helper script.