6.4 KiB
markup, title, description, import
| markup | title | description | import | ||||||
|---|---|---|---|---|---|---|---|---|---|
| occlusion | ext/quantum/quantum | Official quantum circuit simulator (English). Gates + circuits; ABI plugin. |
|
Official quantum circuit simulator (English). Gates + circuits; ABI plugin.
ensure_plugin
Load the ABI v2 quantum plugin once.
p = > plugin.native_path name="quantum"
p
plugin.load path=
p
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=
ab=b
schmidt
+ `state`
+ `cut`=1
Schmidt decomposition of a pure state / circuit across cut (subsystem A = low qubits).
ensure_plugin > quantum_schmidt state=
statecut=cut
fidelity
+ `a`
+ `b`
Pure-state fidelity |⟨a|b⟩|².
ensure_plugin > quantum_fidelity a=
ab=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=
qubitssteps=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=
nametheta=thetamatrix=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
matrix> quantum_density_from_matrix matrix=matrix-
> 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