From ae1abe11671991728520aabc1b30cf3608cf6f09 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock Date: Tue, 30 Jul 2024 14:39:42 -0500 Subject: [PATCH 1/8] Add a few links --- docs/guides/circuit-library.ipynb | 4 ++-- docs/guides/classical-feedforward-and-control-flow.ipynb | 2 +- docs/guides/construct-circuits.ipynb | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/guides/circuit-library.ipynb b/docs/guides/circuit-library.ipynb index 7c0031068e1..38a48f15758 100644 --- a/docs/guides/circuit-library.ipynb +++ b/docs/guides/circuit-library.ipynb @@ -14,9 +14,9 @@ "id": "6f257ff9-15c4-48d8-9503-7f0ab16a91b2", "metadata": {}, "source": [ - "The Qiskit SDK includes a library of popular circuits to use as building blocks in your own programs. Using pre-defined circuits saves time researching, writing code, and debugging. The library includes popular circuits in quantum computing, circuits that are difficult to simulate classically, and circuits useful for quantum hardware benchmarking.\n", + "The Qiskit SDK includes a library of popular circuits to use as building blocks in your own programs. Using pre-defined circuits saves time researching, writing code, and debugging. The library includes popular circuits in quantum computing, circuits that are difficult to simulate classically, and circuits useful for quantum hardware benchmarking. \n", "\n", - "This page lists the different circuit categories the library provides. For a full list of circuits, see the [circuit library API documentation](/api/qiskit/circuit_library)." + "This page lists the different circuit categories the library provides. For a full list of circuits, see the [circuit library API documentation](/api/qiskit/circuit_library). To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)" ] }, { diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 6789322d18d..0c187c29edb 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -14,7 +14,7 @@ "- For loop - [`QuantumCircuit.for_loop`](../api/qiskit/qiskit.circuit.QuantumCircuit#for_loop)\n", "- While loop - [`QuantumCircuit.while_loop`](../api/qiskit/qiskit.circuit.QuantumCircuit#while_loop)\n", "\n", - "Each of these methods returns a [context manager](https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers) and is typically used in a `with` statement. In the rest of this guide, we will explain each of these constructs and how to use them.\n", + "Each of these methods returns a [context manager](https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers) and is typically used in a `with` statement. In the rest of this guide, we will explain each of these constructs and how to use them. To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)\n", "\n", "\n", " There are some limitations of classical feedforward and control flow operations on quantum hardware that might impact your program. For more information, see [Hardware considerations and limitations for classical feedforward and control flow](./dynamic-circuits-considerations).\n", diff --git a/docs/guides/construct-circuits.ipynb b/docs/guides/construct-circuits.ipynb index 0bb73587f5d..ab35089954c 100644 --- a/docs/guides/construct-circuits.ipynb +++ b/docs/guides/construct-circuits.ipynb @@ -13,7 +13,7 @@ "id": "c50d8e43-ae82-4e41-8d17-a37332d1bf6d", "metadata": {}, "source": [ - "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits." + "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)" ] }, { From 3bd567b6b2df5ca534c151ea728a2dfa32fe4b19 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock Date: Tue, 30 Jul 2024 15:43:59 -0500 Subject: [PATCH 2/8] Options --- .../classical-feedforward-and-control-flow.ipynb | 3 ++- docs/guides/construct-circuits.ipynb | 10 +++++++++- 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 0c187c29edb..1e8ebd6c519 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -379,7 +379,8 @@ "## Next steps\n", "\n", "\n", - " - See an example of dynamic circuits in the [Repeat until success](https://learning.quantum.ibm.com/tutorial/repeat-until-success) tutorial.\n", + " - To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/) \n", + " - See an example of dynamic circuits in the [Repeat until success](https://learning.quantum.ibm.com/tutorial/repeat-until-success) tutorial.\n", " - Review the [circuit library API](/api/qiskit/circuit_library) reference.\n", "" ] diff --git a/docs/guides/construct-circuits.ipynb b/docs/guides/construct-circuits.ipynb index ab35089954c..ca89a87c05a 100644 --- a/docs/guides/construct-circuits.ipynb +++ b/docs/guides/construct-circuits.ipynb @@ -8,12 +8,20 @@ "# Construct circuits" ] }, + { + "cell_type": "markdown", + "id": "b8e2fc2d", + "metadata": {}, + "source": [ + "_To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)_" + ] + }, { "cell_type": "markdown", "id": "c50d8e43-ae82-4e41-8d17-a37332d1bf6d", "metadata": {}, "source": [ - "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)" + "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. " ] }, { From 710199a357010462202e8cf0b028e36391e52aa6 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Date: Tue, 30 Jul 2024 15:54:18 -0500 Subject: [PATCH 3/8] Update docs/guides/circuit-library.ipynb --- docs/guides/circuit-library.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/circuit-library.ipynb b/docs/guides/circuit-library.ipynb index 38a48f15758..60adfd1a5b3 100644 --- a/docs/guides/circuit-library.ipynb +++ b/docs/guides/circuit-library.ipynb @@ -14,7 +14,7 @@ "id": "6f257ff9-15c4-48d8-9503-7f0ab16a91b2", "metadata": {}, "source": [ - "The Qiskit SDK includes a library of popular circuits to use as building blocks in your own programs. Using pre-defined circuits saves time researching, writing code, and debugging. The library includes popular circuits in quantum computing, circuits that are difficult to simulate classically, and circuits useful for quantum hardware benchmarking. \n", + "The Qiskit SDK includes a library of popular circuits to use as building blocks in your own programs. Using pre-defined circuits saves time researching, writing code, and debugging. The library includes popular circuits in quantum computing, circuits that are difficult to simulate classically, and circuits useful for quantum hardware benchmarking.", "\n", "This page lists the different circuit categories the library provides. For a full list of circuits, see the [circuit library API documentation](/api/qiskit/circuit_library). To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)" ] From 986e661c2a02623628cb44ea61cb203d842e0d93 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Date: Tue, 30 Jul 2024 15:54:24 -0500 Subject: [PATCH 4/8] Update docs/guides/construct-circuits.ipynb --- docs/guides/construct-circuits.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/construct-circuits.ipynb b/docs/guides/construct-circuits.ipynb index ca89a87c05a..0701c7f1738 100644 --- a/docs/guides/construct-circuits.ipynb +++ b/docs/guides/construct-circuits.ipynb @@ -21,7 +21,7 @@ "id": "c50d8e43-ae82-4e41-8d17-a37332d1bf6d", "metadata": {}, "source": [ - "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. " + "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. " ] }, { From 8cd1d441b2bbff23586a4183ed2715005ba4706b Mon Sep 17 00:00:00 2001 From: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Date: Tue, 30 Jul 2024 15:54:31 -0500 Subject: [PATCH 5/8] Update docs/guides/classical-feedforward-and-control-flow.ipynb --- docs/guides/classical-feedforward-and-control-flow.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/classical-feedforward-and-control-flow.ipynb b/docs/guides/classical-feedforward-and-control-flow.ipynb index 1e8ebd6c519..9c6bc498f41 100644 --- a/docs/guides/classical-feedforward-and-control-flow.ipynb +++ b/docs/guides/classical-feedforward-and-control-flow.ipynb @@ -379,7 +379,7 @@ "## Next steps\n", "\n", "\n", - " - To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/) \n", + " - To learn what's included in the latest release, review the [Qiskit SDK release notes.](/api/qiskit/release-notes/)", " - See an example of dynamic circuits in the [Repeat until success](https://learning.quantum.ibm.com/tutorial/repeat-until-success) tutorial.\n", " - Review the [circuit library API](/api/qiskit/circuit_library) reference.\n", "" From 843c4be4de9c73637aa3197479a602a9e7c92351 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock <66339736+beckykd@users.noreply.github.com> Date: Tue, 30 Jul 2024 16:03:31 -0500 Subject: [PATCH 6/8] Update docs/guides/construct-circuits.ipynb --- docs/guides/construct-circuits.ipynb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/construct-circuits.ipynb b/docs/guides/construct-circuits.ipynb index 0701c7f1738..ae33ce9a6d9 100644 --- a/docs/guides/construct-circuits.ipynb +++ b/docs/guides/construct-circuits.ipynb @@ -21,7 +21,7 @@ "id": "c50d8e43-ae82-4e41-8d17-a37332d1bf6d", "metadata": {}, "source": [ - "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits. " + "This page takes a closer look at the [`QuantumCircuit`](/api/qiskit/qiskit.circuit.QuantumCircuit) class in the Qiskit SDK, including some more advanced methods you can use to create quantum circuits." ] }, { From 53fe255100384ab31b7f2e5331a773ff6966cacd Mon Sep 17 00:00:00 2001 From: Rebecca Dimock Date: Mon, 5 Aug 2024 15:15:46 -0500 Subject: [PATCH 7/8] Add one more option --- docs/guides/synthesize-unitary-operators.mdx | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/guides/synthesize-unitary-operators.mdx b/docs/guides/synthesize-unitary-operators.mdx index 604d8a1e5ee..9b359207443 100644 --- a/docs/guides/synthesize-unitary-operators.mdx +++ b/docs/guides/synthesize-unitary-operators.mdx @@ -5,6 +5,13 @@ description: On the implementation of arbitrary unitary matrices on qubits # Synthesize unitary operations +## What's required + +Running the code in this topic requires Qiskit SDK 1.0 or later, with visualization support ( pip install 'qiskit[visualization]' ). +To learn about the latest changes to Qiskit SDK 1.0, review the most recent [release notes.](/api/qiskit/release-notes) + +## Introduction + A unitary operation describes a norm-preserving change to a quantum system. For $n$ qubits this change is described by a $2^n \times 2^n$ dimensional, complex matrix $U$ whose adjoint equals the inverse, that is $U^\dagger U = \mathbb{1}$. @@ -15,7 +22,7 @@ For general unitary matrices, synthesis is a complex task with computational cos Therefore, if you know an efficient decomposition for the unitary you would like to implement, it will likely be better than a general synthesis. - If no decomposition is available, the Qiskit SDK provides you with the tools to find one. + If no decomposition is available, the Qiskit SDK provides you with the tools to find one. However, note that this generally generates deep circuits that may be unsuitable to run on noisy quantum computers. @@ -61,7 +68,7 @@ circuit.draw("mpl") However, after re-synthesizing with the following code, it only needs a single CX gate. (Here we use the `QuantumCircuit.decompose()` method to better visualize the gates used to re-synthesize the unitary.) -```python +```python from qiskit.quantum_info import Operator # compute unitary matrix of circuit From c457e9fa246f24238e07c030ee042686162a5f28 Mon Sep 17 00:00:00 2001 From: Rebecca Dimock Date: Tue, 6 Aug 2024 11:26:32 -0500 Subject: [PATCH 8/8] edits --- docs/guides/synthesize-unitary-operators.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/synthesize-unitary-operators.mdx b/docs/guides/synthesize-unitary-operators.mdx index 9b359207443..c8a5b87dd0e 100644 --- a/docs/guides/synthesize-unitary-operators.mdx +++ b/docs/guides/synthesize-unitary-operators.mdx @@ -5,9 +5,9 @@ description: On the implementation of arbitrary unitary matrices on qubits # Synthesize unitary operations -## What's required +### What's required -Running the code in this topic requires Qiskit SDK 1.0 or later, with visualization support ( pip install 'qiskit[visualization]' ). +Running the code in this topic requires Qiskit SDK 1.0 or later, with visualization support ( `pip install qiskit[visualization]` ). To learn about the latest changes to Qiskit SDK 1.0, review the most recent [release notes.](/api/qiskit/release-notes) ## Introduction