Skip to content

Update QVM demo notebooks to use willow_pink #7428

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pavoljuhas merged 12 commits into from
Jun 26, 2025
Merged

Update QVM demo notebooks to use willow_pink #7428

Show file tree
Hide file tree
Changes from 9 commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
d10bc8a
noisy_simulation.ipynb - advice about list_virtual_processors()
pavoljuhas Jun 14, 2025
9a0026a
quantum_virtual_machine.ipynb - use the new willow_pink processor
pavoljuhas Jun 17, 2025
cdc15d8
qvm_basic_example.ipynb - convert for the willow_pink processor
pavoljuhas Jun 18, 2025
058e292
qvm_builder_code.ipynb - use the new willow_pink processor by default
pavoljuhas Jun 18, 2025
691fea5
qvm_stabilizer_example.ipynb - use the new willow_pink processor by d…
pavoljuhas Jun 18, 2025
a71008e
virtual_engine_interface.ipynb - small tweaks
pavoljuhas Jun 18, 2025
829e022
colab.ipynb - fix typo in git command
pavoljuhas Jun 18, 2025
5e91227
echoes.ipynb - tiny tweak to avoid syntax warning
pavoljuhas Jun 18, 2025
778127e
quantum_volume_errors.ipynb - strip extra metadata
pavoljuhas Jun 18, 2025
832175f
Make `willow_pink` the default processor in noisy_simulation.ipynb
pavoljuhas Jun 24, 2025
0bf4536
wake up GHA
pavoljuhas Jun 24, 2025
40fcb1d
Merge branch 'main' into update-qvm-notebooks
pavoljuhas Jun 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/simulate/noisy_simulation.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -998,7 +998,8 @@
"source": [
"import cirq_google\n",
"\n",
"processor_id = \"rainbow\" # or \"weber\"\n",
"# See cirq_google.engine.list_virtual_processors() for available processor names\n",
"processor_id = \"rainbow\" # or \"weber\" or \"willow_pink\"\n",
Copy link
Copy Markdown
Collaborator

@eliottrosenberg eliottrosenberg Jun 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's make "willow_pink" the default and maybe not even mention the others since they are very old and don't represent current performance.

Copy link
Copy Markdown
Collaborator Author

@pavoljuhas pavoljuhas Jun 24, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done in 832175f.

I have reviewed other notebooks for their processor choice. The ones that run QVM simulations now all default to "willow_pink". I have left the old default processors in qubit_picking.ipynb where the low noise performance is not critical for the demonstrated function and the heatmap plots would become too dense for willow. I have also left the old default "weber" processor in virtual_engine_interface.ipynb which primarily demos interaction with Quantum Engine (processor choice, time reservation) and uses noise-free simulated processors.

I feel removing old processors might degrade some of the notebooks, for example, the virtual_engine_interface would end up having a choice of one processor instead of three.

"# Load the noise properties for the processor\n",
"noise_props = cirq_google.engine.load_device_noise_properties(processor_id)\n",
"# Build a noise model from the noise properties\n",
Expand Down
18 changes: 13 additions & 5 deletions docs/simulate/quantum_virtual_machine.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,8 +135,10 @@
},
"outputs": [],
"source": [
"# Choose a processor (\"rainbow\" or \"weber\")\n",
"processor_id = \"weber\""
"# Choose a processor (\"willow_pink\" or \"rainbow\" or \"weber\")\n",
"# (see cirq_google.engine.list_virtual_processors() for available names)\n",
"\n",
"processor_id = \"willow_pink\""
]
},
{
Expand All @@ -161,8 +163,6 @@
},
"outputs": [],
"source": [
"# Load the median device noise calibration for your selected processor.\n",
"cal = cirq_google.engine.load_median_device_calibration(processor_id)\n",
"# Load the noise properties for the processor.\n",
"noise_props = cirq_google.engine.load_device_noise_properties(processor_id)\n",
"# Create a noise model from the noise properties.\n",
Expand Down Expand Up @@ -197,6 +197,8 @@
"# Package the simulator and device in an Engine.\n",
"# The device object\n",
"device = cirq_google.engine.create_device_from_processor_id(processor_id)\n",
"# Load the median device noise calibration for your processor.\n",
"cal = cirq_google.engine.load_median_device_calibration(processor_id)\n",
"# The simulated processor object\n",
"sim_processor = cirq_google.engine.SimulatedLocalProcessor(\n",
" processor_id=processor_id, sampler=sim, device=device, calibrations={cal.timestamp // 1000: cal}\n",
Expand Down Expand Up @@ -233,7 +235,13 @@
"source": [
"q0 = cirq.GridQubit(4, 4)\n",
"q1 = cirq.GridQubit(4, 5)\n",
"circuit = cirq.Circuit(cirq.X(q0), cirq.SQRT_ISWAP(q0, q1), cirq.measure([q0, q1], key=\"measure\"))\n",
"circuit = cirq.Circuit(\n",
" cirq.X(q0),\n",
" cirq.X(q1) ** 0.5,\n",
" cirq.CZ(q0, q1),\n",
" cirq.X(q1) ** 0.5,\n",
" cirq.measure([q0, q1], key=\"measure\"),\n",
")\n",
"\n",
"results = sim_engine.get_sampler(processor_id).run(circuit, repetitions=3000)\n",
"\n",
Expand Down
61 changes: 31 additions & 30 deletions docs/simulate/qvm_basic_example.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@
"source": [
"## Create a **Quantum Virtual Machine**\n",
"\n",
"The following cell builds a Quantum Virtual Machine that mimics a particular Google quantum hardware device (currently Rainbow or Weber) using the following customizable steps: \n",
"The following cell builds a Quantum Virtual Machine that mimics a particular Google quantum hardware device (currently Willow-pink, Rainbow or Weber) using the following customizable steps: \n",
"- Constructing a `cirq.NoiseModel` object from device calibration data saved in Cirq. See [Representing Noise](../noise/representing_noise.ipynb) for more on noise models. \n",
"- Building a `qsimcirq.QsimSimulator` that uses this noise model. See [Noisy Simulation](./noisy_simulation.ipynb) and [Noise simulation with qsim](/qsim/tutorials/noisy_qsimcirq) for more. \n",
"- Creating a `cirq.Device` that imposes the same constraints on circuits that the original device would. See [Devices](../hardware/devices.ipynb) for more on these constraint objects. \n",
Expand All @@ -151,17 +151,18 @@
},
"outputs": [],
"source": [
"# @title Choose a processor (\"rainbow\" or \"weber\")\n",
"processor_id = \"weber\" # @param {type:\"string\"}\n",
"# @title Choose a processor (\"willow_pink\" or \"rainbow\" or \"weber\")\n",
"# (see cirq_google.engine.list_virtual_processors() for available names)\n",
"processor_id = \"willow_pink\" # @param {type:\"string\"}\n",
"\n",
"# Construct a simulator with a noise model based on the specified processor.\n",
"cal = cirq_google.engine.load_median_device_calibration(processor_id)\n",
"noise_props = cirq_google.engine.load_device_noise_properties(processor_id)\n",
"noise_model = cirq_google.NoiseModelFromGoogleNoiseProperties(noise_props)\n",
"sim = qsimcirq.QSimSimulator(noise=noise_model)\n",
"\n",
"# Create a device from the public device description\n",
"device = cirq_google.engine.create_device_from_processor_id(processor_id)\n",
"cal = cirq_google.engine.load_median_device_calibration(processor_id)\n",
"# Build the simulated local processor from the simulator and device.\n",
"sim_processor = cirq_google.engine.SimulatedLocalProcessor(\n",
" processor_id=processor_id, sampler=sim, device=device, calibrations={cal.timestamp // 1000: cal}\n",
Expand Down Expand Up @@ -190,7 +191,7 @@
"- Is applied to qubits that exist on the device. \n",
"- Respects the connectivity of qubits on the device.\n",
"\n",
"Below is an example of a circuit that has the correct topology to be placed on the Weber device, and how it is prepared to be run on the QVM."
"Below is an example of a circuit that has the correct topology to be placed on the Willow-pink device, and how it is prepared to be run on the QVM."
]
},
{
Expand Down Expand Up @@ -242,7 +243,7 @@
"source": [
"### Transform the circuit \n",
"\n",
"Before executing a circuit on (virtual) quantum hardware, the operations in the circuit need to be translated to use the types of gates the device supports. The `cirq.optimize_for_target_gateset` function does this for you, transforming the operations to use the `cirq.SqrtIswapTargetGateset`, which is supported by the Weber processor that this QVM is based on. Learn more about the gate set constraints of Google hardware at the [Hardware](../hardware) page."
"Before executing a circuit on (virtual) quantum hardware, the operations in the circuit need to be translated to use the types of gates the device supports. The `cirq.optimize_for_target_gateset` function does this for you, transforming the operations to use the `cirq.CZTargetGateset`, which is supported by the Willow-pink processor that this QVM is based on. Learn more about the gate set constraints of Google hardware at the [Hardware](../hardware) page."
]
},
{
Expand All @@ -253,9 +254,9 @@
},
"outputs": [],
"source": [
"# Convert the gates in the GHZ circuit to the \"SqrtIswap\" gateset, which the device uses.\n",
"# Convert the gates in the GHZ circuit to the \"CZ\" gateset, which the device uses.\n",
"translated_ghz_circuit = cirq.optimize_for_target_gateset(\n",
" ghz_circuit, context=cirq.TransformerContext(deep=True), gateset=cirq.SqrtIswapTargetGateset()\n",
" ghz_circuit, context=cirq.TransformerContext(deep=True), gateset=cirq.CZTargetGateset()\n",
")\n",
"print(translated_ghz_circuit)"
]
Expand All @@ -268,7 +269,7 @@
"source": [
"### Choose qubits on the virtual device\n",
"\n",
"Choose qubits on the device to execute your device ready circuit on. Look at the device map (as above) and choose a set of qubits that fit your circuit (eg a line or a block). The Rainbow and Weber devices have different topologies, some qubit maps may be possible on only one of these devices. As noted, the GHZ example circuit as constructed will fit on a 17 qubit chain of adjacent qubits on the device, so you only need to find this consecutive line of qubits. See [Qubit Picking](../hardware/qubit_picking.ipynb) for more advice and methods for selecting qubits. "
"Choose qubits on the device to execute your device ready circuit on. Look at the device map (as above) and choose a set of qubits that fit your circuit (eg a line or a block). The Willow-pink, Rainbow and Weber devices have different topologies, some qubit maps may be possible on only one of these devices. As noted, the GHZ example circuit as constructed will fit on a 17 qubit chain of adjacent qubits on the device, so you only need to find this consecutive line of qubits. See [Qubit Picking](../hardware/qubit_picking.ipynb) for more advice and methods for selecting qubits. "
]
},
{
Expand All @@ -281,39 +282,39 @@
"source": [
"# Choose qubits on the virtual device\n",
"device_qubit_chain = [\n",
" cirq.GridQubit(5, 2),\n",
" cirq.GridQubit(5, 3),\n",
" cirq.GridQubit(4, 3),\n",
" cirq.GridQubit(4, 2),\n",
" cirq.GridQubit(4, 1),\n",
" cirq.GridQubit(5, 1),\n",
" cirq.GridQubit(6, 1),\n",
" cirq.GridQubit(6, 2),\n",
" cirq.GridQubit(6, 3),\n",
" cirq.GridQubit(6, 4),\n",
" cirq.GridQubit(5, 6),\n",
" cirq.GridQubit(5, 7),\n",
" cirq.GridQubit(4, 7),\n",
" cirq.GridQubit(4, 6),\n",
" cirq.GridQubit(4, 5),\n",
" cirq.GridQubit(5, 5),\n",
" cirq.GridQubit(6, 5),\n",
" cirq.GridQubit(7, 5),\n",
" cirq.GridQubit(8, 5),\n",
" cirq.GridQubit(8, 4),\n",
" cirq.GridQubit(8, 3),\n",
" cirq.GridQubit(7, 3),\n",
" cirq.GridQubit(7, 4),\n",
" cirq.GridQubit(6, 6),\n",
" cirq.GridQubit(6, 7),\n",
" cirq.GridQubit(6, 8),\n",
" cirq.GridQubit(6, 9),\n",
" cirq.GridQubit(7, 9),\n",
" cirq.GridQubit(8, 9),\n",
" cirq.GridQubit(8, 8),\n",
" cirq.GridQubit(8, 7),\n",
" cirq.GridQubit(7, 7),\n",
" cirq.GridQubit(7, 8),\n",
"]\n",
"# Layout:\n",
"#\n",
"# q(4, 1)───q(4, 2)───q(4, 3)\n",
"# q(4, 5)───q(4, 6)───q(4, 7)\n",
"# │ │\n",
"# │ │\n",
"# q(5, 1) q(5, 2)───q(5, 3)\n",
"# q(5, 5) q(5, 6)───q(5, 7)\n",
"# │\n",
"# │\n",
"# q(6, 1)───q(6, 2)───q(6, 3)───q(6, 4)───q(6, 5)\n",
"# q(6, 5)───q(6, 6)───q(6, 7)───q(6, 8)───q(6, 9)\n",
"# │\n",
"# │\n",
"# q(7, 3)───q(7, 4) q(7, 5)\n",
"# q(7, 7)───q(7, 8) q(7, 9)\n",
"# │ │\n",
"# │ │\n",
"# q(8, 3)───q(8, 4)───q(8, 5)"
"# q(8, 7)───q(8, 8)───q(8, 9)"
]
},
{
Expand Down
31 changes: 27 additions & 4 deletions docs/simulate/qvm_builder_code.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,17 @@
"## **Install** Cirq and qsim"
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "3f2687e48726"
},
"source": [
"## Setup\n",
"\n",
"Note: this notebook relies on unreleased Cirq features. If you want to try these features, make sure you install cirq via `pip install --upgrade cirq~=1.0.dev`."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand All @@ -96,7 +107,7 @@
" import cirq_google\n",
"except ImportError:\n",
" print(\"installing cirq...\")\n",
" !pip install --quiet cirq-google\n",
" !pip install --upgrade --quiet cirq-google~=1.0.dev\n",
" print(\"installed cirq.\")\n",
" import cirq\n",
" import cirq_google\n",
Expand Down Expand Up @@ -132,8 +143,9 @@
},
"outputs": [],
"source": [
"# @title Choose a processor (\"rainbow\" or \"weber\")\n",
"processor_id = \"rainbow\" # @param {type:\"string\"}\n",
"# @title Choose a processor (\"willow_pink\" or \"rainbow\" or \"weber\")\n",
"# (see cirq_google.engine.list_virtual_processors() for available names)\n",
"processor_id = \"willow_pink\" # @param {type:\"string\"}\n",
"\n",
"# Instantiate an engine.\n",
"sim_engine = cirq_google.engine.create_default_noisy_quantum_virtual_machine(\n",
Expand Down Expand Up @@ -175,7 +187,7 @@
"outputs": [],
"source": [
"# create your device ready circuit here!\n",
"q0 = cirq.GridQubit(4, 1)\n",
"q0 = cirq.GridQubit(6, 3)\n",
"your_circuit = cirq.Circuit([(cirq.X**0.5)(q0), cirq.measure(q0)])\n",
"print(your_circuit)"
]
Expand Down Expand Up @@ -210,6 +222,17 @@
"print(f'QVM runtime: {elapsed:.04g}s ({reps} reps)')\n",
"print('You can now print or plot \"results\"')"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"id": "98bf142f5be6"
},
"outputs": [],
"source": [
"print(f\"measurements: {results.histogram(key=q0)}\")"
]
}
],
"metadata": {
Expand Down
42 changes: 28 additions & 14 deletions docs/simulate/qvm_stabilizer_example.ipynb
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,17 @@
"## **Install** Cirq and qsim, Create **Quantum Virtual Machine**"
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "3f2687e48726"
},
"source": [
"## Setup\n",
"\n",
"Note: this notebook relies on unreleased Cirq features. If you want to try these features, make sure you install cirq via `pip install --upgrade cirq~=1.0.dev`."
]
},
{
"cell_type": "code",
"execution_count": null,
Expand All @@ -96,7 +107,7 @@
" import cirq_google\n",
"except ImportError:\n",
" print(\"installing cirq...\")\n",
" !pip install --quiet cirq-google\n",
" !pip install --upgrade --quiet cirq-google~=1.0.dev\n",
" print(\"installed cirq.\")\n",
" import cirq\n",
" import cirq_google\n",
Expand Down Expand Up @@ -124,8 +135,9 @@
},
"outputs": [],
"source": [
"# @title Create Quantum Virtual Machine: Choose a processor (\"rainbow\" or \"weber\")\n",
"processor_id = \"rainbow\" # @param {type:\"string\"}\n",
"# @title Create Quantum Virtual Machine: Choose a processor (\"willow_pink\", \"rainbow\" or \"weber\")\n",
"# (see cirq_google.engine.list_virtual_processors() for available names)\n",
"processor_id = \"willow_pink\" # @param {type:\"string\"}\n",
"\n",
"# Instantiate the engine.\n",
"sim_engine = cirq_google.engine.create_default_noisy_quantum_virtual_machine(\n",
Expand Down Expand Up @@ -214,8 +226,7 @@
"source": [
"simulator = cirq.Simulator()\n",
"result = simulator.run(stabilizer_circuit, repetitions=100)\n",
"ax = cirq.plot_state_histogram(result)\n",
"plt.show(ax)"
"cirq.plot_state_histogram(result)"
]
},
{
Expand Down Expand Up @@ -254,8 +265,7 @@
"outputs": [],
"source": [
"result = simulator.run(stabilizer_circuit_with_error, repetitions=100)\n",
"ax = cirq.plot_state_histogram(result)\n",
"plt.show(ax)"
"cirq.plot_state_histogram(result)"
]
},
{
Expand Down Expand Up @@ -313,11 +323,16 @@
" cirq.GridQubit(6, 3),\n",
"]\n",
"\n",
"if processor_id == \"willow_pink\":\n",
" target_gateset = cirq.CZTargetGateset()\n",
"else:\n",
" target_gateset = cirq.SqrtIswapTargetGateset()\n",
"\n",
"# Translate the circuit to a suitable gate set.\n",
"test_stabilizer_circuit = cirq.optimize_for_target_gateset(\n",
" stabilizer_circuit_for_hardware,\n",
" context=cirq.TransformerContext(deep=True),\n",
" gateset=cirq.SqrtIswapTargetGateset(),\n",
" gateset=target_gateset,\n",
")\n",
"# Map circuit qubits to hardware ones.\n",
"qubit_map = dict(zip([measure_qubit] + data_qubits, device_stabilizer_plaquette))\n",
Expand Down Expand Up @@ -378,8 +393,7 @@
"\n",
"print(\"Results (<meas>_<data>)\")\n",
"ax = cirq.plot_state_histogram(hist)\n",
"plt.setp(ax.get_xticklabels(), rotation=30, horizontalalignment='right')\n",
"plt.show(ax)"
"plt.setp(ax.get_xticklabels(), rotation=30, horizontalalignment='right');"
]
},
{
Expand All @@ -406,7 +420,7 @@
"}\n",
"\n",
"heatmap = cirq.Heatmap({**meas_map, **data_map})\n",
"heatmap.plot()"
"heatmap.plot();"
]
},
{
Expand Down Expand Up @@ -560,7 +574,7 @@
"}\n",
"\n",
"heatmap = cirq.Heatmap({**meas_map, **data_map})\n",
"heatmap.plot()"
"heatmap.plot();"
]
},
{
Expand All @@ -587,7 +601,7 @@
"test_stabilizer_grid_circuit = cirq.optimize_for_target_gateset(\n",
" cirq.Circuit(cirq.decompose(stabilizer_grid_circuit)),\n",
" context=cirq.TransformerContext(deep=True),\n",
" gateset=cirq.SqrtIswapTargetGateset(),\n",
" gateset=target_gateset,\n",
")\n",
"print(test_stabilizer_grid_circuit)"
]
Expand Down Expand Up @@ -628,7 +642,7 @@
"}\n",
"\n",
"heatmap = cirq.Heatmap({**meas_map, **data_map})\n",
"heatmap.plot()"
"heatmap.plot();"
]
}
],
Expand Down
Loading