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 IBM Qiskit Runtime on Cloud channel.

Example:

from qiskit import QuantumCircuit
from qiskit_ibm_runtime import QiskitRuntimeService, Sampler
 
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 backend you have access to
backend = service.least_busy(simulator=False,operational=True)
 
# Create a Sampler object
sampler = Sampler(backend)
 
# Submit the circuit to the sampler
job = sampler.run(qc)
 
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:

Was this page helpful?