--- markup: occlusion title: ext/quantum/quantum description: Official quantum circuit simulator (English). Gates + circuits; ABI plugin. import: plugin: lib/plugin.mq.md sys: lib/sys.mq.md json: lib/json.mq.md --- Official quantum circuit simulator (English). Gates + circuits; ABI plugin. ## 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 Hadamard on qubit (default 0). *> quantum_h circuit=`self` qubit=`qubit`* ## x + `qubit`=0 Pauli X on qubit. *> quantum_x circuit=`self` qubit=`qubit`* ## y + `qubit`=0 Pauli Y on qubit. *> quantum_y circuit=`self` qubit=`qubit`* ## z + `qubit`=0 Pauli Z on qubit. *> quantum_z circuit=`self` qubit=`qubit`* ## s + `qubit`=0 Phase S on qubit. *> quantum_s circuit=`self` qubit=`qubit`* ## t + `qubit`=0 Phase T on qubit. *> quantum_t circuit=`self` qubit=`qubit`* ## i + `qubit`=0 Identity on qubit. *> quantum_i circuit=`self` qubit=`qubit`* ## rx + `qubit`=0 + `theta` Rotate about X by theta. *> quantum_rx circuit=`self` qubit=`qubit` theta=`theta`* ## ry + `qubit`=0 + `theta` Rotate about Y by theta. *> quantum_ry circuit=`self` qubit=`qubit` theta=`theta`* ## rz + `qubit`=0 + `theta` Rotate about Z by theta. *> quantum_rz circuit=`self` qubit=`qubit` theta=`theta`* ## cx + `control`=0 + `target`=1 CNOT: control → target. *> quantum_cx circuit=`self` control=`control` target=`target`* ## cz + `control`=0 + `target`=1 Controlled-Z. *> quantum_cz circuit=`self` control=`control` target=`target`* ## swap + `a`=0 + `b`=1 Swap two qubits. *> 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 Explicit matrix of this object. *> quantum_gate_matrix gate=`self`* ## matches_matrix + `matrix` + `tol`=0.000000001 Whether this gate matches matrix (tol). *> 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 Explicit matrix of this object. *> 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` Expectation value of 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`*