rigetti / pyquil

A Python library for quantum programming using Quil.
http://docs.rigetti.com
Apache License 2.0
1.41k stars 343 forks source link

Make gRPC timeout configuration more visible and well-documented #941

Open notmgsk opened 5 years ago

karalekas commented 5 years ago

@notmgsk could you add some color to this issue so we can get it labeled and assigned? :)

notmgsk commented 5 years ago

Following a class at UCLA, a number of students mentioned that it was not clear how or where timeouts should be configured. From memory, timeouts can be configured: at the command line when invoking the compiler and simulator, and by reaching into QVMCompiler and QPUCompiler objects. It is not clear which of these methods takes preference, and the latter method feels obscure since it is not provided at get_qc time. It's not clear whether the timeout for running on the QPU can be configured, or what it's default timeout is.

The meat of completing this issue would be having a clear story of where timeouts are implemented, which methods override defaults, and how the interface could be improved (be it in documentation or code).