Fix label/wire overlap with gutter + chip labels; default dark tech palette with light/bw themes; restyle probs/bloch and darken view plot frames. Co-authored-by: Cursor <cursoragent@cursor.com>
295 lines
6.0 KiB
Markdown
295 lines
6.0 KiB
Markdown
---
|
||
title: ext/quantum/quantum
|
||
description: Official quantum circuit simulator (English). Gates + circuits; ABI plugin.
|
||
import plugin:lib/plugin.mq.md
|
||
import sys:lib/sys.mq.md
|
||
import json:lib/json.mq.md
|
||
---
|
||
|
||
## ensure_plugin
|
||
|
||
Load the ABI v2 `quantum` plugin once.
|
||
|
||
*p = > plugin.native_path name="quantum"*
|
||
1. `p`
|
||
> plugin.load path=`p`
|
||
2. *
|
||
> print text=ext/quantum: native quantum plugin not found (build marqdo_plugin_quantum or marqdo ext add quantum)
|
||
> sys.exit code=1
|
||
****
|
||
|
||
## kron
|
||
+ `a`
|
||
+ `b`
|
||
|
||
Tensor product of two states or square matrices.
|
||
|
||
> ensure_plugin
|
||
**> quantum_kron a=`a` b=`b`**
|
||
|
||
## schmidt
|
||
+ `state`
|
||
+ `cut`=1
|
||
|
||
Schmidt decomposition of a pure state / circuit across `cut` (subsystem A = low qubits).
|
||
|
||
> ensure_plugin
|
||
**> quantum_schmidt state=`state` cut=`cut`**
|
||
|
||
## fidelity
|
||
+ `a`
|
||
+ `b`
|
||
|
||
Pure-state fidelity |⟨a|b⟩|².
|
||
|
||
> ensure_plugin
|
||
**> quantum_fidelity a=`a` b=`b`**
|
||
|
||
# circuit
|
||
+ `qubits`=1
|
||
+ `steps`=None
|
||
|
||
State-vector circuit (default |0…0⟩). Optional `steps=` gate table (column or row records). Methods append gates and return an updated handle.
|
||
|
||
> ensure_plugin
|
||
**> quantum_circuit_new qubits=`qubits` steps=`steps`**
|
||
|
||
## h
|
||
+ `qubit`=0
|
||
|
||
**> quantum_h circuit=`self` qubit=`qubit`**
|
||
|
||
## x
|
||
+ `qubit`=0
|
||
|
||
**> quantum_x circuit=`self` qubit=`qubit`**
|
||
|
||
## y
|
||
+ `qubit`=0
|
||
|
||
**> quantum_y circuit=`self` qubit=`qubit`**
|
||
|
||
## z
|
||
+ `qubit`=0
|
||
|
||
**> quantum_z circuit=`self` qubit=`qubit`**
|
||
|
||
## s
|
||
+ `qubit`=0
|
||
|
||
**> quantum_s circuit=`self` qubit=`qubit`**
|
||
|
||
## t
|
||
+ `qubit`=0
|
||
|
||
**> quantum_t circuit=`self` qubit=`qubit`**
|
||
|
||
## i
|
||
+ `qubit`=0
|
||
|
||
**> quantum_i circuit=`self` qubit=`qubit`**
|
||
|
||
## rx
|
||
+ `qubit`=0
|
||
+ `theta`
|
||
|
||
**> quantum_rx circuit=`self` qubit=`qubit` theta=`theta`**
|
||
|
||
## ry
|
||
+ `qubit`=0
|
||
+ `theta`
|
||
|
||
**> quantum_ry circuit=`self` qubit=`qubit` theta=`theta`**
|
||
|
||
## rz
|
||
+ `qubit`=0
|
||
+ `theta`
|
||
|
||
**> quantum_rz circuit=`self` qubit=`qubit` theta=`theta`**
|
||
|
||
## cx
|
||
+ `control`=0
|
||
+ `target`=1
|
||
|
||
**> quantum_cx circuit=`self` control=`control` target=`target`**
|
||
|
||
## cz
|
||
+ `control`=0
|
||
+ `target`=1
|
||
|
||
**> quantum_cz circuit=`self` control=`control` target=`target`**
|
||
|
||
## swap
|
||
+ `a`=0
|
||
+ `b`=1
|
||
|
||
**> quantum_swap circuit=`self` a=`a` b=`b`**
|
||
|
||
## barrier
|
||
|
||
Visual separator only (no state change).
|
||
|
||
**> quantum_barrier circuit=`self`**
|
||
|
||
## measure
|
||
+ `qubits`=None
|
||
|
||
Mark computational-basis readout (`None` / empty = all qubits). Affects which bits `run` reports.
|
||
|
||
**> quantum_measure circuit=`self` qubits=`qubits`**
|
||
|
||
## append
|
||
+ `op`
|
||
|
||
Append another circuit's ops or a `{gate,qubits}` op map.
|
||
|
||
**> quantum_append circuit=`self` op=`op`**
|
||
|
||
## apply
|
||
+ `gate`
|
||
+ `qubits`=0
|
||
|
||
Apply a gate handle (named or custom `matrix=`) on `qubits` (int or list).
|
||
|
||
**> quantum_apply circuit=`self` gate=`gate` qubits=`qubits`**
|
||
|
||
## noise
|
||
+ `kind`
|
||
+ `p`
|
||
|
||
Teaching noise for `run` trajectories (`bitflip` / `depolarizing` / `amplitude_damping`). Ignored by `simulate` / `probabilities`.
|
||
|
||
**> quantum_noise circuit=`self` kind=`kind` p=`p`**
|
||
|
||
## simulate
|
||
|
||
Return state vector amplitudes `{re,im}` (ideal; no noise).
|
||
|
||
**> quantum_simulate circuit=`self`**
|
||
|
||
## state
|
||
|
||
Ideal state vector (same amplitudes as `simulate`).
|
||
|
||
**> quantum_state circuit=`self`**
|
||
|
||
## probabilities
|
||
|
||
Return map of basis label → probability (qubit 0 = rightmost bit). Ideal; ignores noise.
|
||
|
||
**> quantum_probabilities circuit=`self`**
|
||
|
||
## run
|
||
+ `shots`=1024
|
||
+ `seed`=1
|
||
|
||
Sample computational-basis shots (deterministic with `seed=`). Applies circuit `noise` if set.
|
||
|
||
**> quantum_run circuit=`self` shots=`shots` seed=`seed`**
|
||
|
||
## draw
|
||
+ `path`=None
|
||
+ `kind`=circuit
|
||
+ `qubit`=0
|
||
+ `theme`=dark
|
||
|
||
Circuit rail / probability bars / Bloch / advanced state plots (`kind=circuit|probs|bloch|hinton|city|density|paulivec|qsphere|multibloch`). Theme `dark` (default tech lab) / `light` / `bw`. Records into view/CLI plots via host `record_plot`.
|
||
|
||
**> quantum_draw_circuit circuit=`self` path=`path` kind=`kind` qubit=`qubit` theme=`theme`**
|
||
|
||
## density
|
||
|
||
Pure-state density matrix ρ=|ψ⟩⟨ψ| after ideal simulate.
|
||
|
||
**> density state=`self`**
|
||
|
||
## expect
|
||
+ `obs`
|
||
|
||
Pauli string (left = high bit) or matrix expectation on the ideal state.
|
||
|
||
**> quantum_density_expect density=`self` obs=`obs`**
|
||
|
||
## schmidt
|
||
+ `cut`=1
|
||
|
||
Schmidt / singular values across a bipartition (`cut` = qubits in subsystem A, low bits).
|
||
|
||
**> quantum_schmidt state=`self` cut=`cut`**
|
||
|
||
# gate
|
||
+ `name`=None
|
||
+ `theta`=None
|
||
+ `matrix`=None
|
||
|
||
Named built-in gate (`name=H`) or custom unitary from `matrix=` (nested list or formula matrix fence). Optional `name=` label for custom gates (default `U`).
|
||
|
||
> ensure_plugin
|
||
**> quantum_gate_new name=`name` theta=`theta` matrix=`matrix`**
|
||
|
||
## matrix
|
||
|
||
**> quantum_gate_matrix gate=`self`**
|
||
|
||
## matches_matrix
|
||
+ `matrix`
|
||
+ `tol`=0.000000001
|
||
|
||
**> quantum_gate_matches_matrix gate=`self` matrix=`matrix` tol=`tol`**
|
||
|
||
## draw
|
||
+ `path`=None
|
||
+ `kind`=gate
|
||
|
||
Gate glyph or complex-matrix heatmap (`kind=gate|matrix`). Records via host `record_plot`.
|
||
|
||
**> quantum_gate_draw gate=`self` path=`path` kind=`kind`**
|
||
|
||
# density
|
||
+ `state`=None
|
||
+ `matrix`=None
|
||
|
||
Density matrix from a state/circuit (`state=`) or an explicit Hermitian `matrix=` (≤6 qubits).
|
||
|
||
> ensure_plugin
|
||
1. `matrix`
|
||
**> quantum_density_from_matrix matrix=`matrix`**
|
||
2. *
|
||
**> quantum_density_from_state state=`state`**
|
||
|
||
## matrix
|
||
|
||
**> quantum_density_matrix density=`self`**
|
||
|
||
## purity
|
||
|
||
Tr(ρ²).
|
||
|
||
**> quantum_density_purity density=`self`**
|
||
|
||
## partial_trace
|
||
+ `keep`
|
||
|
||
Keep listed qubits (LSB=0); trace out the rest.
|
||
|
||
**> quantum_density_partial_trace density=`self` keep=`keep`**
|
||
|
||
## eig
|
||
|
||
Hermitian spectrum → `{eigenvalues, eigenvectors}`.
|
||
|
||
**> quantum_density_eig density=`self`**
|
||
|
||
## expect
|
||
+ `obs`
|
||
|
||
**> quantum_density_expect density=`self` obs=`obs`**
|
||
|
||
## draw
|
||
+ `path`=None
|
||
+ `kind`=hinton
|
||
|
||
Hinton / city / density-cells / Pauli vector SVG (`kind=hinton` or city or density or paulivec).
|
||
|
||
**> quantum_density_draw density=`self` path=`path` kind=`kind`**
|