cirq.experiments.rabi_oscillations(sampler:, qubit: cirq.devices.grid_qubit.GridQubit, max_angle: float = 6.283185307179586, *, repetitions: int = 1000, num_points: int = 200) → cirq.experiments.qubit_characterizations.RabiResult[source]

Runs a Rabi oscillation experiment.

Rotates a qubit around the x-axis of the Bloch sphere by a sequence of Rabi
angles evenly spaced between 0 and max_angle. For each rotation, repeat
the circuit a number of times and measure the average probability of the
qubit being in the |1> state.
  • sampler – The quantum engine or simulator to run the circuits.

  • qubit – The qubit under test.

  • max_angle – The final Rabi angle in radians.

  • repetitions – The number of repetitions of the circuit for each Rabi angle.

  • num_points – The number of Rabi angles.


A RabiResult object that stores and plots the result.