Files
marqdo/ext/quantum/simulate/index.mq.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- 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。
2026-11-18 10:29:26 +08:00

6.0 KiB
Executable File

markup, title, description, import
markup title description import
occlusion ext/quantum/simulate Quantum simulation skill — amplitudes, probabilities, noisy shots.
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. 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.

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; for mixed states use density, 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. Return Return ideal state-vector amplitudes for circuit as re/im entries. Noise channels attached to the circuit are ignored here..

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. 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..

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. Return Map basis label to probability for the ideal state of circuit. Labels use qubit 0 as the rightmost bit. Noise is ignored..

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. 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. Return [Attach teaching noise of kind kind with strength p on circuit](quantum_noise(circuit=circuit, kind=kind, p=p)).