From 5c8d15187fb4891d7faecf5088c2d35c18cd1a74 Mon Sep 17 00:00:00 2001 From: Meltem Tolunay Date: Mon, 6 Apr 2026 14:26:12 -0700 Subject: [PATCH 1/4] update error detection tutorial --- docs/tutorials/ghz-spacetime-codes.ipynb | 37 ++++++++++++++++-------- 1 file changed, 25 insertions(+), 12 deletions(-) diff --git a/docs/tutorials/ghz-spacetime-codes.ipynb b/docs/tutorials/ghz-spacetime-codes.ipynb index ce79d3bfac5..a302709bcb2 100644 --- a/docs/tutorials/ghz-spacetime-codes.ipynb +++ b/docs/tutorials/ghz-spacetime-codes.ipynb @@ -17,7 +17,13 @@ "\n", "*Usage estimate: 10 seconds on a Heron r3 processor (NOTE: This is an estimate only. Your runtime might vary.)*\n", "\n", - "## Introduction\n", + "## Learning outcomes\n", + "\n", + "After going through this tutorial, users should understand:\n", + "- Basics of setting up an error detection technique using spacetime codes\n", + "- How to set up a high-fidelity GHZ state on hardware using error detection\n", + "\n", + "## Background\n", "\n", "[Low-overhead error detection with spacetime codes](https://arxiv.org/abs/2504.15725) [[1]](#references) by Simon Martiel and Ali Javadi-Abhari proposes synthesizing low-weight, connectivity-aware spacetime checks for Clifford-dominated circuits, then post-selecting on those checks to catch faults with far less overhead than full error correction and fewer shots than standard error mitigation.\n", "\n", @@ -35,8 +41,8 @@ "id": "fce0de6c", "metadata": {}, "source": [ - "### Requirements\n", - "Before starting this tutorial, ensure that you have the following installed:\n", + "## Requirements\n", + "Before starting this tutorial, be sure you have the following installed:\n", "\n", "- Qiskit SDK v2.0 or later, with [visualization](/docs/api/qiskit/visualization) support\n", "- Qiskit Runtime v0.40 or later (`pip install qiskit-ibm-runtime`)\n", @@ -51,7 +57,7 @@ "id": "4286334d", "metadata": {}, "source": [ - "### Setup" + "## Setup" ] }, { @@ -107,7 +113,7 @@ "id": "3888d8aa", "metadata": {}, "source": [ - "## First example" + "## Small-scale simulator example" ] }, { @@ -523,7 +529,7 @@ "id": "7027e13d", "metadata": {}, "source": [ - "## Real-world example: Prepare a GHZ state on real hardware" + "## Large-scale hardware example: Prepare a GHZ state on real hardware" ] }, { @@ -1786,9 +1792,10 @@ "id": "5423c559", "metadata": {}, "source": [ - "## Discussion\n", - "\n", - "In this tutorial, we showed how to implement a low-overhead error detection technique using spacetime codes, and demonstrated its real-world application to preparing GHZ states on hardware. Refer to [[3]](https://arxiv.org/abs/2510.09520) to further explore technical details of GHZ state preparation. In addition to error detection, authors utilize readout error mitigation with M3 and TREX and perform temporary uncomputation techniques to prepare high-fidelity GHZ states." + "## Next steps\n", + "If you found this work interesting, you might be interested in the following material:\n", + "- [[3]](https://arxiv.org/abs/2510.09520) to further explore technical details of GHZ state preparation. In addition to error detection, authors utilize readout error mitigation with M3 and TREX and perform temporary uncomputation techniques to prepare high-fidelity GHZ states.\n", + "- Tutorial on [repetition codes](https://quantum.cloud.ibm.com/docs/en/tutorials/repetition-codes)." ] }, { @@ -1799,13 +1806,19 @@ "### References\n", "- [1] Martiel, S., & Javadi-Abhari, A. (2025). Low-overhead error detection with spacetime codes. *arXiv preprint arXiv:2504.15725.*\n", "- [2] van den Berg, E., Bravyi, S., Gambetta, J. M., Jurcevic, P., Maslov, D., & Temme, K. (2023). Single-shot error mitigation by coherent Pauli checks. *Physical Review Research*, 5(3), 033193.\n", - "- [3] Javadi-Abhari, A., Martiel, S., Seif, A., Takita, M., & Wei, K. X. (2025). Big cats: entanglement in 120 qubits and beyond. arXiv preprint arXiv:2510.09520." + "- [3] Javadi-Abhari, A., Martiel, S., Seif, A., Takita, M., & Wei, K. X. (2025). Big cats: entanglement in 120 qubits and beyond. *arXiv preprint arXiv:2510.09520*." ] + }, + { + "cell_type": "markdown", + "id": "e43daf11", + "metadata": {}, + "source": [] } ], "metadata": { "kernelspec": { - "display_name": "Python 3", + "display_name": "quantum2", "language": "python", "name": "python3" }, @@ -1819,7 +1832,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3" + "version": "3.12.10" } }, "nbformat": 4, From 54b14393b4e6d077fe55c6d85c85f633a9d2cf9f Mon Sep 17 00:00:00 2001 From: Meltem Tolunay Date: Mon, 6 Apr 2026 16:18:09 -0700 Subject: [PATCH 2/4] delete empty cell --- docs/tutorials/ghz-spacetime-codes.ipynb | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/tutorials/ghz-spacetime-codes.ipynb b/docs/tutorials/ghz-spacetime-codes.ipynb index a302709bcb2..c182dd2d7e3 100644 --- a/docs/tutorials/ghz-spacetime-codes.ipynb +++ b/docs/tutorials/ghz-spacetime-codes.ipynb @@ -1808,12 +1808,6 @@ "- [2] van den Berg, E., Bravyi, S., Gambetta, J. M., Jurcevic, P., Maslov, D., & Temme, K. (2023). Single-shot error mitigation by coherent Pauli checks. *Physical Review Research*, 5(3), 033193.\n", "- [3] Javadi-Abhari, A., Martiel, S., Seif, A., Takita, M., & Wei, K. X. (2025). Big cats: entanglement in 120 qubits and beyond. *arXiv preprint arXiv:2510.09520*." ] - }, - { - "cell_type": "markdown", - "id": "e43daf11", - "metadata": {}, - "source": [] } ], "metadata": { From bf870395c8ac697454fb69c70bfc303453561f1e Mon Sep 17 00:00:00 2001 From: Meltem Tolunay Date: Mon, 6 Apr 2026 16:37:52 -0700 Subject: [PATCH 3/4] revert notebook metadata --- docs/tutorials/ghz-spacetime-codes.ipynb | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/tutorials/ghz-spacetime-codes.ipynb b/docs/tutorials/ghz-spacetime-codes.ipynb index c182dd2d7e3..a14f53fa359 100644 --- a/docs/tutorials/ghz-spacetime-codes.ipynb +++ b/docs/tutorials/ghz-spacetime-codes.ipynb @@ -1811,6 +1811,7 @@ } ], "metadata": { + "description": "Experiment with error detection on a small-scale random Clifford circuit, then walk through the task of GHZ state preparation.", "kernelspec": { "display_name": "quantum2", "language": "python", @@ -1827,7 +1828,8 @@ "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.12.10" - } + }, + "title": "Low-overhead error detection with spacetime codes" }, "nbformat": 4, "nbformat_minor": 5 From 343e63bf55ae6c9a3983ccd212aa82b58f4ddb18 Mon Sep 17 00:00:00 2001 From: Meltem Tolunay Date: Mon, 6 Apr 2026 16:44:14 -0700 Subject: [PATCH 4/4] fix metadata --- docs/tutorials/ghz-spacetime-codes.ipynb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tutorials/ghz-spacetime-codes.ipynb b/docs/tutorials/ghz-spacetime-codes.ipynb index a14f53fa359..e4ff130d51d 100644 --- a/docs/tutorials/ghz-spacetime-codes.ipynb +++ b/docs/tutorials/ghz-spacetime-codes.ipynb @@ -1813,7 +1813,7 @@ "metadata": { "description": "Experiment with error detection on a small-scale random Clifford circuit, then walk through the task of GHZ state preparation.", "kernelspec": { - "display_name": "quantum2", + "display_name": "Python 3", "language": "python", "name": "python3" }, @@ -1827,7 +1827,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.12.10" + "version": "3" }, "title": "Low-overhead error detection with spacetime codes" },