Troubleshooting

Debugging and Verbose Simulation Output

One helpful mechanism of debugging CUDA Quantum simulation execution is the CUDAQ_LOG_LEVEL environment variable. For any CUDA Quantum executable, just prepend this and turn it on:

Python

CUDAQ_LOG_LEVEL=info python3 file.py

C++

CUDAQ_LOG_LEVEL=info ./a.out

Similarly, one may write the IR to their console or to a file before remote submission. This may be done through the CUDAQ_DUMP_JIT_IR environment variable. For any CUDA Quantum executable, just prepend as follows:

Python

CUDAQ_DUMP_JIT_IR=1 python3 file.py
# or
CUDAQ_DUMP_JIT_IR=<output_filename> python3 file.py

C++

CUDAQ_DUMP_JIT_IR=1 ./a.out
# or
CUDAQ_DUMP_JIT_IR=<output_filename> ./a.out