Noise simulation: Pauli channels, amplitude damping and readout error

Open
#8 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
python, rust
Domain
backend

Research direction

Start with the per-shot dynamic branch in src/circuit.rs and the measurement and renormalisation pattern in src/backend.rs; trace how apply_gate_kernel and probability_of_one are used. Implementing this spans gate execution, noise sampling, and fast-path behavior. Done means run supports the listed noise channels and the state inspection methods reject gate noise as specified.

Written by the indexing model from the issue text.

Description

enhancement
What you want to do
Summary

Every result today comes from an ideal, noiseless device. Studying error mitigation, error correction or how an algorithm holds up on real hardware needs gate noise and readout error. Right now users have to switch to another simulator for that.

Implementation notes
  • Use quantum trajectories (Monte Carlo wavefunction). The path that simulates each shot separately
    (QuantumCircuit::run, dynamic branch in src/circuit.rs) already does what this needs: one state
    per shot, a random generator, and measure_qubit / reset_qubit.
  • Pauli channels: after a gate, draw a random Pauli with the channel's probabilities and apply it with
    apply_gate_kernel. Single-qubit gate fusion has to stop at every noise point, or fuse only
    between noise points.
  • Amplitude damping is not a mixture of unitaries. Its Kraus branch probabilities depend on the state,
    p(jump) = γ · P(qubit = 1), and probability_of_one already computes that. Then apply the
    non-unitary 2×2 matrix and renormalise, the same pattern as measure_qubit in src/backend.rs.
  • Readout error only flips classical bits after sampling, so circuits that only measure at the end
    keep the fast path when readout is their only noise.
  • statevector(), probabilities() and expectation() should raise when given gate noise,
    since the state is a mixture. A density-matrix backend could be a later issue.
What it could look like
noise = qsengine.NoiseModel(
    depolarizing=1e-3,        # after every single-qubit gate
    depolarizing_2q=1e-2,     # after every controlled gate, on each qubit it touches
    amplitude_damping=5e-4,   # T1-style decay after every gate
    readout=0.02,             # chance each measured bit is flipped
)
counts = qc.run(shots=4000, seed=1, noise=noise)
Contributing
  • I would like to open a pull request for this (see CONTRIBUTING.md).
Dominant language
Rust
Stars
1
Forks
0
Avg merge
12m
Merged PRs (30d)
4

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from kaiwave/qsengine

All issues in kaiwave/qsengine

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.