Merge branch 'unitaryfoundation:main' into fix/executor-pep563-annotations

Author: ayush268

.github/workflows/build.yml

@@ -25,7 +25,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7
@@ -51,7 +51,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7
@@ -82,7 +82,7 @@ jobs:
         MPLBACKEND: Agg
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           # Fetch full history so Codecov can resolve commit ancestry reliably.
           fetch-depth: 0

.github/workflows/docs-build.yml

@@ -22,7 +22,7 @@ jobs:
       actions: write
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7

.github/workflows/gh-release.yml

@@ -13,7 +13,7 @@ jobs:
       contents: write
     steps:
       - name: Check out Mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Extract release notes of latest version
         run: |
           awk '/^## Version /{if(found) exit; found=1} found{print}' CHANGELOG.md > release_notes.md

.github/workflows/publish-pypi.yml

@@ -22,7 +22,7 @@ jobs:
 
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           ref: ${{ github.ref }}
       - name: Install uv

.github/workflows/publish-testpypi.yml

@@ -24,7 +24,7 @@ jobs:
       id-token: write
     steps:
       - name: Check out mitiq
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Install uv
         uses: astral-sh/setup-uv@v7

README.md

@@ -107,6 +107,7 @@ If you are using an experimental technique and would like to help it graduate, p
 | Probabilistic Error Amplification  | [PEA](https://mitiq.readthedocs.io/en/stable/guide/pea.html) |  [`mitiq.experimental.pea`](https://github.com/unitaryfoundation/mitiq/tree/main/mitiq/experimental/pea) | [Nature](https://www.nature.com/articles/s41586-023-06096-3) |
 | Virtual Distillation  | [VD](https://mitiq.readthedocs.io/en/stable/guide/vd.html) |  [`mitiq.experimental.vd`](https://github.com/unitaryfoundation/mitiq/tree/main/mitiq/experimental/vd) | [APS](https://journals.aps.org/prx/abstract/10.1103/PhysRevX.11.041036) |
 | Twirled Readout Error eXtinction | [TREX](https://mitiq.readthedocs.io/en/latest/guide/trex.html) | [`mitiq.experimental.trex`](https://github.com/unitaryfoundation/mitiq/tree/main/mitiq/experimental/trex) | [2012.09738](https://arxiv.org/abs/2012.09738) |
+| Debiasing | [DEB](https://mitiq.readthedocs.io/en/stable/guide/deb.html) | [`mitiq.experimental.deb`](https://github.com/unitaryfoundation/mitiq/tree/main/mitiq/experimental/deb) | [2301.07233](https://arxiv.org/abs/2301.07233) |
 
 
 In addition, we also have Pauli Twirling which is a noise tailoring technique:

docs/source/_thumbnails/cdr-clifft.png

@@ -236,6 +236,29 @@ guarantees. Access them via `mitiq.experimental`.
    :members:
 ```
 
+### Debiasing
+
+#### Debiasing (High-Level Tools)
+
+```{eval-rst}
+.. automodule:: mitiq.experimental.deb.deb
+   :members:
+```
+
+#### Circuit Symmetrization
+
+```{eval-rst}
+.. automodule:: mitiq.experimental.deb.symmetrization
+   :members:
+```
+
+#### Sharpening
+
+```{eval-rst}
+.. automodule:: mitiq.experimental.deb.sharpening
+   :members:
+```
+
 ### Probabilistic Error Amplification
 
 #### Probabilistic Error Amplification (High-Level Tools)

docs/source/apidoc.md

@@ -454,6 +454,7 @@ def get_incollection_template(self, e):
     "examples/zne_logical_rb_cirq_stim": "_static/mitiq_stim_logo.png",
     "examples/quantum_simulation_1d_ising": "_static/quantum_simulation.png",
     "examples/cdr_qrack": "_static/cdr-qrack.png",
+    "examples/cdr_demo": "_static/cdr-clifft.png",
     "examples/loschmidt_echo_revival_zne": "_static/loschmidt_echo_qiskit.png",
     "examples/pt_zne": "_static/pt_zne.png",
     "examples/advanced_error_mitigation_pipeline": (