Struct DynamicCircuitBuilder 

pub struct DynamicCircuitBuilder { /* private fields */ }

Builder for dynamic circuits with mid-circuit measurement

Implementations

impl DynamicCircuitBuilder

pub fn new(num_qubits: usize) -> Self

Create a new dynamic circuit builder

pub fn with_bits(self, num_bits: usize) -> Self

Create with specified number of classical bits

pub fn h(&mut self, qubit: usize) -> DeviceResult<&mut Self>

Add a Hadamard gate

pub fn x(&mut self, qubit: usize) -> DeviceResult<&mut Self>

Add a Pauli-X gate

pub fn y(&mut self, qubit: usize) -> DeviceResult<&mut Self>

Add a Pauli-Y gate

pub fn z(&mut self, qubit: usize) -> DeviceResult<&mut Self>

Add a Pauli-Z gate

pub fn cx(&mut self, control: usize, target: usize) -> DeviceResult<&mut Self>

Add a CNOT gate

pub fn rx(&mut self, qubit: usize, angle: f64) -> DeviceResult<&mut Self>

Add a rotation around X axis

pub fn ry(&mut self, qubit: usize, angle: f64) -> DeviceResult<&mut Self>

Add a rotation around Y axis

pub fn rz(&mut self, qubit: usize, angle: f64) -> DeviceResult<&mut Self>

Add a rotation around Z axis

pub fn measure(&mut self, qubit: usize, bit: usize) -> DeviceResult<&mut Self>

Add a measurement (mid-circuit or final)

pub fn measure_all(&mut self) -> DeviceResult<&mut Self>

Add measurements for all qubits

pub fn reset(&mut self, qubit: usize) -> DeviceResult<&mut Self>

Add a reset operation

pub fn barrier(&mut self, qubits: &[usize]) -> DeviceResult<&mut Self>

Add a barrier

pub fn if_then<F>( &mut self, condition: &str, body: F, ) -> DeviceResult<&mut Self>

where F: FnOnce(&mut DynamicCircuitBuilder) -> DeviceResult<()>,

Add a conditional operation based on classical bit value

Example

builder.if_then("c[0] == 1", |b| {
    b.x(1);
    Ok(())
})?;

pub fn if_then_else<F, G>( &mut self, condition: &str, then_body: F, else_body: G, ) -> DeviceResult<&mut Self>

where F: FnOnce(&mut DynamicCircuitBuilder) -> DeviceResult<()>, G: FnOnce(&mut DynamicCircuitBuilder) -> DeviceResult<()>,

Add a conditional operation with else branch

pub fn switch<F>( &mut self, expression: &str, case_builder: F, ) -> DeviceResult<&mut Self>

where F: FnOnce(&mut DynamicSwitchBuilder) -> DeviceResult<()>,

Add a switch-case statement

Example

builder.switch("c", |sw| {
    sw.case(&[0], |b| { b.x(0)?; Ok(()) })?;
    sw.case(&[1], |b| { b.y(0)?; Ok(()) })?;
    sw.default(|b| { b.z(0)?; Ok(()) })?;
    Ok(())
})?;

pub fn assign(&mut self, target: &str, value: &str) -> &mut Self

Add a classical assignment

pub fn comment(&mut self, text: &str) -> &mut Self

Add a comment

pub fn num_mid_circuit_measurements(&self) -> usize

Get number of mid-circuit measurements

pub fn build(self) -> DeviceResult<Qasm3Circuit>

Build the dynamic circuit