Skip to main contentIBM Quantum Documentation

Fixed and dynamic repetition rate execution


Fixed repetition rate execution

Most IBM Quantum™ systems execute circuits at a fixed rate. Although this repetition rate varies by system, the underlying execution model is the same, and is described here. First, consider three circuits sent to a system using separate jobs, one for each circuit. The example below shows what happens for jobs of varying lengths. Because of the fixed repetition rate, there is a variable amount of idle time that occurs before the start of a circuit in order to make the entire duration match that given by the system repetition rate.

With fixed-rate execution, shorter jobs result in longer idle time.
Idle time versus job length

The situation changes somewhat when the same circuits are batched into a single job. In this case the circuits included in the job are executed by iterating over the circuits for each shot requested; the execution is column-wise over a matrix of circuits and shots (see below).

The first column represents shot 0.  The circuits are run in order from 0 through 3.  The second column represents shot 1.  The circuits are run in order from 0 through 3.  The remaining columns follow the same pattern.
Column-wise execution matrix

Matrix of four circuits in a job showing the execution pattern over the circuits.

When submitting batches of circuits to the systems, the circuits are executed differently than they would be if executed separately. Namely, the initialization of the circuit, that is, prepare the ground state, and measurements (if any) are aligned over all circuits.

The image shows three circuits.  Although they are different lengths, they take the same amount of time to complete because they were submitted in a batch.

Therefore, each circuit is equal in duration to the longest circuit in the batch, and there is a common idle time that is placed in front of all circuits to match the repetition rate.


Dynamic repetition rate execution

Some IBM Quantum systems allow for dynamic repetition rate execution. These systems are identified in Qiskit using backend.configuration().dynamic_reprate_enabled, and return a value of True. On these systems, it is possible to manually set the above idle time by setting the rep_delay of the submitted job. One can see from the above figures that by reducing the idle time one can potentially see a greater throughput of circuits on the systems that support dynamic repetition rates.


Specify rep_delay for a primitive job

from qiskit_ibm_runtime import QiskitRuntimeService, SamplerV2 as Sampler
 
service = QiskitRuntimeService()
 
# Make sure your backend supports it
backend = service.least_busy(operational=True, min_num_qubits=100, dynamic_reprate_enabled=True)
 
# Determine the allowable range
backend.rep_delay_range
sampler = Sampler(mode=backend)
 
#Specify a value in the supported range
sampler.options.execution.rep_delay = 0.0005

Next steps

Was this page helpful?
Report a bug or request content on GitHub.