Mitiq

All Changes

- Fix broken links on the website (erkska, gh-400).
- Use cirq v0.9.0 instead of cirq-unstable (karalekas, gh-402).
- Update mitiq.about() (rmlarose, gh-399).
- Refresh the release process documentation (karalekas, gh-392).
- Redesign factories, batch runs in BatchedFactory, fix Qiskit utils tests (rmlarose, andreamari, gh-381).
- Add note on batched executors to docs (rmlarose, gh-405).
- Added Tensorflow Quantum executor to docs (k-m-schultz, gh-348).
- Fix a collection of small build & docs issues (karalekas, gh-410).
- Add optimal QPR decomposition for depolarizing noise (karalekas, gh-371).
- Add PEC basic implementation assuming a decomposition dictionary is given (andreamari, gh-373).
- Make tensorflow requirements optional for docs (karalekas, gh-417).

Thanks to erkska and k-m-schultz for their contributions to this release!

│ Scale method: fold_global │ Improvement factor: 0.3333 │ Improvement factor: 0.9709 │
├────────────────────────────────────┼────────────────────────────┼────────────────────────────┤
│ Technique: ZNE │ ✘ │ ✔ │
│ Factory: Richardson │ Noisy error: 0.03 │ Noisy error: 1.0 │

│ Scale method: fold_global │ Improvement factor: 0.72 │ Improvement factor: 1.0025 │
└────────────────────────────────────┴────────────────────────────┴────────────────────────────┘


**New benchmarking circuits:** `mitiq.benchmarks` now contains a function `generate_random_clifford_t_circuit` which does what it says on the tin.
Special shoutout to new UF team member Farrokh Labib (farlab) for this contribution.

py
from mitiq.benchmarks import generate_random_clifford_t_circuit

clifft = generate_random_clifford_t_circuit(
num_qubits=2,
num_oneq_cliffords=5,
num_twoq_cliffords=5,
num_t_gates=5
)
print(clifft)
0: ──────────────S───T──────H───T───X───T───T─────────────
│ │ │ │ │
1: ───S───T──────────────X──────────────S──────────X───S───


The `Executor.run` method now supports a single circuit instance in addition to a list for ease of use when working with a single circuit.

diff
- executor.run([circuit])
+ executor.run(circuit)


**Faster Tests!** Working on Mitiq has never been easier to develop with a faster (by 36%) test suite.

📓 Documentation

This release contains quite a few documentation improvements, including

1. New workflow images to elucidate the workflow for for using the `mitiq.shadows` module (available [here](https://mitiq.readthedocs.io/en/stable/guide/shadows.html))
2. A reorganized API-doc which should be easier to navigate
3. General clean up of the CDR user guide pages

Commits

- Clarify CDR training docs regarding the use of a markov chain monte carlo (2130) [natestemen]
- Update workflow images in documentation (2034) [purva-thakre]
- 2115 pauli twirling callibration of expectation estimation shadow needs continue (2116) [bdg221]
- Add randomized clifford+T benchmarking circuits. (2118) [farlab]
- Frontend/Backend docs clean up (2124) [natestemen]
- Speed up tests using mocks (2126) [natestemen]
- resolve flaky mirror QV circuit test (2127) [natestemen + misty-w]
- Simplify expectation_estimation_shadow code (2113) [bdg221]
- Refactor calibration logs (2074) [kozhukalov]
- Organize API-doc (2104) [purva-thakre]
- add support for single circuit on exeuctor run method (2099) [emilianog-byte]

📦 Dependency updates

- Update qiskit-ibm-provider requirement from ~=0.7.2 to ~=0.7.3 (2122) [dependabot]
- Update cirq requirement from <1.3.0,>=1.0.0 to >=1.0.0,<1.4.0 (2107) [dependabot]
- Update pennylane requirement from ~=0.32.0 to ~=0.33.1 (2091) [dependabot]
- Update pennylane-qiskit requirement from ~=0.32.0 to ~=0.33.0 (2081) [dependabot]
- Bump stim/stimcirq from 1.12.0 to 1.12.1 (2106) [dependabot]
- Update amazon-braket-sdk requirement from ~=1.59.2 to ~=1.64.1 (2089 + 2094 + 2114 + 2123) [dependabot]
- Update scipy requirement from <=1.11.3,>=1.5.0 to >=1.5.0,<=1.11.4 (2095) [dependabot]

🧑‍💻 Dev Dependency updates

- Bump myst-nb from 0.17.1 to 1.0.0 (2090) [dependabot]
- Bump pandas from 2.1.2 to 2.1.3 (2093) [dependabot]
- Bump matplotlib from 3.8.0 to 3.8.1 (2084) [dependabot]
- Bump isort from 5.12.0 to 5.13.2 (2120 + 2125) [dependabot]
- Bump actions/setup-python from 4 to 5 (2112) [dependabot]

│ Scale method: fold_global │ Improvement factor: 0.5333 │ Improvement factor: 1.0309 │
├────────────────────────────────────┼────────────────────────────┼────────────────────────────┤
│ Technique: ZNE │ ✘ │ ✔ │
│ Factory: Linear │ Noisy error: 0.03 │ Noisy error: 1.0 │

In this milestone, we've continued our work to support Qibo by providing a new tutorial, adding related Qibo-conversion functionality to the API-doc, and added Qibo to our main list of supported frontends.
We've also added the capability to use rotated randomized benchmarking circuits as part of the calibrator.
These circuits provide expectation values ranging from 0 to 1 when measuring the probability that the output state is in the ground state.
Having circuits with a wide range of expectation values is an important benchmarking task, and make a great test for finding the correct error mitigation technique/parameters.
If you find any bugs/inconveniences in working with these updates make sure to open an issue so we are able to fix it ASAP!

This release also contains contributions from two new Mitiq contributors, and Unitary Fund team members Alessandro and Jordan!
Welcome both, and looking forward to many more contributions!
Well done making your first contribution so quickly 🏎️💨!

Commits

- Exit early when circuit type is not supported (2252) [cosenal]
- adding rotated randomized benchmarking circuits to calibrator (2248) [farlab]
- add qibo + rearrange frontend order (2249) [purva-thakre]
- Fix examples link in README.md (2242) [jordandsullivan]
- add link to discussions as a way to contribute (2234) [natestemen]
- use python 3.11 for RTD (2231) [natestemen]
- fix pennylane tutorial (2232) [natestemen]
- Add qibo example to docs (2220) [francescsabater]
- replace `black`, `flake8`, and `isort` with `ruff` (2222) [natestemen]
- pin qibo version (2221) [natestemen]
- Add Qibo conversions to documentation (2214) [nathanshammah]
- Added warning filter to ignore warning (2211) [bdg221]
- remove redundant imports (2206) [natestemen]
- Indicate master is under development (2205) [natestemen]

📦 Dependency updates

- Update pennylane-qiskit requirement from ~=0.34.0 to ~=0.34.1 (2198) [dependabot]
- Update qiskit-ibm-provider requirement from ~=0.8.0 to ~=0.10.0 (2196) [dependabot]
- Update pennylane requirement from ~=0.34.0 to ~=0.35.1 (2227) [dependabot]
- Update pennylane-qiskit requirement from ~=0.34.1 to ~=0.35.1 (2225) [dependabot]
- Bump stimcirq from 1.12.1 to 1.13.0 (2236) [dependabot]
- Bump stim from 1.12.1 to 1.13.0 (2237) [dependabot]

🧑‍💻 Dev Dependency updates

- Bump all documentation dependencies (2179) [dependabot]
- Bump pytest-cov from 4.0.0 to 5.0.0 (2240) [dependabot]