- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
146 lines
6.0 KiB
Markdown
Executable File
146 lines
6.0 KiB
Markdown
Executable File
---
|
|
markup: occlusion
|
|
title: ext/quantum/simulate
|
|
description: >-
|
|
Quantum simulation skill — amplitudes, probabilities, noisy shots.
|
|
import:
|
|
cap: ext/quantum/_capability/index.mq.md
|
|
---
|
|
|
|
Simulation — choose the observable before choosing the execution path.
|
|
|
|
What are the amplitudes? Use simulate (noise: no); returns list of maps with re, im.
|
|
|
|
Need a state for tensor/fidelity work? Use state (noise: no); returns quantum_state with qubits, dim, amplitudes.
|
|
|
|
What are the exact basis weights? Use probabilities (noise: no); returns basis label → probability.
|
|
|
|
What would repeated readout produce? Use run (noise: yes); returns qubits, shots, seed, counts, measure; noise when set.
|
|
|
|
Attach one teaching noise channel Use noise (noise: later in run); returns new circuit.
|
|
|
|
Noise is bitflip, depolarizing or amplitude_damping, with probability in [0,1].
|
|
It acts after each unitary on that operation's participating wires. Attaching
|
|
noise replaces the previous channel; it does not append a gate or change the
|
|
ideal state. This is a teaching trajectory model, not a hardware backend.
|
|
Measurement marks select sampled wires without collapsing ideal amplitudes.
|
|
|
|
A complete noise experiment
|
|
|
|
First create a circuit through the [circuit module](../circuit/index.mq.md).
|
|
The ideal state after X is one. Full bit-flip noise after X makes every sampled
|
|
outcome zero; exact probabilities still describe one. Repeating run with the
|
|
same circuit, seed and shots is deterministic for this simulator version.
|
|
|
|
```sh
|
|
marqdo call ext/quantum/circuit/index.mq.md new qubits=1 --effects plugin --session handbook --toget qc --json
|
|
marqdo call ext/quantum/circuit/index.mq.md x 'circuit=$qc' --effects plugin --session handbook --toget qc --json
|
|
marqdo call ext/quantum/simulate/index.mq.md noise 'circuit=$qc' 'kind="bitflip"' p=1 --effects plugin --session handbook --toget noisy --json
|
|
marqdo call ext/quantum/simulate/index.mq.md probabilities 'circuit=$noisy' --effects plugin --session handbook --json
|
|
marqdo call ext/quantum/simulate/index.mq.md run 'circuit=$noisy' shots=32 seed=7 --effects plugin --session handbook --json
|
|
```
|
|
|
|
Development route
|
|
|
|
Put new readouts here rather than duplicating circuit construction. Numerical
|
|
evolution and seeded sampling live in plugins/quantum/src/sim.rs; exports live
|
|
in src/lib.rs beside it. Preserve ideal/noisy separation in both language trees
|
|
and validate tests/ext/quantum-noise-smoke.mq.md plus amplitude-damping golds.
|
|
For entanglement go to [state](../state/index.mq.md); for mixed states use
|
|
[density](../density/index.mq.md), which currently describes ideal evolution.
|
|
|
|
## simulate
|
|
|
|
| 参数 | 类型 | 默认 | 说明 |
|
|
|---|---|---|---|
|
|
| circuit | any | required | circuit to evolve |
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| result | any | amplitude list |
|
|
|
|
Use `circuit` as the inputs for this operation.
|
|
|
|
Return ideal state-vector amplitudes for `circuit` as re/im entries. Noise
|
|
channels attached to the circuit are ignored here.
|
|
|
|
We **[Load the native plugin required by this operation](cap.load())**.
|
|
Return *[Return ideal state-vector amplitudes for circuit as re/im entries. Noise channels attached to the circuit are ignored here.](quantum_simulate(circuit=`circuit`))*.
|
|
|
|
## state
|
|
|
|
| 参数 | 类型 | 默认 | 说明 |
|
|
|---|---|---|---|
|
|
| circuit | any | required | circuit to evolve |
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| result | any | ideal state |
|
|
|
|
Use `circuit` as the inputs for this operation.
|
|
|
|
Same ideal amplitudes as simulate for `circuit`, packaged as the plugin state
|
|
object. Prefer this when later fidelity or density tools expect a state handle.
|
|
|
|
We **[Load the native plugin required by this operation](cap.load())**.
|
|
Return *[Same ideal amplitudes as simulate for circuit, packaged as the plugin state object. Prefer this when later fidelity or density tools expect a state handle.](quantum_state(circuit=`circuit`))*.
|
|
|
|
## probabilities
|
|
|
|
| 参数 | 类型 | 默认 | 说明 |
|
|
|---|---|---|---|
|
|
| circuit | any | required | circuit to read |
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| result | any | probability map |
|
|
|
|
Use `circuit` as the inputs for this operation.
|
|
|
|
Map basis label to probability for the ideal state of `circuit`. Labels use
|
|
qubit 0 as the rightmost bit. Noise is ignored.
|
|
|
|
We **[Load the native plugin required by this operation](cap.load())**.
|
|
Return *[Map basis label to probability for the ideal state of circuit. Labels use qubit 0 as the rightmost bit. Noise is ignored.](quantum_probabilities(circuit=`circuit`))*.
|
|
|
|
## run
|
|
|
|
| 参数 | 类型 | 默认 | 说明 |
|
|
|---|---|---|---|
|
|
| circuit | any | required | circuit to sample |
|
|
| shots | number | 1024 | sample count |
|
|
| seed | number | 1 | RNG seed |
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| result | any | counts or shot result |
|
|
|
|
Use `circuit`, `shots`=1024, `seed`=1 as the inputs for this operation.
|
|
|
|
Sample computational-basis outcomes from `circuit`. Defaults are `shots`=1024
|
|
and `seed`=1 so replays are deterministic. Teaching noise is applied when set.
|
|
|
|
We **[Load the native plugin required by this operation](cap.load())**.
|
|
Return *[Sample computational-basis outcomes from circuit. Defaults are shots=1024 and seed=1 so replays are deterministic. Teaching noise is applied when set.](quantum_run(circuit=`circuit`, shots=`shots`, seed=`seed`))*.
|
|
|
|
## noise
|
|
|
|
| 参数 | 类型 | 默认 | 说明 |
|
|
|---|---|---|---|
|
|
| kind | text | required | noise family name |
|
|
| p | number | required | strength in the unit interval |
|
|
| circuit | any | required | circuit to annotate |
|
|
|
|
| 返回 | 类型 | 说明 |
|
|
|------|------|------|
|
|
| result | any | circuit with noise metadata |
|
|
|
|
Use `kind`, `p`, `circuit` as the inputs for this operation.
|
|
|
|
Attach teaching noise of kind `kind` with strength `p` on `circuit`. Ideal
|
|
simulate and probability tools ignore it. Keep p small unless demonstrating
|
|
decoherence. Supported kinds include bitflip, depolarizing, and amplitude_damping.
|
|
|
|
We **[Load the native plugin required by this operation](cap.load())**.
|
|
Return *[Attach teaching noise of kind kind with strength p on circuit](quantum_noise(circuit=`circuit`, kind=`kind`, p=`p`))*.
|