1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
use super::*;
use crate::cycle::CycleList;
use crate::operation::OperationSet;
use qudit_core::Radices;
use rustc_hash::FxHashMap;
/// Constructors
impl QuditCircuit {
/// Creates a new QuditCircuit object.
///
/// # Arguments
///
/// * `qudit_radices` - The radices that describes the qudit system.
///
/// * `dit_radices` - The radices that describes the classical system.
///
/// # Examples
///
/// We can define hybrid quantum-classical circuits:
/// ```
/// use qudit_circuit::QuditCircuit;
///
/// let two_qubit_circuit = QuditCircuit::new([2, 2], [2, 2]);
/// let two_qutrit_circuit = QuditCircuit::new([3, 3], [3, 3]);
/// ```
pub fn new<T1: Into<Radices>, T2: Into<Radices>>(
qudit_radices: T1,
dit_radices: T2,
) -> QuditCircuit {
QuditCircuit::with_capacity(qudit_radices, dit_radices, 4)
}
/// Creates a new purely-quantum QuditCircuit object.
///
/// # Arguments
///
/// * `qudit_radices` - The radices that describes the qudit system.
///
/// # Examples
///
/// We can define purely quantum kernels without classical bits:
/// ```
/// # use qudit_circuit::QuditCircuit;
/// let two_qubit_circuit = QuditCircuit::pure([2, 2]);
/// let two_qutrit_circuit = QuditCircuit::pure([3, 3]);
/// let hybrid_circuit = QuditCircuit::pure([2, 2, 3, 3]);
/// ```
pub fn pure<T: Into<Radices>>(qudit_radices: T) -> QuditCircuit {
QuditCircuit::with_capacity(qudit_radices, Radices::from(&[] as &[usize]), 1)
}
/// Creates a new QuditCircuit object with a given cycle capacity.
///
/// # Arguments
///
/// * `qudit_radices` - The radices that describes the qudit system.
///
/// * `dit_radices` - The radices that describes the classical system.
///
/// * `capacity` - The number of cycles to pre-allocate.
///
/// # Examples
///
/// ```
/// # use qudit_circuit::QuditCircuit;
/// let two_qubit_circuit = QuditCircuit::with_capacity([2, 2], [2, 2], 10);
/// ```
pub fn with_capacity<T1: Into<Radices>, T2: Into<Radices>>(
qudit_radices: T1,
dit_radices: T2,
capacity: usize,
) -> QuditCircuit {
let qudit_radices = qudit_radices.into();
let dit_radices = dit_radices.into();
QuditCircuit {
qudit_radices,
dit_radices,
cycles: CycleList::with_capacity(capacity),
front: FxHashMap::default(),
rear: FxHashMap::default(),
operations: OperationSet::new(),
params: ParameterVector::default(),
}
}
}