Skip to main contentIBM Quantum Documentation

Estimate job run time

After submitting a job to the IBM Quantum™ channel, you can see an estimation for how much quantum time the job will take to run by using job.usage_estimation. Alternatively, you can view this information on the IBM Quantum Platform user interface.

Quantum time is the duration, in seconds, a quantum system is committed to fulfilling a user request.

Notes
  • This only applies to jobs that use primitives.
  • This is not yet available on the Qiskit® Runtime on IBM Cloud® channel.
Important

To ensure faster and more efficient results, as of 1 March 2024, circuits and observables need to be transformed to only use instructions supported by the system (referred to as instruction set architecture (ISA) circuits and observables) before being submitted to the Qiskit Runtime primitives. See the transpilation documentation for instructions to transform circuits. Due to this change, the primitives will no longer perform layout or routing operations; consequently, transpilation options referring to those tasks will no longer have any effect. Users may still request that the Primitives do no optimization of input circuits via options.transpilation.skip_transpilation.

Example:

from qiskit import QuantumCircuit
from qiskit_ibm_runtime import QiskitRuntimeService, Sampler
from qiskit.transpiler.preset_passmanagers import generate_preset_pass_manager
 
service = QiskitRuntimeService()
 
# Create a new circuit with two qubits (first argument) and two classical
# bits (second argument)
qc = QuantumCircuit(2, 2)
 
# Add a Hadamard gate to qubit 0
qc.h(0)
 
# Perform a controlled-X gate on qubit 1, controlled by qubit 0
qc.cx(0, 1)
 
# Measure qubit 0 to cbit 0, and qubit 1 to cbit 1
qc.measure(0, 0)
qc.measure(1, 1)
 
# Run on the least-busy system you have access to
backend = service.least_busy(simulator=False,operational=True)
 
# Generate ISA circuits
pm = generate_preset_pass_manager(backend=backend)
isa_circuit = pm.run(qc)
 
# Create a Sampler object
sampler = Sampler(backend)
 
# Submit the circuit to the sampler
job = sampler.run(isa_circuit)
 
print(job.usage_estimation)

Output:

{'quantum_seconds': 4.1058720028432445}

View the estimated job usage on IBM Quantum Platform

You can view the estimated usage (how much quantum time the job will take to run) in two places on IBM Quantum Platform:


Next steps

Recommendations
Was this page helpful?