32 KiB
markup, title, description, import
| markup | title | description | import | ||||
|---|---|---|---|---|---|---|---|
| occlusion | ext/quantum/circuit | Quantum circuit skill — wires, step tables, and applying gates. |
|
Circuit building — start here when you need a reusable quantum program.
A circuit begins in the all-zero state. Gates return a new circuit value; save that return value to continue. Qubit zero is the rightmost basis bit. Gate angles use radians. Width is 1–12 by default; MARQDO_QUANTUM_MAX_QUBITS can raise or lower the limit, with a hard maximum of 16. State-vector memory grows as 2^n.
Read → execute → observe
This complete shell recipe creates a Bell pair and observes it through the simulation module. The two nonzero probabilities should each be 0.5 within floating-point tolerance. Single quotes preserve the session reference for Marqdo instead of letting the shell expand it.
marqdo call ext/quantum/circuit/index.mq.md new qubits=2 --effects plugin --session handbook --toget qc --json
marqdo call ext/quantum/circuit/index.mq.md hadamard 'circuit=$qc' qubit=0 --effects plugin --session handbook --toget qc --json
marqdo call ext/quantum/circuit/index.mq.md cnot 'circuit=$qc' control=0 target=1 --effects plugin --session handbook --toget qc --json
marqdo call ext/quantum/simulate/index.mq.md probabilities 'circuit=$qc' --effects plugin --session handbook --json
Which operation belongs here?
Wires or a declarative steps table: use new; then simulate for results.
Superposition or basis/phase gates: use hadamard, x, y, z, s, t, i; then simulate.probabilities.
Continuous control: use rx, ry, rz; then theta is in radians.
Entangle or route: use cnot, cz, swap; then state.schmidt.
Compose fragments or custom gates: use append, apply; then gate.custom or gate.named supplies a gate.
Mark teaching layers or readout: use barrier, measure_mark; then viz.draw_circuit or simulate.run.
The author object circuit below offers the same operations as methods. Its simulation, density and drawing methods remain conveniences; their full call contracts live in the corresponding modules. Do not pass an object method to call without an explicit receiver; use the free tools above the object.
Development route
A new circuit recipe belongs in the root index, composed from these tools. Add a native gate only when composition and gate.custom cannot express it: update plugins/quantum/src/sim.rs and src/lib.rs, then add the free tool and author method here and in the Chinese mirror. Validate both backends and the existing tests/ext/quantum-steps-smoke.mq.md author example.
new
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubits | number | 1 | wire count |
| steps | any | None | optional gate table or None |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | new circuit handle |
Use qubits=1, steps=None as the inputs for this operation.
Create a state-vector circuit of width qubits=1 by default. Optional
steps=None means no preloaded gates; when a table is provided it is parsed
like the author API.
We Load the native plugin required by this operation.
Return [Create a state-vector circuit of width qubits=1 by default. Optional like the author API.](quantum_circuit_new(qubits=qubits, steps=steps)).
hadamard
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | target wire |
| circuit | any | required | existing circuit |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply Hadamard on wire qubit=0 of an existing circuit by default. Prefer
this when an agent already holds a circuit from new or toget.
We Load the native plugin required by this operation.
Return [Apply Hadamard on wire qubit=0 of an existing circuit by default. Prefer this when an agent already holds a circuit from new or toget.](quantum_h(circuit=circuit, qubit=qubit)).
cnot
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | existing circuit |
| control | number | 0 | control wire |
| target | number | 1 | target wire |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | updated circuit |
Use circuit, control=0, target=1 as the inputs for this operation.
Controlled-NOT on circuit from control=0 to target=1 by default. Together
with hadamard this prepares a Bell pair on two wires.
We Load the native plugin required by this operation.
Return [Controlled-NOT on circuit from control=0 to target=1 by default. Together with hadamard this prepares a Bell pair on two wires.](quantum_cx(circuit=circuit, control=control, target=target)).
barrier
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | existing circuit |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | circuit with barrier recorded |
Use circuit as the inputs for this operation.
Insert a visual barrier on circuit. The state does not change; drawings show a
separator so lectures can mark logical layers.
We Load the native plugin required by this operation. Return Insert a visual barrier on circuit. The state does not change; drawings show a separator so lectures can mark logical layers..
measure_mark
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | existing circuit |
| qubits | any | None | wire list or None for all |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | circuit with measure markers |
Use circuit, qubits=None as the inputs for this operation.
Mark computational-basis readout on circuit for later simulate.run. This does
not collapse the ideal state used by probabilities. Pass qubits=None to mark
every wire.
We Load the native plugin required by this operation.
Return [Mark computational-basis readout on circuit for later simulate](quantum_measure(circuit=circuit, qubits=qubits)).
x
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply Pauli X (bit flip) on the chosen wire. Useful for preparing |1⟩ from |0⟩ or sandwiching phase gates. Returns the updated circuit handle for further chaining.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply Pauli X (bit flip) on the chosen wire](quantum_x(circuit=circuit, qubit=qubit)).
y
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply Pauli Y on the chosen wire. Combines bit and phase flip; returns the updated circuit handle for further chaining in author programs.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply Pauli Y on the chosen wire](quantum_y(circuit=circuit, qubit=qubit)).
z
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply Pauli Z (phase flip) on the chosen wire. Often used in H–Z–H sandwiches that realize an effective X. Returns the updated circuit handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply Pauli Z (phase flip) on the chosen wire](quantum_z(circuit=circuit, qubit=qubit)).
s
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply the phase gate S (√Z) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply the phase gate S (√Z) on the chosen wire](quantum_s(circuit=circuit, qubit=qubit)).
t
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply the phase gate T (π/8) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply the phase gate T (π/8) on the chosen wire](quantum_t(circuit=circuit, qubit=qubit)).
i
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, circuit as the inputs for this operation.
Apply the identity on the chosen wire. Acts as a no-op spacer in step tables or noise experiments while keeping the wire explicit. Returns the updated handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply the identity on the chosen wire](quantum_i(circuit=circuit, qubit=qubit)).
rx
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, theta, circuit as the inputs for this operation.
Rotate the chosen wire about the X axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Rotate the chosen wire about the X axis by angle theta in radians](quantum_rx(circuit=circuit, qubit=qubit, theta=theta)).
ry
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, theta, circuit as the inputs for this operation.
Rotate the chosen wire about the Y axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Rotate the chosen wire about the Y axis by angle theta in radians](quantum_ry(circuit=circuit, qubit=qubit, theta=theta)).
rz
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use qubit=0, theta, circuit as the inputs for this operation.
Rotate the chosen wire about the Z axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Rotate the chosen wire about the Z axis by angle theta in radians](quantum_rz(circuit=circuit, qubit=qubit, theta=theta)).
cz
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| control | number | 0 | Default 0 |
| target | number | 1 | Default 1 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use control=0, target=1, circuit as the inputs for this operation.
Apply controlled-Z between control and target. Creates phase entanglement without flipping bits. Returns the updated circuit handle for chaining.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply controlled-Z between control and target](quantum_cz(circuit=circuit, control=control, target=target)).
swap
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | number | 0 | Default 0 |
| b | number | 1 | Default 1 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use a=0, b=1, circuit as the inputs for this operation.
Exchange the two wires named by a and b. Useful when routing logical qubits in a teaching layout. Returns the updated circuit handle.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Exchange the two wires named by a and b](quantum_swap(circuit=circuit, a=a, b=b)).
append
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| op | any | required | Required |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use op, circuit as the inputs for this operation.
Append another circuit’s operation list, or a gate/qubits record table, onto this circuit. Returns the combined circuit handle so programs can compose fragments.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Append this item to the new list](quantum_append(circuit=circuit, op=op)).
apply
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| gate | any | required | Required |
| qubits | any | 0 | Default 0 (input) |
| circuit | any | required | Existing circuit; returns a new value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Updated circuit |
Use gate, qubits=0, circuit as the inputs for this operation.
Apply a gate handle (built-in name or custom unitary matrix) onto qubits given as an int or a list. Returns the updated circuit handle for further chaining.
Input circuit is preserved; save the returned value with --toget qc in the same session to continue.
We Load the native plugin required by this operation.
Return [Apply a gate handle (built-in name or custom unitary matrix) onto qubits given as an int or a list](quantum_apply(circuit=circuit, gate=gate, qubits=qubits)).
circuit
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubits | number | 1 | Default 1 |
| steps | any | None | Default None |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubits=1, steps=None as the inputs for this operation.
State-vector circuit on n wires (default all-zero ket). Optional steps= preloads a gate table. Methods append gates and return a fresh handle for chaining. Agents should prefer the ## call tools above; authors use this object for readable method chains in programs.
We Load the native plugin required by this operation.
Return [State-vector circuit on n wires (default all-zero ket)](quantum_circuit_new(qubits=qubits, steps=steps)).
h
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply the Hadamard gate on the chosen wire. This creates equal superposition from computational basis states and is the first step of Bell and GHZ recipes. Returns an updated circuit handle so authors can chain without in-place mutation.
Return [Apply the Hadamard gate on the chosen wire](quantum_h(circuit=self, qubit=qubit)).
x
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply Pauli X (bit flip) on the chosen wire. Useful for preparing |1⟩ from |0⟩ or sandwiching phase gates. Returns the updated circuit handle for further chaining.
Return [Apply Pauli X (bit flip) on the chosen wire](quantum_x(circuit=self, qubit=qubit)).
y
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply Pauli Y on the chosen wire. Combines bit and phase flip; returns the updated circuit handle for further chaining in author programs.
Return [Apply Pauli Y on the chosen wire. Combines bit and phase flip; returns the updated circuit handle for further chaining in author programs.](quantum_y(circuit=self, qubit=qubit)).
z
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply Pauli Z (phase flip) on the chosen wire. Often used in H–Z–H sandwiches that realize an effective X. Returns the updated circuit handle.
Return [Apply Pauli Z (phase flip) on the chosen wire. Often used in H–Z–H sandwiches that realize an effective X. Returns the updated circuit handle.](quantum_z(circuit=self, qubit=qubit)).
s
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply the phase gate S (√Z) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.
Return [Apply the phase gate S (√Z) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.](quantum_s(circuit=self, qubit=qubit)).
t
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply the phase gate T (π/8) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.
Return [Apply the phase gate T (π/8) on the chosen wire. Returns the updated circuit handle for further chaining in lecture circuits.](quantum_t(circuit=self, qubit=qubit)).
i
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0 as the inputs for this operation.
Apply the identity on the chosen wire. Acts as a no-op spacer in step tables or noise experiments while keeping the wire explicit. Returns the updated handle.
Return [Apply the identity on the chosen wire. Acts as a no-op spacer in step tables or noise experiments while keeping the wire explicit. Returns the updated handle.](quantum_i(circuit=self, qubit=qubit)).
rx
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0, theta as the inputs for this operation.
Rotate the chosen wire about the X axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Return [Rotate the chosen wire about the X axis by angle theta in radians](quantum_rx(circuit=self, qubit=qubit, theta=theta)).
ry
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0, theta as the inputs for this operation.
Rotate the chosen wire about the Y axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Return [Rotate the chosen wire about the Y axis by angle theta in radians](quantum_ry(circuit=self, qubit=qubit, theta=theta)).
rz
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubit | number | 0 | Default 0 |
| theta | number | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubit=0, theta as the inputs for this operation.
Rotate the chosen wire about the Z axis by angle theta in radians. Continuous single-qubit control for variational and teaching demos. Returns the updated circuit handle.
Return [Rotate the chosen wire about the Z axis by angle theta in radians](quantum_rz(circuit=self, qubit=qubit, theta=theta)).
cx
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| control | number | 0 | Default 0 |
| target | number | 1 | Default 1 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use control=0, target=1 as the inputs for this operation.
Apply CNOT from control to target. This is the standard entangling step in Bell and GHZ preparations. Returns the updated circuit handle for chaining.
Return [Apply CNOT from control to target. This is the standard entangling step in Bell and GHZ preparations. Returns the updated circuit handle for chaining.](quantum_cx(circuit=self, control=control, target=target)).
cz
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| control | number | 0 | Default 0 |
| target | number | 1 | Default 1 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use control=0, target=1 as the inputs for this operation.
Apply controlled-Z between control and target. Creates phase entanglement without flipping bits. Returns the updated circuit handle for chaining.
Return [Apply controlled-Z between control and target. Creates phase entanglement without flipping bits. Returns the updated circuit handle for chaining.](quantum_cz(circuit=self, control=control, target=target)).
swap
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| a | number | 0 | Default 0 |
| b | number | 1 | Default 1 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use a=0, b=1 as the inputs for this operation.
Exchange the two wires named by a and b. Useful when routing logical qubits in a teaching layout. Returns the updated circuit handle.
Return [Exchange the two wires named by a and b. Useful when routing logical qubits in a teaching layout. Returns the updated circuit handle.](quantum_swap(circuit=self, a=a, b=b)).
barrier
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Record a visual barrier only. The ideal state vector is unchanged; use barriers to separate lecture stages when drawing circuit rails.
measure
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| qubits | any | None | Default None |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use qubits=None as the inputs for this operation.
Mark computational-basis readout wires for later run sampling. This does not collapse the ideal state used by probabilities. Pass qubits=None to mark every wire.
Return [Mark computational-basis readout wires for later run sampling](quantum_measure(circuit=self, qubits=qubits)).
append
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| op | any | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use op as the inputs for this operation.
Append another circuit’s operation list, or a gate/qubits record table, onto this circuit. Returns the combined circuit handle so programs can compose fragments.
Return [Append this item to the new list](quantum_append(circuit=self, op=op)).
apply
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| gate | any | required | Required |
| qubits | any | 0 | Default 0 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use gate, qubits=0 as the inputs for this operation.
Apply a gate handle (built-in name or custom unitary matrix) onto qubits given as an int or a list. Returns the updated circuit handle for further chaining.
Return [Apply a gate handle (built-in name or custom unitary matrix) onto qubits given as an int or a list. Returns the updated circuit handle for further chaining.](quantum_apply(circuit=self, gate=gate, qubits=qubits)).
noise
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| kind | any | required | Required |
| p | any | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | New circuit value; keep it to continue |
Use kind, p as the inputs for this operation.
Attach teaching noise of the given kind and strength for run trajectories. Ideal simulate and probabilities paths ignore this channel by design.
Return [Attach teaching noise of the given kind and strength for run trajectories. Ideal simulate and probabilities paths ignore this channel by design.](quantum_noise(circuit=self, kind=kind, p=p)).
simulate
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | List of re/im amplitudes |
Return ideal state-vector amplitudes as re/im pairs for the current circuit. Teaching noise attached to the circuit is ignored on this ideal path.
state
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | quantum_state: qubits, dim, amplitudes |
Return the ideal state object with the same amplitudes as simulate. Prefer this when later fidelity or density tools expect a state handle rather than raw amplitudes.
Return Return the ideal state object with the same amplitudes as simulate.
probabilities
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Basis label to ideal probability |
Map basis labels to ideal probabilities. Labels treat qubit 0 as the rightmost bit. Teaching noise is ignored so results match the pure statevector story.
run
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| shots | number | 1024 | Default 1024 |
| seed | number | 1 | Default 1 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Shot metadata and counts |
Use shots=1024, seed=1 as the inputs for this operation.
Sample computational-basis shots from this circuit. Defaults are shots=1024 and seed=1 for reproducible replays. Applies teaching noise when a noise channel was attached.
Return [Sample computational-basis shots from this circuit](quantum_run(circuit=self, shots=shots, seed=seed)).
draw
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| path | any | None | Default None |
| kind | any | "circuit" | Default circuit |
| qubit | number | 0 | Default 0 |
| theme | any | "dark" | Default dark |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | quantum_svg with kind and svg |
Use path=None, kind="circuit", qubit=0, theme="dark" as the inputs for this operation.
Render an SVG figure for circuit rails, probability bars, Bloch spheres, or advanced density kinds. Theme tokens are dark, light, and bw. Optional path writes the file for CLI or view embedding.
Return [Render an SVG figure for circuit rails, probability bars, Bloch spheres, or advanced density kinds](quantum_draw_circuit(circuit=self, path=path, kind=kind, qubit=qubit, theme=theme)).
density
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Density operator handle |
Build the pure-state density matrix ρ=|ψ⟩⟨ψ| after ideal simulation of this circuit. Use density-module tools for mixed states and partial traces.
expect
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| obs | any | required | Required |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | number | Scalar observation |
Use obs as the inputs for this operation.
Compute the expectation value of a Pauli string (left end = high bit) or an explicit matrix on this circuit’s ideal density. Teaching noise is ignored.
Return [Compute the expectation value of a Pauli string (left end = high bit) or an explicit matrix on this circuit’s ideal density. Teaching noise is ignored.](quantum_density_expect(density=self, obs=obs)).
schmidt
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| cut | number | 1 | Default 1 |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Coefficients, subsystem bases and entropy |
Use cut=1 as the inputs for this operation.
Perform a bipartite Schmidt decomposition of the ideal state. The cut argument is the number of qubits in subsystem A counted from the low bits.
Return [Perform a bipartite Schmidt decomposition of the ideal state. The cut argument is the number of qubits in subsystem A counted from the low bits.](quantum_schmidt(state=self, cut=cut)).