Struct quil_rs::instruction::Gate

pub struct Gate {
    pub name: String,
    pub parameters: Vec<Expression>,
    pub qubits: Vec<Qubit>,
    pub modifiers: Vec<GateModifier>,
}

A struct encapsulating all the properties of a Quil Quantum Gate.

Fields

name: String

parameters: Vec<Expression>

qubits: Vec<Qubit>

modifiers: Vec<GateModifier>

Implementations

impl Gate

pub fn new( name: &str, parameters: Vec<Expression>, qubits: Vec<Qubit>, modifiers: Vec<GateModifier> ) -> Result<Self, GateError>

Build a new gate

Errors

Returns an error if the given name isn’t a valid Quil identifier or if no qubits are given.

pub fn dagger(self) -> Self

Apply a DAGGER modifier to the gate

pub fn controlled(self, control_qubit: Qubit) -> Self

Apply a CONTROLLED modifier to the gate

pub fn forked( self, fork_qubit: Qubit, alt_params: Vec<Expression> ) -> Result<Self, GateError>

Apply a FORKED modifier to the gate

Errors

Returns an error if the number of provided alternate parameters don’t equal the number of existing parameters.

pub fn to_unitary(&mut self, n_qubits: u64) -> Result<Matrix, GateError>

Lift a Gate to the full n_qubits-qubit Hilbert space.

Errors

Returns an error if any of the parameters of this gate are non-constant, if any of the qubits are variable, if the name of this gate is unknown, or if there are an unexpected number of parameters.

Trait Implementations

impl Clone for Gate

fn clone(&self) -> Gate

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Gate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Gate

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Gate

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Gate> for Gate

fn eq(&self, other: &Gate) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Gate

impl StructuralEq for Gate

impl StructuralPartialEq for Gate