![\"image0\"](\"figures/Banner.jpeg\")
\n",
"\n",
""
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "37539a73",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:08.554160Z",
"iopub.status.busy": "2025-03-12T18:00:08.553986Z",
"iopub.status.idle": "2025-03-12T18:00:12.945093Z",
"shell.execute_reply": "2025-03-12T18:00:12.943666Z"
},
"tags": [
"imports",
"header_0"
]
},
"outputs": [],
"source": [
"from __future__ import annotations\n",
"\n",
"from pathlib import Path\n",
"\n",
"import numpy as np\n",
"import rich # noqa:F401\n",
"from qcodes.parameters import ManualParameter\n",
"\n",
"import quantify_core.data.handling as dh\n",
"from quantify_core.analysis.single_qubit_timedomain import RamseyAnalysis\n",
"from quantify_core.data.handling import load_dataset\n",
"from quantify_scheduler import QuantumDevice, Schedule, ScheduleGettable\n",
"from quantify_scheduler.operations import X90, Measure, Reset, Rxy\n",
"\n",
"from utils import display_dict, initialize_hardware, run_schedule, show_connectivity # noqa:F401"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "1d8cbc89",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:12.949600Z",
"iopub.status.busy": "2025-03-12T18:00:12.948599Z",
"iopub.status.idle": "2025-03-12T18:00:12.953260Z",
"shell.execute_reply": "2025-03-12T18:00:12.952547Z"
},
"tags": [
"config",
"header_1"
]
},
"outputs": [],
"source": [
"hw_config_path = \"configs/tuning_transmon_coupled_pair_hardware_config.json\"\n",
"device_path = \"devices/transmon_device_2q.json\""
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "38304ae3",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:12.955487Z",
"iopub.status.busy": "2025-03-12T18:00:12.955265Z",
"iopub.status.idle": "2025-03-12T18:00:12.959292Z",
"shell.execute_reply": "2025-03-12T18:00:12.958670Z"
},
"tags": [
"header_2"
]
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Data will be saved in:\n",
"/root/quantify-data\n"
]
}
],
"source": [
"# Enter your own dataset directory here!\n",
"dh.set_datadir(dh.default_datadir())"
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "8caca7dd",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:12.961065Z",
"iopub.status.busy": "2025-03-12T18:00:12.960882Z",
"iopub.status.idle": "2025-03-12T18:00:13.456879Z",
"shell.execute_reply": "2025-03-12T18:00:13.456175Z"
},
"tags": [
"header_3"
]
},
"outputs": [],
"source": [
"quantum_device = QuantumDevice.from_json_file(device_path)\n",
"qubit = quantum_device.get_element(\"q0\")\n",
"quantum_device.hardware_config.load_from_json_file(hw_config_path)\n",
"cluster_ip = None\n",
"meas_ctrl, inst_coord, cluster = initialize_hardware(quantum_device, ip=cluster_ip)"
]
},
{
"cell_type": "markdown",
"id": "3d3abf45",
"metadata": {},
"source": [
"# Ramsey Spectroscopy\n",
"Here we demonstrate Ramsey Spectroscopy, which is used to tune the $|0\\rangle \\rightarrow |1\\rangle$ drive frequency more precisely.\n",
"Ramsey spectroscopy is also used to find $T_2^*$."
]
},
{
"cell_type": "markdown",
"id": "bb286980",
"metadata": {
"tags": [
"no_demo"
]
},
"source": [
"## Setup\n",
"In this section we configure the hardware configuration which specifies the connectivity of our system.\n",
"\n",
"The experiments of this tutorial are meant to be executed with a Qblox Cluster controlling a transmon system.\n",
"The experiments can also be executed using a dummy Qblox device that is created via an instance of the `Cluster` class, and is initialized with a dummy configuration.\n",
"When using a dummy device, the analysis will not work because the experiments will return `np.nan` values.\n",
"\n",
"### Configuration file\n",
"\n",
"This is a template hardware configuration file for a 2-qubit system with a flux-control line which can be used to tune the qubit frequency. We will only work with qubit 0.\n",
"\n",
"The hardware connectivity is as follows, by cluster slot:\n",
"\n",
"- **QCM** (Slot 2)\n",
" - $\\text{O}^{1}$: Flux line for `q0`.\n",
" - $\\text{O}^{2}$: Flux line for `q1`.\n",
"\n",
"- **QCM-RF** (Slot 6)\n",
" - $\\text{O}^{1}$: Drive line for `q0` using fixed 80 MHz IF.\n",
" - $\\text{O}^{2}$: Drive line for `q1` using fixed 80 MHz IF.\n",
"\n",
"- **QRM-RF** (Slot 8)\n",
" - $\\text{O}^{1}$ and $\\text{I}^{1}$: Shared readout line for `q0`/`q1` using a fixed LO set at 7.5 GHz.\n",
"\n",
"Note that in the hardware configuration below the mixers are uncorrected, but for high fidelity experiments this should also be done for all the modules."
]
},
{
"cell_type": "markdown",
"id": "a6a39ac9",
"metadata": {
"tags": [
"no_demo"
]
},
"source": [
"### Quantum device settings\n",
"Here we initialize our `QuantumDevice` and our qubit parameters, checkout this [tutorial](https://quantify-os.org/docs/quantify-scheduler/tutorials/Operations%20and%20Qubits.html) for further details.\n",
"\n",
"In short, a `QuantumDevice` contains device elements where we save our found parameters. Here we are loading a template for 2 qubits, but we will only use qubit 0."
]
},
{
"cell_type": "markdown",
"id": "3bd28531",
"metadata": {},
"source": [
"## Ramsey oscillations"
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "bf0b28a6",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:13.459924Z",
"iopub.status.busy": "2025-03-12T18:00:13.459683Z",
"iopub.status.idle": "2025-03-12T18:00:13.466003Z",
"shell.execute_reply": "2025-03-12T18:00:13.465460Z"
}
},
"outputs": [],
"source": [
"# This schedule can also be imported from from quantify_scheduler.schedules\n",
"\n",
"\n",
"def ramsey_sched(\n",
" times: np.ndarray | float,\n",
" qubit: str,\n",
" artificial_detuning: float = 0,\n",
" repetitions: int = 1,\n",
") -> Schedule:\n",
" r\"\"\"\n",
" Generate a schedule for performing a Ramsey experiment.\n",
"\n",
" This measures the dephasing time :math:`T_2^{\\star}`.\n",
"\n",
" Schedule sequence\n",
" .. centered:: Reset -- pi/2 -- Idle(tau) -- pi/2 -- Measure\n",
"\n",
" See section III.B.2. of :cite:t:`krantz_quantum_2019` for an explanation of the Bloch-Redfield\n",
" model of decoherence and the Ramsey experiment.\n",
"\n",
" Parameters\n",
" ----------\n",
" times\n",
" an array of wait times tau between the start of the first pi/2 pulse and\n",
" the start of the second pi/2 pulse.\n",
" artificial_detuning\n",
" frequency in Hz of the software emulated, or ``artificial`` qubit detuning, which is\n",
" implemented by changing the phase of the second pi/2 (recovery) pulse. The\n",
" artificial detuning changes the observed frequency of the Ramsey oscillation,\n",
" which can be useful to distinguish a slow oscillation due to a small physical\n",
" detuning from the decay of the dephasing noise.\n",
" qubit\n",
" the name of the device element e.g., :code:`\"q0\"` to perform the Ramsey experiment on.\n",
" repetitions\n",
" The amount of times the Schedule will be repeated.\n",
"\n",
" Returns\n",
" -------\n",
" :\n",
" An experiment schedule.\n",
"\n",
" \"\"\"\n",
" device_element = qubit\n",
" # ensure times is an iterable when passing floats.\n",
" times = np.asarray(times)\n",
" times = times.reshape(times.shape or (1,))\n",
"\n",
" schedule = Schedule(\"Ramsey\", repetitions)\n",
"\n",
" if isinstance(times, float):\n",
" times = [times]\n",
"\n",
" for i, tau in enumerate(times):\n",
" schedule.add(Reset(device_element), label=f\"Reset {i}\")\n",
" schedule.add(X90(device_element))\n",
"\n",
" # the phase of the second pi/2 phase progresses to propagate\n",
" recovery_phase = np.rad2deg(2 * np.pi * artificial_detuning * tau)\n",
" schedule.add(\n",
" Rxy(theta=90, phi=recovery_phase, qubit=device_element), ref_pt=\"start\", rel_time=tau\n",
" )\n",
" schedule.add(Measure(device_element, acq_index=i), label=f\"Measurement {i}\")\n",
" return schedule"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "978c0709",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:13.467881Z",
"iopub.status.busy": "2025-03-12T18:00:13.467693Z",
"iopub.status.idle": "2025-03-12T18:00:13.471784Z",
"shell.execute_reply": "2025-03-12T18:00:13.471272Z"
}
},
"outputs": [],
"source": [
"tau = ManualParameter(name=\"tau\", unit=\"s\", label=\"Time\")\n",
"tau.batched = True\n",
"\n",
"ramsey_sched_kwargs = {\n",
" \"qubit\": qubit.name,\n",
" \"times\": tau,\n",
" \"artificial_detuning\": 0.0,\n",
"}\n",
"\n",
"gettable = ScheduleGettable(\n",
" quantum_device,\n",
" schedule_function=ramsey_sched,\n",
" schedule_kwargs=ramsey_sched_kwargs,\n",
" real_imag=False,\n",
" batched=True,\n",
")\n",
"meas_ctrl.gettables(gettable)"
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "0ee258e3",
"metadata": {
"execution": {
"iopub.execute_input": "2025-03-12T18:00:13.473729Z",
"iopub.status.busy": "2025-03-12T18:00:13.473553Z",
"iopub.status.idle": "2025-03-12T18:00:14.345912Z",
"shell.execute_reply": "2025-03-12T18:00:14.345149Z"
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Starting batched measurement...\n",
"Iterative settable(s) [outer loop(s)]:\n",
"\t --- (None) --- \n",
"Batched settable(s):\n",
"\t tau \n",
"Batch size limit: 125\n",
"\n"
]
},
{
"data": {
"application/vnd.jupyter.widget-view+json": {
"model_id": "7fa83ffe44834d07baa14b457e627c41",
"version_major": 2,
"version_minor": 0
},
"text/plain": [
"Completed: 0%| [ elapsed time: 00:00 | time left: ? ] it"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
"<xarray.Dataset> Size: 3kB\n",
"Dimensions: (dim_0: 125)\n",
"Coordinates:\n",
" x0 (dim_0) float64 1kB 2e-08 5.2e-08 8.4e-08 ... 3.956e-06 3.988e-06\n",
"Dimensions without coordinates: dim_0\n",
"Data variables:\n",
" y0 (dim_0) float64 1kB nan nan nan nan nan nan ... nan nan nan nan nan\n",
" y1 (dim_0) float64 1kB nan nan nan nan nan nan ... nan nan nan nan nan\n",
"Attributes:\n",
" tuid: 20250312-180013-476-2c8fbc\n",
" name: ramsey\n",
" grid_2d: False\n",
" grid_2d_uniformly_spaced: False\n",
" 1d_2_settables_uniformly_spaced: False| setting | \nvalue | \n
|---|---|
| acq_protocol | \nSSBIntegrationComplex | \n
| bin_mode | \naverage | \n
| acq_return_type | \n<class 'complex'> | \n
| repetitions | \n500 | \n
| setting | \nvalue | \n
|---|---|
| lo_freq | \n7.500000e+09 | \n
| setting | \nvalue | \n
|---|---|
| auto_lo_cal | \non_lo_interm_freq_change | \n
| auto_sideband_cal | \non_interm_freq_change | \n
| setting | \nvalue | \n
|---|---|
| instrument_type | \nQCM_RF | \n
| setting | \nvalue | \n
|---|---|
| offset_ch0_path_I | \nNone | \n
| offset_ch0_path_Q | \nNone | \n
| offset_ch1_path_I | \nNone | \n
| offset_ch1_path_Q | \nNone | \n
| in0_gain | \nNone | \n
| in1_gain | \nNone | \n
| distortion_corrections | \n[{'bt': {'coeffs': None, 'config': 'QbloxFilte... | \n
| out0_lo_freq_cal_type_default | \nLoCalEnum.ON_LO_INTERM_FREQ_CHANGE | \n
| out1_lo_freq_cal_type_default | \nLoCalEnum.OFF | \n
| lo0_freq | \n7500000000.0 | \n
| lo1_freq | \nNone | \n
| out0_att | \n60 | \n
| out1_att | \nNone | \n
| in0_att | \nNone | \n
| setting | \nvalue | \n
|---|---|
| acq_channel | \n0 | \n
| acq_indices | \n[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13,... | \n
| thresholded_trigger_count | \nNone | \n
| setting | \nvalue | \n
|---|---|
| reference_source | \ninternal | \n
| sync_on_external_trigger | \nNone | \n
| setting | \nvalue | \n
|---|---|
| sync_en | \nTrue | \n
| channel_name | \ncomplex_output_0 | \n
| channel_name_measure | \nNone | \n
| connected_output_indices | \n(0, 1) | \n
| connected_input_indices | \n() | \n
| seq_fn | \nNone | \n
| thresholded_acq_trigger_write_en | \nNone | \n
| thresholded_acq_trigger_write_address | \nNone | \n
| thresholded_acq_trigger_write_invert | \nFalse | \n
| nco_en | \nTrue | \n
| init_offset_awg_path_I | \n0.0 | \n
| init_offset_awg_path_Q | \n0.0 | \n
| init_gain_awg_path_I | \n1.0 | \n
| init_gain_awg_path_Q | \n1.0 | \n
| modulation_freq | \n80000000.0 | \n
| mixer_corr_phase_offset_degree | \n0.0 | \n
| mixer_corr_gain_ratio | \n1.0 | \n
| auto_sideband_cal | \nSidebandCalEnum.ON_INTERM_FREQ_CHANGE | \n
| integration_length_acq | \nNone | \n
| thresholded_acq_threshold | \nNone | \n
| thresholded_acq_rotation | \nNone | \n
| ttl_acq_input_select | \nNone | \n
| ttl_acq_threshold | \nNone | \n
| ttl_acq_auto_bin_incr_en | \nNone | \n
| setting | \nvalue | \n
|---|---|
| repetitions | \n500 | \n
| setting | \nvalue | \n
|---|---|
| q0:mw-q0.01 | \n10 | \n
| q1:mw-q1.01 | \n10 | \n
| q0:res-q0.ro | \n60 | \n
| q1:res-q1.ro | \n60 | \n
| setting | \nvalue | \n
|---|---|
| auto_lo_cal | \non_lo_interm_freq_change | \n
| auto_sideband_cal | \non_interm_freq_change | \n
| setting | \nvalue | \n
|---|---|
| graph | \n[[cluster0.module6.complex_output_0, q0:mw], [... | \n
| setting | \nvalue | \n
|---|---|
| interm_freq | \n80000000.0 | \n
| setting | \nvalue | \n
|---|---|
| repetitions | \n500 | \n
| setting | \nvalue | \n
|---|---|
| instrument_type | \nQCM | \n
| setting | \nvalue | \n
|---|---|
| config_type | \nquantify_scheduler.backends.qblox_backend.Qblo... | \n
| setting | \nvalue | \n
|---|---|
| interm_freq | \n80000000.0 | \n
| setting | \nvalue | \n
|---|---|
| sync_en | \nTrue | \n
| channel_name | \ncomplex_output_0 | \n
| channel_name_measure | \n[complex_input_0] | \n
| connected_output_indices | \n(0, 1) | \n
| connected_input_indices | \n(0, 1) | \n
| seq_fn | \nNone | \n
| thresholded_acq_trigger_write_en | \nNone | \n
| thresholded_acq_trigger_write_address | \nNone | \n
| thresholded_acq_trigger_write_invert | \nFalse | \n
| nco_en | \nTrue | \n
| init_offset_awg_path_I | \n0.0 | \n
| init_offset_awg_path_Q | \n0.0 | \n
| init_gain_awg_path_I | \n1.0 | \n
| init_gain_awg_path_Q | \n1.0 | \n
| modulation_freq | \n100000000.0 | \n
| mixer_corr_phase_offset_degree | \n0.0 | \n
| mixer_corr_gain_ratio | \n1.0 | \n
| auto_sideband_cal | \nSidebandCalEnum.ON_INTERM_FREQ_CHANGE | \n
| integration_length_acq | \n1900 | \n
| thresholded_acq_threshold | \nNone | \n
| thresholded_acq_rotation | \nNone | \n
| ttl_acq_input_select | \nNone | \n
| ttl_acq_threshold | \nNone | \n
| ttl_acq_auto_bin_incr_en | \nNone | \n
| setting | \nvalue | \n
|---|---|
| instrument_type | \nQRM_RF | \n
| setting | \nvalue | \n
|---|---|
| num_bins | \n125 | \n
| index | \n0 | \n
| setting | \nvalue | \n
|---|---|
| instrument_type | \nCluster | \n
| sequence_to_file | \nFalse | \n
| ref | \ninternal | \n
| setting | \nvalue | \n
|---|---|
| lo_freq | \n7.500000e+09 | \n
| setting | \nvalue | \n
|---|---|
| auto_lo_cal | \non_lo_interm_freq_change | \n
| auto_sideband_cal | \non_interm_freq_change | \n
| setting | \nvalue | \n
|---|---|
| offset_ch0_path_I | \nNone | \n
| offset_ch0_path_Q | \nNone | \n
| offset_ch1_path_I | \nNone | \n
| offset_ch1_path_Q | \nNone | \n
| in0_gain | \nNone | \n
| in1_gain | \nNone | \n
| distortion_corrections | \n[{'bt': {'coeffs': None, 'config': 'QbloxFilte... | \n
| out0_lo_freq_cal_type_default | \nLoCalEnum.ON_LO_INTERM_FREQ_CHANGE | \n
| out1_lo_freq_cal_type_default | \nLoCalEnum.OFF | \n
| lo0_freq | \n5020000000.0 | \n
| lo1_freq | \nNone | \n
| out0_att | \n10 | \n
| out1_att | \nNone | \n
| in0_att | \nNone | \n
| setting | \nvalue | \n
|---|---|
| auto_lo_cal | \non_lo_interm_freq_change | \n
| auto_sideband_cal | \non_interm_freq_change | \n