Skip to content

Separate addons into sections #4965

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
kaelynj merged 10 commits into from
Apr 17, 2026
Merged

Separate addons into sections #4965

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
ab646da
Separate addons into sections
kaelynj Apr 9, 2026
1c36be8
Merge branch 'main' of github.com:Qiskit/documentation into kjf/categ…
kaelynj Apr 10, 2026
31239c0
Apply suggestions from code review
kaelynj Apr 13, 2026
5b8ce2c
Implement review suggestions
kaelynj Apr 15, 2026
45a3527
Update docs/guides/addons.mdx
kaelynj Apr 16, 2026
704c175
Apply suggestions from code review
kaelynj Apr 16, 2026
71a44a9
Rework card descriptions
kaelynj Apr 16, 2026
4409426
Apply suggestions from code review
kaelynj Apr 16, 2026
c438cc5
Update card description
kaelynj Apr 16, 2026
2eb93fe
Apply suggestions from code review
kaelynj Apr 17, 2026
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
90 changes: 65 additions & 25 deletions docs/guides/addons.mdx
View file
Open in desktop
Copy link
Copy Markdown
Collaborator

@abbycross abbycross Apr 10, 2026

Choose a reason for hiding this comment

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

The first h2 starts with "Addons for" and the rest of the h2s don't follow that pattern. Style guide has us avoid gerunds in headers, so I would recommend a structure like this:

  • Addons to map domain problems
  • Addons to optimize circuits for hardware execution
  • Addons to manage noise for expectation value estimation
  • Addons to manage noise for sampling results
  • Supplemental addons

Alternative: just remove the "Addons to" altogether, if it feels too repetitive... and go with:

  • Map domain problems
  • Optimize circuits for hardware execution
  • Manage noise for expectation value estimation
    etc.

Copy link
Copy Markdown
Collaborator

@jenglick jenglick Apr 10, 2026

Choose a reason for hiding this comment

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

I like the alternative option (removing addons from those headers)

Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,28 @@ description: Understand the Qiskit addon tools, which help you build utility-gra

# Advanced techniques - Qiskit addons

Qiskit addons are a collection of research capabilities for enabling algorithm discovery at the utility scale. These modular software components can plug into a [workflow](/docs/guides/intro-to-patterns) to scale or design new quantum algorithms. Many of these addons are powered by the `qiskit-addon-utils` package. See the [Qiskit addon utilities documentation](https://qiskit.github.io/qiskit-addon-utils/) for more information.
Qiskit addons are a collection of research capabilities for enabling algorithm discovery at the utility scale. These modular software components build upon Qiskit’s performant foundation and can plug into a [workflow](/docs/guides/intro-to-patterns) to scale or design new quantum algorithms.
Comment thread
kaelynj marked this conversation as resolved.
Outdated


## Map domain problems
These capabilities specialize in mapping domain problems into quantum operators and circuits for execution on a quantum computer.
<CardGroup>
<Card
title="Optimization Mapper"
Comment thread
kaelynj marked this conversation as resolved.
Outdated
description="Model optimization problems and map them down into representations that can be understood by a quantum computer."
href="https://qiskit.github.io/qiskit-addon-opt-mapper/"
analyticsName="Documentation page: Optimization mapper"
linkText="Browse documentation"
/>

<Card
title="Fermionic mapper"
description="Model fermionic quantum systems and map their representation to qubit operators and circuits."
href="https://qiskit.github.io/qiskit-fermions/"
analyticsName="Documentation page: Fermionic mapper"
linkText="Browse documentation"
/>

<Card
title="AQC-Tensor"
description="Approximate quantum compilation with tensor networks (AQC-Tensor) enables the construction of high-fidelity circuits with reduced depth."
Expand All @@ -26,15 +45,12 @@ Qiskit addons are a collection of research capabilities for enabling algorithm d
linkText="Browse documentation"
/>

<Card
title="Optimization Mapper"
description="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."
href="https://qiskit.github.io/qiskit-addon-opt-mapper/"
analyticsName="Documentation page: Optimization mapper"
linkText="Browse documentation"
/>
</CardGroup>


## Optimize circuits for hardware execution
These capabilities are useful for reducing circuit depth and typically come with an increased sampling overhead.
<CardGroup>
<Card
title="Operator backpropagation"
description="Operator backpropagation (OBP) reduces circuit depth by trimming operations from the end at the cost of more operator measurements."
Expand All @@ -50,31 +66,33 @@ Qiskit addons are a collection of research capabilities for enabling algorithm d
analyticsName="Documentation page: Circuit cutting"
linkText="Browse documentation"
/>
</CardGroup>

## Manage noise for expectation value estimation
Use the following addons to manage noise when building quantum workloads that estimate expectation values of observables.

<Card
title="Matrix-free Measurement Mitigation"
description="Matrix-free Measurement Mitigation (M3) is a package for scalable quantum measurement error mitigation that can be computed in parallel."
href="https://qiskit.github.io/qiskit-addon-mthree/"
analyticsName="Documentation page: M3"
<CardGroup>
<Card
title="Propagated noise absorption"
description="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."
href="https://qiskit.github.io/qiskit-addon-pna/"
analyticsName="Documentation page: PNA"
linkText="Browse documentation"
/>

<Card
title="Shaded lightcones"
description="The shaded lightcones (SLC) addon uses Pauli propagation to reduce the number of error terms in a noise model that need to be mitigated. This has the effect of reducing the sampling overhead for probabilistic error cancellation (PEC) workflows."
href="https://qiskit.github.io/qiskit-addon-slc/"
analyticsName="Documentation page: SLC"
linkText="Browse documentation"
/>
<Card
title="Propagated noise absorption"
description="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."
href="https://qiskit.github.io/qiskit-addon-pna/"
analyticsName="Documentation page: PNA"
linkText="Browse documentation"
/>

</CardGroup>

## Manage noise for sampling results
Manage noise when sampling results with the following addons.
Comment thread
kaelynj marked this conversation as resolved.
Outdated

<CardGroup>

<Card
title="Sample-based quantum diagonalization"
Expand All @@ -93,10 +111,32 @@ Qiskit addons are a collection of research capabilities for enabling algorithm d
/>

<Card
title="Dice eigensolver"
description="This addon utilizes a more performant eigensolver to scale SQD chemistry workflows past 30 orbitals an HPC-ready implementation of the SQD addon."
href="https://qiskit.github.io/qiskit-addon-dice-solver/"
analyticsName="Documentation page: Dice"
title="Measurement post-selection"
Comment thread
kaelynj marked this conversation as resolved.
Outdated
description="Incorporate measurement post selection transpiler passes to filter out non-Markovian noise in your circuits with the utilities addon."
href="https://qiskit.github.io/qiskit-addon-utils/apidocs/qiskit_addon_utils.noise_management.post_selection.transpiler.passes.html"
analyticsName="Documentation page for post-selection"
linkText="Read API reference"
Comment thread
kaelynj marked this conversation as resolved.
Outdated
/>

<Card
title="Matrix-free Measurement Mitigation"
Comment thread
kaelynj marked this conversation as resolved.
Outdated
description="Matrix-free Measurement Mitigation (M3) is a package for scalable quantum measurement error mitigation that can be computed in parallel."
href="https://qiskit.github.io/qiskit-addon-mthree/"
analyticsName="Documentation page: M3"
linkText="Browse documentation"
/>


</CardGroup>

## Supplemental addons
Comment thread
kaelynj marked this conversation as resolved.
Outdated
This set of functions can be used to support and compose your workflows that leverage other addons.
Comment thread
kaelynj marked this conversation as resolved.
Outdated
<CardGroup>
<Card
title="Addon utilities"
description="This package, which supplements workflows involving one or more Qiskit addons, contains functions to create Hamiltonians, generate Trotter time evolution circuits, and slice and combine quantum circuits in time-wise partitions."
href="https://qiskit.github.io/qiskit-addon-utils/"
analyticsName="Documentation page: addon utilities"
linkText="Browse documentation"
/>
</CardGroup>
Expand Down
1 change: 1 addition & 0 deletions scripts/config/cspell/dictionaries/qiskit.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -237,6 +237,7 @@ litellm
lnot
lqiskit
mapomatic
Markovian
mathbb
mathbf
mathcal
Expand Down
Loading