Struct MCGate 

pub struct MCGate { /* private fields */ }

A multi-controlled quantum gate.

MCGate represents a StandardGate with additional control qubits. The gate applies the base operation only when all control qubits are in the |1⟩ state.

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

// Create a Toffoli-like gate (CCX) using 2 controls and X gate
let ccx = MCGate::new(2, StandardGate::X);
assert_eq!(ccx.num_ctrl_qubits(), 2);
assert_eq!(ccx.num_qubits(), 3); // 2 controls + 1 target

// Create a multi-controlled Z gate
let mcz = MCGate::new(3, StandardGate::Z);
assert_eq!(mcz.num_ctrl_qubits(), 3);
assert_eq!(mcz.num_qubits(), 4);

Implementations

impl MCGate

pub fn new(num_controls: u8, gate: StandardGate) -> Self

Creates a new multi-controlled gate.

Arguments

• num_controls - The number of control qubits to add.
• gate - The base StandardGate to control.

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

// 3-controlled Hadamard
let mc_h = MCGate::new(3, StandardGate::H);

// Controlled-RX (1 control added to RX)
let crx = MCGate::new(1, StandardGate::RX);

pub fn matrix( &self, params: &[f64], ) -> Result<Cow<'_, Array2<Complex<f64>>>, CircuitError>

Returns the unitary matrix representation of the multi-controlled gate.

The matrix is constructed by applying the control structure to the base gate’s matrix. For large numbers of controls, this results in a sparse block-diagonal matrix.

Arguments

• params - Parameters for the base gate (if parametric).

Returns

A Cow containing the matrix, borrowed if no controls are present.

pub fn inverse( &self, params: &[Parameter], ) -> Option<(MCGate, SmallVec<[Parameter; 3]>)>

Computes the inverse of the multi-controlled gate.

The inverse of a controlled gate C(U) is C(U†).

Arguments

• params - Parameters for the base gate.

Returns

Some((MCGate, parameters)) if the base gate is invertible, None otherwise.

pub fn num_ctrl_qubits(&self) -> usize

Returns the total number of control qubits.

This includes both the explicitly added controls and any inherent controls in the base gate (e.g., CX has 1 inherent control).

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

// Adding 2 controls to X gate
let gate = MCGate::new(2, StandardGate::X);
assert_eq!(gate.num_ctrl_qubits(), 2);

// Adding 1 control to CX (which already has 1 control)
let gate = MCGate::new(1, StandardGate::CX);
assert_eq!(gate.num_ctrl_qubits(), 2); // 1 added + 1 inherent

pub fn num_qubits(&self) -> usize

Returns the total number of qubits (controls + targets).

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

// CCX: 2 controls + 1 target = 3 qubits
let ccx = MCGate::new(2, StandardGate::X);
assert_eq!(ccx.num_qubits(), 3);

pub fn num_params(&self) -> usize

Returns the number of parameters required by the base gate.

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

// Controlled-RX requires 1 parameter
let crx = MCGate::new(1, StandardGate::RX);
assert_eq!(crx.num_params(), 1);

// Multi-controlled H requires no parameters
let much = MCGate::new(2, StandardGate::H);
assert_eq!(much.num_params(), 0);

pub fn base_gate(&self) -> &StandardGate

Returns a reference to the base gate.

Examples

use cqlib_core::circuit::gate::{MCGate, StandardGate};

let gate = MCGate::new(2, StandardGate::Z);
assert_eq!(*gate.base_gate(), StandardGate::Z);

pub fn name(&self) -> String

Returns the stable operation name used by circuit APIs and statistics.

Trait Implementations

impl Clone for MCGate

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MCGate

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

Formats the value using the given formatter.

impl Display for MCGate

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

Formats the value using the given formatter.

impl Eq for MCGate

impl Hash for MCGate

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 Ord for MCGate

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for MCGate

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for MCGate

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for MCGate