Struct q1tsim::gates::Composite

pub struct Composite { /* fields omitted */ }

Composite gate.

Struct Composite provides for user-defined gates that are made out of a sequence of more primitive gates.

Methods

impl Composite

pub fn new(name: &str, nr_bits: usize) -> Self

Create a new composite gate.

Initialize a new composite gate with name name for operating on nr_bits qubits at a time. The gates making up the operation should be added using the add_gate() function.

pub fn parse_sum_expression(expr: &str) -> ParseResult<(f64, &str)>

Parse a sum expression

Parse an argument to a gate, in the form of a sum or difference of one or more expressions. On success, the parsed number is returned, together with the remainder of the string to be parsed. On failure, a ParseError is returned.

pub fn from_string(name: &str, desc: &str) -> ParseResult<Self>

Create a new composite gate from a description string.

Create a new composite gate with name name, based on the description in desc. The format of the description is as follows:

• One or more subgate descriptions, separated by semicolons.
• A subgate description consists of the name of the gate; optionally followed by comma-separated parameter list in parentheses; followed by one or more bit numbers on which the sub gate operates, separated by white space."Failed to parse argument "{}"", text
• Currently, only real numbers are allowed for parameters. Examples:

H 1; CX 0 1; H 1
RY(4.7124) 1; CX 1 0; RY(1.5708) 1; X1

pub fn add_gate<G: 'static>(&mut self, gate: G, bits: &[usize]) where
    G: CircuitGate, 

Add a gate.

Append a n-ary subgate gate, operating on the n qubits in bits, to this composite gate.

Trait Implementations

impl Gate for Composite

fn cost(&self) -> f64

Cost of this gate.

fn description(&self) -> &str

Return a short description of the gate. This may be the name of the gate (e.g. "H", "CX"), or the way the gate was constructed (like "I⊗Z")

fn nr_affected_bits(&self) -> usize

The number of qubits affected by this gate.

fn matrix(&self) -> CMatrix

Return a matrix describing the unitary transformation that the gate provides

fn apply_slice(&self, state: CVecSliceMut)

Apply a gate.

fn apply_mat_slice(&self, state: CMatSliceMut)

Apply a gate.

fn apply(&self, state: &mut CVector)

Apply a gate.

fn apply_mat(&self, state: &mut CMatrix)

Apply a gate.

fn check_nr_bits(&self, bits: &[usize]) -> Result<()>

Check the number of bits

impl CQasm for Composite

fn c_qasm(&self, bit_names: &[String], bits: &[usize]) -> Result<String>

cQasm representation

fn conditional_c_qasm(
    &self,
    condition: &str,
    bit_names: &[String],
    bits: &[usize]
) -> Result<String>

cQasm representation of conditional gate.

impl Latex for Composite

fn latex(&self, bits: &[usize], state: &mut LatexExportState) -> Result<()>

Add this gate to the export state.

impl OpenQasm for Composite

fn open_qasm(&self, bit_names: &[String], bits: &[usize]) -> Result<String>

OpenQasm representation

fn conditional_open_qasm(
    &self,
    condition: &str,
    bit_names: &[String],
    bits: &[usize]
) -> Result<String>

OpenQasm representation of conditional gate.