From 78b42ea1661d5559254c3c48b35608af0fb9ad9d Mon Sep 17 00:00:00 2001 From: ABBY CROSS Date: Thu, 9 Oct 2025 12:16:34 -0400 Subject: [PATCH 01/12] Add new addons to overview page --- docs/guides/addons.mdx | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 22b44f449f8..bf0bdea34e7 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -41,6 +41,19 @@ Circuit cutting reduces the depth of transpiled circuits by decomposing entangli - Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-cutting) - Read the [documentation.](https://qiskit.github.io/qiskit-addon-cutting) + +### Propagated noise absorption + +Propagated noise absorption (PNA) uses Pauli propagation to absorb information from a noise model into a target observable. Measuring this modified observable has the effect of mitigating the noise as represented by the model. + +Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) + +### Shaded lightcones + +Shaded lightcones uses Pauli propagation to reduce the number of error terms accounted for in a noise model according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probablistic error cancellation (PEC) workflows. + +Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-slc) + ## Addons for post-processing ### Sample-based quantum diagonalization From 3479b214ef93acc05299e550f0b0c926e4540d05 Mon Sep 17 00:00:00 2001 From: ABBY CROSS Date: Thu, 9 Oct 2025 12:24:28 -0400 Subject: [PATCH 02/12] fix spelling --- docs/guides/addons.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index bf0bdea34e7..8cc0e05fae6 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -3,6 +3,8 @@ title: Qiskit addons description: Understand the Qiskit addon tools, which help you build utility-grade quantum workflows. --- +{/* cspell:ignore lightcones */} + # Qiskit addons Qiskit addons are a collection of research capabilities for enabling algorithm discovery at the utility scale. These capabilities build on Qiskit's performant foundation of tools for creating and running quantum algorithms. They are provided as modular software components that can plug into a [workflow](/docs/guides/intro-to-patterns) to scale or design new quantum algorithms. @@ -50,7 +52,7 @@ Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) ### Shaded lightcones -Shaded lightcones uses Pauli propagation to reduce the number of error terms accounted for in a noise model according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probablistic error cancellation (PEC) workflows. +The shaded lightcones addon uses Pauli propagation to reduce the number of error terms accounted for in a noise model according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows. Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-slc) From 53f346df4fe0ad422723d256a30bffc5138203bf Mon Sep 17 00:00:00 2001 From: abbycross Date: Thu, 6 Nov 2025 09:48:50 -0500 Subject: [PATCH 03/12] code review Co-authored-by: aeddins-ibm <60495383+aeddins-ibm@users.noreply.github.com> --- docs/guides/addons.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 8cc0e05fae6..559b3ae2fa4 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -52,7 +52,7 @@ Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) ### Shaded lightcones -The shaded lightcones addon uses Pauli propagation to reduce the number of error terms accounted for in a noise model according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows. +The shaded lightcones addon uses Pauli propagation to reduce the number of error terms in a noise model that need to be mitigated, according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows. Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-slc) From 7f98f4a033f083a4bbc3aa17f74d0c24112f8541 Mon Sep 17 00:00:00 2001 From: ABBY CROSS Date: Thu, 6 Nov 2025 10:16:44 -0500 Subject: [PATCH 04/12] new section and mark placeholders --- docs/guides/addons.mdx | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 559b3ae2fa4..f663cbb10c7 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -26,6 +26,10 @@ Multi-product formulas (MPF) reduce the Trotter error of Hamiltonian dynamics th - Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-mpf) - Read the [documentation.](https://qiskit.github.io/qiskit-addon-mpf) +### Optimization mapper + +((())) + ## Addons for optimizing ### Operator backpropagation @@ -43,12 +47,23 @@ Circuit cutting reduces the depth of transpiled circuits by decomposing entangli - Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-cutting) - Read the [documentation.](https://qiskit.github.io/qiskit-addon-cutting) +## Addons for post-processing -### Propagated noise absorption +### Sample-based quantum diagonalization -Propagated noise absorption (PNA) uses Pauli propagation to absorb information from a noise model into a target observable. Measuring this modified observable has the effect of mitigating the noise as represented by the model. +Sample-based quantum diagonalization (SQD) classically post-processes noisy quantum samples to yield more accurate eigenvalue estimations of quantum system Hamiltonians, for example in chemistry applications. -Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) +- Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-sqd) +- Read the [documentation.](/docs/guides/qiskit-addons-sqd) +- Read the tutorial on [Sample-based quantum diagonalization of a chemistry Hamiltonian.](/docs/tutorials/sample-based-quantum-diagonalization) + +### SQD for HPC +((())) + +## Addons for error mitigation + +### mthree +((())) ### Shaded lightcones @@ -56,12 +71,9 @@ The shaded lightcones addon uses Pauli propagation to reduce the number of error Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-slc) -## Addons for post-processing -### Sample-based quantum diagonalization +### Propagated noise absorption -Sample-based quantum diagonalization (SQD) classically post-processes noisy quantum samples to yield more accurate eigenvalue estimations of quantum system Hamiltonians, for example in chemistry applications. +Propagated noise absorption (PNA) uses Pauli propagation to absorb information from a noise model into a target observable. Measuring this modified observable has the effect of mitigating the noise as represented by the model. -- Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-sqd) -- Read the [documentation.](/docs/guides/qiskit-addons-sqd) -- Read the tutorial on [Sample-based quantum diagonalization of a chemistry Hamiltonian.](/docs/tutorials/sample-based-quantum-diagonalization) +Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) From a6dff14f3041d42dc0c07470ba39da5561ee8eb2 Mon Sep 17 00:00:00 2001 From: ABBY CROSS Date: Thu, 6 Nov 2025 10:31:25 -0500 Subject: [PATCH 05/12] add in URLs --- docs/guides/addons.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index f663cbb10c7..606184abea0 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -30,6 +30,9 @@ Multi-product formulas (MPF) reduce the Trotter error of Hamiltonian dynamics th ((())) +Visit the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. + + ## Addons for optimizing ### Operator backpropagation @@ -60,11 +63,15 @@ Sample-based quantum diagonalization (SQD) classically post-processes noisy quan ### SQD for HPC ((())) +- Visit the [API reference](https://qiskit.github.io/qiskit-addon-sqd-hpc/) documentation. + ## Addons for error mitigation ### mthree ((())) +Visit the [documentation](https://qiskit.github.io/qiskit-addon-mthree/) for how-to guides, tutorials, and API references. + ### Shaded lightcones The shaded lightcones addon uses Pauli propagation to reduce the number of error terms in a noise model that need to be mitigated, according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows. From ba706b118b6b65a03b38e26e1bf9ff3dc5f657bd Mon Sep 17 00:00:00 2001 From: abbycross Date: Thu, 6 Nov 2025 12:28:00 -0500 Subject: [PATCH 06/12] Apply suggestions from code review --- docs/guides/addons.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 606184abea0..3558758984c 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -30,7 +30,7 @@ Multi-product formulas (MPF) reduce the Trotter error of Hamiltonian dynamics th ((())) -Visit the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. +- Visit the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. ## Addons for optimizing @@ -70,13 +70,13 @@ Sample-based quantum diagonalization (SQD) classically post-processes noisy quan ### mthree ((())) -Visit the [documentation](https://qiskit.github.io/qiskit-addon-mthree/) for how-to guides, tutorials, and API references. +- Visit the [documentation](https://qiskit.github.io/qiskit-addon-mthree/) for how-to guides, tutorials, and API references. ### Shaded lightcones The shaded lightcones addon uses Pauli propagation to reduce the number of error terms in a noise model that need to be mitigated, according to the specifics of the target observable. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows. -Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-slc) +- Visit the [documentation](https://qiskit.github.io/qiskit-addon-slc/) for how-to guides, tutorials, and API references. ### Propagated noise absorption From 44323ba18bb1eec47f1d56bfe550580dca395643 Mon Sep 17 00:00:00 2001 From: abbycross Date: Thu, 6 Nov 2025 19:16:24 -0500 Subject: [PATCH 07/12] blurb for Optim. mapper --- docs/guides/addons.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 3558758984c..87d5d351e6f 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -28,7 +28,7 @@ Multi-product formulas (MPF) reduce the Trotter error of Hamiltonian dynamics th ### Optimization mapper -((())) +The Optimization Mapper addon contains functionality to model optimization problems by formulating them in abstract models and then converting into representations that a quantum computer can understand. - Visit the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. From b2e6d525aed754243ff2650ab8b8f31bf015e21f Mon Sep 17 00:00:00 2001 From: abbycross Date: Fri, 7 Nov 2025 09:20:07 -0500 Subject: [PATCH 08/12] PNA is now live --- docs/guides/addons.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 87d5d351e6f..9d1dd3c59c9 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -83,4 +83,4 @@ The shaded lightcones addon uses Pauli propagation to reduce the number of error Propagated noise absorption (PNA) uses Pauli propagation to absorb information from a noise model into a target observable. Measuring this modified observable has the effect of mitigating the noise as represented by the model. -Visit the [GitHub repository.](https://github.com/Qiskit/qiskit-addon-pna) +- Visit the [documentation](https://qiskit.github.io/qiskit-addon-pna/apidocs/qiskit_addon_pna.html) for how-to guides, tutorials, and API references. From f85d111f587c1e5b780202a17ed27ec727661647 Mon Sep 17 00:00:00 2001 From: ABBY CROSS Date: Fri, 7 Nov 2025 09:28:11 -0500 Subject: [PATCH 09/12] borrowing from hpc docs for the blurb --- docs/guides/addons.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 9d1dd3c59c9..80075630944 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -61,7 +61,8 @@ Sample-based quantum diagonalization (SQD) classically post-processes noisy quan - Read the tutorial on [Sample-based quantum diagonalization of a chemistry Hamiltonian.](/docs/tutorials/sample-based-quantum-diagonalization) ### SQD for HPC -((())) + +Unlike the existing Python addon, this code is written in modern C++17 and is designed to enable HPC workflows and applications, particularly those that require a single binary to be compiled for use with MPI. - Visit the [API reference](https://qiskit.github.io/qiskit-addon-sqd-hpc/) documentation. From 13d728c331af1a4fc89aa3f2f16c43d0a8dfea09 Mon Sep 17 00:00:00 2001 From: abbycross Date: Fri, 7 Nov 2025 09:33:24 -0500 Subject: [PATCH 10/12] snag blurb from its docs --- docs/guides/addons.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 80075630944..06bf6e67ec5 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -68,10 +68,9 @@ Unlike the existing Python addon, this code is written in modern C++17 and is de ## Addons for error mitigation -### mthree -((())) +### M3 (mthree) -- Visit the [documentation](https://qiskit.github.io/qiskit-addon-mthree/) for how-to guides, tutorials, and API references. +- M3 (or mthree) is a package for scalable quantum measurement error mitigation that need not explicitly form the assignment matrix, or its inverse - and is thus a matrix-free measurement mitigation (M3) routine. ### Shaded lightcones From eaf4c9ff2b1988ee5370f357a6546dd8f1c7d87d Mon Sep 17 00:00:00 2001 From: abbycross Date: Fri, 7 Nov 2025 11:03:52 -0500 Subject: [PATCH 11/12] Apply suggestions from code review Co-authored-by: Kaelyn Ferris <43348706+kaelynj@users.noreply.github.com> --- docs/guides/addons.mdx | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index 06bf6e67ec5..b906822d8ef 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -62,7 +62,7 @@ Sample-based quantum diagonalization (SQD) classically post-processes noisy quan ### SQD for HPC -Unlike the existing Python addon, this code is written in modern C++17 and is designed to enable HPC workflows and applications, particularly those that require a single binary to be compiled for use with MPI. +This addon is an HPC-ready implementation of the SQD addon. It is written in modern C++17 standards and is designed to create a single compiled binary for use with MPI. - Visit the [API reference](https://qiskit.github.io/qiskit-addon-sqd-hpc/) documentation. @@ -70,7 +70,10 @@ Unlike the existing Python addon, this code is written in modern C++17 and is de ### M3 (mthree) -- M3 (or mthree) is a package for scalable quantum measurement error mitigation that need not explicitly form the assignment matrix, or its inverse - and is thus a matrix-free measurement mitigation (M3) routine. +Matrix-free Measurement Mitigation (M3) is a package for scalable quantum measurement error mitigation that can be computed in parallel. + +- Visit the [documentation](https://qiskit.github.io/qiskit-addon-mthree/) for how-to guides, tutorials, and API references. +- Visit the package's [GitHub](https://github.com/Qiskit/qiskit-addon-mthree) page. ### Shaded lightcones From 2e48692be1926885f356b773936eb3569f0738b1 Mon Sep 17 00:00:00 2001 From: abbycross Date: Fri, 7 Nov 2025 13:17:34 -0500 Subject: [PATCH 12/12] Apply suggestions from code review Co-authored-by: Kaelyn Ferris <43348706+kaelynj@users.noreply.github.com> --- docs/guides/addons.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/guides/addons.mdx b/docs/guides/addons.mdx index b906822d8ef..736d9ada65e 100644 --- a/docs/guides/addons.mdx +++ b/docs/guides/addons.mdx @@ -30,7 +30,8 @@ Multi-product formulas (MPF) reduce the Trotter error of Hamiltonian dynamics th The Optimization Mapper addon contains functionality to model optimization problems by formulating them in abstract models and then converting into representations that a quantum computer can understand. -- Visit the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. +- Read the [documentation](https://qiskit.github.io/qiskit-addon-opt-mapper/) for how-to guides and API references. +- Visit the [GitHub](https://github.com/qiskit/qiskit-addon-opt-mapper) repository. ## Addons for optimizing @@ -65,6 +66,7 @@ Sample-based quantum diagonalization (SQD) classically post-processes noisy quan This addon is an HPC-ready implementation of the SQD addon. It is written in modern C++17 standards and is designed to create a single compiled binary for use with MPI. - Visit the [API reference](https://qiskit.github.io/qiskit-addon-sqd-hpc/) documentation. +- View the [GitHub](https://github.com/qiskit/qiskit-addon-sqd-hpc) repository. ## Addons for error mitigation