"""MPQP is focused on gate-based quantum computing. As such, the main element of
a script using MPQP is the quantum circuit, or :class:`QCircuit`. The
:class:`QCircuit` contains the data for all gates, measurements, and noise models you
want to apply to your qubits.
The qubits are only referred to by their indices, so one could keep track of
specific registers using Python features, for instance
.. code-block:: python
>>> circ = QCircuit(6)
>>> targets = range(3)
>>> ancillas = range(3,6)
>>> for i in range(3):
... circ.add(CNOT(targets[i], ancillas[i]))
>>> print(circ) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■────────────
│
q_1: ──┼────■───────
│ │
q_2: ──┼────┼────■──
┌─┴─┐ │ │
q_3: ┤ X ├──┼────┼──
└───┘┌─┴─┐ │
q_4: ─────┤ X ├──┼──
└───┘┌─┴─┐
q_5: ──────────┤ X ├
└───┘
could be used to add CNOT gates to your circuit, using the two registers
``targets`` and ``ancillas``.
"""
from __future__ import annotations
from copy import deepcopy
from numbers import Complex
from typing import TYPE_CHECKING, Literal, Optional, Sequence, Type, Union, overload
from warnings import warn
import numpy as np
import numpy.typing as npt
from mpqp.core.instruction import Instruction
from mpqp.core.instruction.barrier import Barrier
from mpqp.core.instruction.breakpoint import Breakpoint
from mpqp.core.instruction.gates import ControlledGate, CRk, Gate, Id
from mpqp.core.instruction.gates.custom_controlled_gate import CustomControlledGate
from mpqp.core.instruction.gates.custom_gate import CustomGate
from mpqp.core.instruction.gates.parametrized_gate import ParametrizedGate
from mpqp.core.instruction.measurement import BasisMeasure, Measure
from mpqp.core.instruction.measurement.expectation_value import ExpectationMeasure
from mpqp.core.languages import Language
from mpqp.noise.noise_model import DimensionalNoiseModel, NoiseModel
from mpqp.tools import DeviceJobIncompatibleError
from mpqp.tools.errors import NonReversibleWarning, NumberQubitsError
from mpqp.tools.generics import OneOrMany
from mpqp.tools.maths import matrix_eq
from typeguard import TypeCheckError, typechecked
if TYPE_CHECKING:
from braket.circuits import Circuit as braket_Circuit
from cirq.circuits.circuit import Circuit as cirq_Circuit
from qat.core.wrappers.circuit import Circuit as myQLM_Circuit
from qiskit.circuit import QuantumCircuit
from sympy import Basic, Expr
from mpqp.execution.devices import (
ATOSDevice,
AWSDevice,
GOOGLEDevice,
IBMDevice,
AvailableDevice,
)
from mpqp.execution.simulated_devices import IBMSimulatedDevice
[docs]@typechecked
class QCircuit:
"""This class models a quantum circuit.
A circuit is composed of instructions and noise models applied to
quantum and/or classical bits. These elements (instructions and noise
models) will be called ``components`` hereafter.
Args:
data: Number of qubits or list of ``components`` to initialize the
circuit with. If the number of qubits is passed, it should be a
positive integer.
nb_qubits: Optional number of qubits, in case you input the sequence of
instructions and want to hardcode the number of qubits.
nb_cbits: Number of classical bits. It should be positive.
label: Name of the circuit.
Examples:
>>> circuit = QCircuit(2)
>>> circuit.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit : Size (Qubits, Cbits) = (2, 0), Nb instructions = 0
q_0:
q_1:
>>> circuit = QCircuit([Rx(1.23, 2)], nb_qubits=4, nb_cbits=2, label="Circuit 1")
>>> circuit.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit Circuit 1: Size (Qubits, Cbits) = (4, 2), Nb instructions = 1
q_0: ────────────
q_1: ────────────
┌──────────┐
q_2: ┤ Rx(1.23) ├
└──────────┘
q_3: ────────────
c: 2/════════════
>>> circuit = QCircuit(3, label="NoiseExample")
>>> circuit.add([H(0), T(1), CNOT(0,1), S(2)])
>>> circuit.add(BasisMeasure(shots=2345))
>>> circuit.add(Depolarizing(prob=0.50, targets=[0, 1]))
>>> circuit.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit NoiseExample: Size (Qubits, Cbits) = (3, 3), Nb instructions = 5
Depolarizing noise: on qubits [0, 1] with probability 0.5
┌───┐ ┌─┐
q_0: ┤ H ├──■──┤M├───
├───┤┌─┴─┐└╥┘┌─┐
q_1: ┤ T ├┤ X ├─╫─┤M├
├───┤└┬─┬┘ ║ └╥┘
q_2: ┤ S ├─┤M├──╫──╫─
└───┘ └╥┘ ║ ║
c: 3/═══════╩═══╩══╩═
2 0 1
"""
def __init__(
self,
data: Optional[int | Sequence[Instruction | NoiseModel]] = None,
*,
nb_qubits: Optional[int] = None,
nb_cbits: Optional[int] = None,
label: Optional[str] = None,
):
if data is None:
data = []
self.label = label
"""See parameter description."""
self.instructions: list[Instruction] = []
"""List of instructions of the circuit."""
self.noises: list[NoiseModel] = []
"""List of noise models attached to the circuit."""
self._user_nb_cbits: Optional[int] = None
self._nb_cbits: int
self._user_nb_qubits: Optional[int] = None
self._nb_qubits: int
self.transpiled_circuit: "Optional[Union[braket_Circuit, cirq_Circuit, myQLM_Circuit, QuantumCircuit]]" = (None)
"""A pre-transpiled circuit to skip repeated transpilation when running
the circuit. Useful when working with a symbolic circuit that needs to
be executed with different parameters."""
self.transpiled_noise_model = None
"""A pre-transpiled noise model that skips repeated transpilation when
running the circuit. Currently, it is only useful in Qiskit when working
with a symbolic circuit that needs to be executed with different
parameters."""
self.gphase: float = 0
"""Stores the global phase (angle) arising from the Qiskit conversion of
:class:`~mpqp.core.instruction.gates.custom_gate.CustomGates` to
OpenQASM2. It is used to correct the global phase when the job type is
`STATE_VECTOR`, and when this circuit contains
:class:`~mpqp.core.instruction.gates.custom_gate.CustomGates`."""
if nb_cbits is None:
self._nb_cbits = 0
else:
self._user_nb_cbits = nb_cbits
if isinstance(data, int):
if data < 0:
raise TypeCheckError(
f"The data passed to QCircuit is a negative int ({data}), "
"this does not make sense."
)
self._user_nb_qubits = data
else:
if nb_qubits is None:
if len(data) == 0:
self._nb_qubits = 0
else:
connections: set[int] = set.union(
*(instruction.connections() for instruction in data)
)
self._nb_qubits = max(connections, default=-1) + 1
else:
self._user_nb_qubits = nb_qubits
self.add(deepcopy(data))
def __eq__(self, value: object) -> bool:
return isinstance(value, type(self)) and self.to_dict() == value.to_dict()
[docs] def add(self, components: OneOrMany[Instruction | NoiseModel]):
"""Adds a ``component`` or a list of ``component`` at the end of the
circuit.
Args:
components : Instruction(s) or noise model(s) to append to the
circuit.
Examples:
>>> circuit = QCircuit(2)
>>> circuit.add(X(0))
>>> circuit.add([CNOT(0, 1), BasisMeasure(shots=100)])
>>> circuit.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit : Size (Qubits, Cbits) = (2, 2), Nb instructions = 3
┌───┐ ┌─┐
q_0: ┤ X ├──■──┤M├───
└───┘┌─┴─┐└╥┘┌─┐
q_1: ─────┤ X ├─╫─┤M├
└───┘ ║ └╥┘
c: 2/═══════════╩══╩═
0 1
>>> circuit.add(Depolarizing(0.3, dimension=2, gates=[CNOT]))
>>> circuit.add([Depolarizing(0.02, [0])])
>>> circuit.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit : Size (Qubits, Cbits) = (2, 2), Nb instructions = 3
Depolarizing noise: for gate CNOT with probability 0.3 and dimension 2
Depolarizing noise: on qubit 0 with probability 0.02
┌───┐ ┌─┐
q_0: ┤ X ├──■──┤M├───
└───┘┌─┴─┐└╥┘┌─┐
q_1: ─────┤ X ├─╫─┤M├
└───┘ ║ └╥┘
c: 2/═══════════╩══╩═
0 1
"""
if not isinstance(components, (Instruction, NoiseModel)):
for comp in components:
self.add(comp)
return
if self._user_nb_qubits is not None:
if any(conn >= self._user_nb_qubits for conn in components.connections()):
component_type = (
"Instruction"
if isinstance(components, Instruction)
else "Noise model"
)
raise NumberQubitsError(
f"{component_type} {type(components)}'s connections "
f"({components.connections()}) are not compatible with circuit"
f" size ({self.nb_qubits})."
)
else:
if components._dynamic is False: # pyright: ignore[reportPrivateUsage]
self._set_nb_qubits_dynamic(
max(self.nb_qubits, max(components.connections()) + 1)
)
if components._dynamic: # pyright: ignore[reportPrivateUsage]
components = self._update_targets_components(components)
self._check_components_targets(components)
if isinstance(components, BasisMeasure):
if components.c_targets is None:
components.c_targets = [
self.nb_cbits + i for i in range(len(components.targets))
]
self._update_cbits(
max(components.c_targets) + 1 if len(components.c_targets) != 0 else 0
)
if isinstance(components, NoiseModel):
self.noises.append(components)
else:
self.instructions.append(components)
def _check_components_targets(self, components: Instruction | NoiseModel):
if isinstance(components, BasisMeasure):
if self.noises and len(components.targets) != self.nb_qubits:
raise ValueError(
"In noisy circuits, BasisMeasure must span all qubits in the circuit."
)
if isinstance(components, NoiseModel):
if (
isinstance(components, DimensionalNoiseModel)
and 0 < len(components.targets) < components.dimension
):
raise ValueError(
f"Number of target qubits {len(components.targets)} should be higher than "
f"the dimension {components.dimension}."
)
hardcoded_basis_measures = [
instr for instr in self.instructions if isinstance(instr, BasisMeasure)
]
if any(
len(meas.targets) != self.nb_qubits for meas in hardcoded_basis_measures
):
raise ValueError(
"In noisy circuits, BasisMeasure must span all qubits in the circuit."
)
def _update_cbits(self, cbits: int):
if self._user_nb_cbits is not None:
if cbits > self._user_nb_cbits:
raise ValueError(
f"nb_cbits in the circuit is static ({self._user_nb_cbits}), but the nb_cbits of the components overflow ({cbits})."
)
else:
self._nb_cbits = max(self.nb_cbits, cbits)
def _update_targets_components(self, component: Instruction | NoiseModel):
"""Update the targets of the component with the number of qubits in the circuit.
Args:
component: Instruction or NoiseModel for which we want to update the `targets` attribute.
Raises:
ValueError: If the number of target qubits for a NoiseModel is
smaller than its dimension, or if BasisMeasure does not span
all qubits in a noisy circuit.
Examples:
>>> circuit = QCircuit(2)
>>> depolarization = Depolarizing(0.01)
>>> basis_measure = BasisMeasure()
>>> print(depolarization.targets)
[]
>>> print(circuit._update_targets_components(depolarization).targets)
[0, 1]
>>> print(basis_measure.targets)
[]
>>> print(circuit._update_targets_components(basis_measure).targets)
[0, 1]
>>> circuit.nb_qubits = 3
>>> print(circuit._update_targets_components(depolarization).targets)
[0, 1, 2]
>>> print(circuit._update_targets_components(basis_measure).targets)
[0, 1, 2]
"""
targets = list(range(self.nb_qubits))
component.targets = targets
self._check_components_targets(component)
if isinstance(component, Barrier):
component.size = self.nb_qubits
component.targets = list(range(self.nb_qubits))
elif isinstance(component, ExpectationMeasure):
component._check_targets_order() # pyright: ignore[reportPrivateUsage]
elif isinstance(component, DimensionalNoiseModel):
component.check_dimension()
elif isinstance(component, BasisMeasure):
from mpqp.core.instruction.measurement.basis import VariableSizeBasis
if not isinstance(component.basis, VariableSizeBasis):
raise ValueError(
"A `BasisMeasure` with a non variable sized basis cannot be"
" dynamic."
)
component.basis.set_size(self.nb_qubits)
unique_cbits = set()
for instruction in self.instructions:
if instruction != component and isinstance(instruction, BasisMeasure):
if instruction.c_targets:
unique_cbits.update(instruction.c_targets)
c_targets: list[int] = []
i = 0
for _ in range(len(component.targets)):
while i in unique_cbits:
warn(
"Dynamic measurements don't play well with static measurements: "
"order of classic bits might be unexpected"
)
i += 1
c_targets.append(i)
i += 1
component.c_targets = c_targets
self._update_cbits(
max(max(c_targets, default=0) + 1, max(unique_cbits, default=0) + 1)
)
return component
@property
def nb_qubits(self) -> int:
"""Number of qubits of the circuit."""
return self._nb_qubits if self._user_nb_qubits is None else self._user_nb_qubits
@property
def nb_cbits(self) -> int:
"""Number of cbits of the circuit."""
return self._nb_cbits if self._user_nb_cbits is None else self._user_nb_cbits
@nb_qubits.setter
def nb_qubits(self, nb_qubits: int):
if self._user_nb_qubits is None or self._user_nb_qubits != nb_qubits:
self._user_nb_qubits = nb_qubits
self._set_nb_qubits_dynamic(nb_qubits)
@nb_cbits.setter
def nb_cbits(self, nb_cbits: int):
if self._user_nb_cbits is None or self._user_nb_cbits != nb_cbits:
for measure in self.measurements:
if (
isinstance(measure, BasisMeasure)
and measure.c_targets is not None
and any(target >= nb_cbits for target in measure.c_targets)
):
raise ValueError(
f"Targets of the measure {repr(measure)} are not "
"compatible with the classical bits register size "
f"requested {nb_cbits}."
)
self._user_nb_cbits = nb_cbits
def _set_nb_qubits_dynamic(self, nb_qubits: int):
if not hasattr(self, "_nb_qubits") or nb_qubits != self._nb_qubits:
self._nb_qubits = nb_qubits
for noise in self.noises:
if noise._dynamic: # pyright: ignore[reportPrivateUsage]
self._update_targets_components(noise)
for instruction in self.instructions:
if instruction._dynamic: # pyright: ignore[reportPrivateUsage]
self._update_targets_components(instruction)
[docs] def append(self, other: QCircuit, qubits_offset: int = 0) -> None:
"""Appends the circuit at the end (right side) of this circuit, inplace.
If the size of the ``other`` is smaller than this circuit,
the parameter ``qubits_offset`` can be used to indicate at which qubit
the ``other`` circuit must be added.
This method can be shorthanded with the ``+=`` operator (while ``+``
performs the same operation without the *inplace* factor.)
Args:
other: The circuit to append at the end of this circuit.
qubits_offset: If the circuit in parameter is smaller, this
parameter determines at which qubit (vertically) the circuit will
be added.
Raises:
NumberQubitsError: If the circuit in parameter is larger than this
circuit or if the ``qubits_offset`` is too big, such that the
``other`` circuit would "stick out".
Examples:
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c2 = QCircuit([X(1),CNOT(1,2)])
>>> c1.append(c2)
>>> print(c1) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■─────────────────
┌─┴─┐ ┌───┐
q_1: ┤ X ├──■──┤ X ├──■──
└───┘┌─┴─┐└───┘┌─┴─┐
q_2: ─────┤ X ├─────┤ X ├
└───┘ └───┘
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c2 = QCircuit([X(1),CNOT(1,2)])
>>> c1 += c2
>>> print(c1) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■─────────────────
┌─┴─┐ ┌───┐
q_1: ┤ X ├──■──┤ X ├──■──
└───┘┌─┴─┐└───┘┌─┴─┐
q_2: ─────┤ X ├─────┤ X ├
└───┘ └───┘
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c2 = QCircuit([X(1),CNOT(1,2)])
>>> print(c1 + c2) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■─────────────────
┌─┴─┐ ┌───┐
q_1: ┤ X ├──■──┤ X ├──■──
└───┘┌─┴─┐└───┘┌─┴─┐
q_2: ─────┤ X ├─────┤ X ├
└───┘ └───┘
"""
if self._user_nb_qubits is not None and self.nb_qubits < other.nb_qubits:
raise NumberQubitsError(
"Size of the circuit to be appended is greater than the size of"
" this circuit"
)
if (
self._user_nb_qubits is not None
and qubits_offset + other.nb_qubits > self.nb_qubits
):
raise NumberQubitsError(
"Size of the circuit to be appended is too large given the"
" index and the size of this circuit"
)
for inst in deepcopy(other.instructions):
inst.targets = [qubit + qubits_offset for qubit in inst.targets]
if isinstance(inst, ControlledGate):
inst.controls = [qubit + qubits_offset for qubit in inst.controls]
if isinstance(inst, BasisMeasure):
if not inst._user_set_c_targets: # pyright: ignore[reportPrivateUsage]
inst.c_targets = None
self.add(inst)
[docs] def to_dict(self) -> dict[str, int | str | list[str] | float | None]:
"""
Serialize the quantum circuit to a dictionary.
Returns:
dict: A dictionary representation of the circuit.
"""
return {
attr_name: getattr(self, attr_name)
for attr_name in dir(self)
if attr_name not in {'_nb_qubits', 'gates', 'measurements', 'breakpoints'}
and not attr_name.startswith("__")
and not callable(getattr(self, attr_name))
}
def __iadd__(self, other: QCircuit):
self.append(other)
return self
def __add__(self, other: QCircuit) -> QCircuit:
res = deepcopy(self)
res += other
return res
[docs] def tensor(self, other: QCircuit) -> QCircuit:
"""Computes the tensor product of this circuit with that in parameter.
In the circuit notation, the upper part of the output circuit will
correspond to the first circuit, while the bottom part corresponds to that in parameter.
This method can be shorthanded with the ``@`` operator.
Args:
other: QCircuit being the second operand of the tensor product with
this circuit.
Returns:
The QCircuit resulting from the tensor product of this circuit with
that in parameter.
Args:
other: QCircuit being the second operand of the tensor product with
this circuit.
Returns:
The QCircuit resulting from the tensor product of this circuit with
that in parameter.
Examples:
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c2 = QCircuit([X(1),CNOT(1,2)])
>>> print(c1.tensor(c2)) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■───────
┌─┴─┐
q_1: ┤ X ├──■──
└───┘┌─┴─┐
q_2: ─────┤ X ├
└───┘
q_3: ──────────
┌───┐
q_4: ┤ X ├──■──
└───┘┌─┴─┐
q_5: ─────┤ X ├
└───┘
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c2 = QCircuit([X(1),CNOT(1,2)])
>>> print(c1 @ c2) # doctest: +NORMALIZE_WHITESPACE
q_0: ──■───────
┌─┴─┐
q_1: ┤ X ├──■──
└───┘┌─┴─┐
q_2: ─────┤ X ├
└───┘
q_3: ──────────
┌───┐
q_4: ┤ X ├──■──
└───┘┌─┴─┐
q_5: ─────┤ X ├
└───┘
"""
res = deepcopy(self)
if res._user_nb_qubits is not None and other._user_nb_qubits is not None:
res.nb_qubits += other.nb_qubits
else:
res._set_nb_qubits_dynamic(res.nb_qubits + other.nb_qubits)
res.append(other, qubits_offset=self.nb_qubits)
return res
def __matmul__(self, other: QCircuit) -> QCircuit:
return self.tensor(other)
[docs] def display(self, output: str = "mpl", warn: bool = True):
r"""Displays the circuit in the desired output format.
For now, this uses the qiskit circuit drawer, so all formats supported
by qiskit are supported.
Args:
output: Format of the output, see
`docs.quantum.ibm.com/build/circuit-visualization <https://docs.quantum.ibm.com/build/circuit-visualization#alternative-renderers>`_
for more information.
warn: Enable/Disable warnings for matplotlib figure. If `True` and we are not running headless
(i.e. on Linux with an unset DISPLAY), issue warning when called on a non-GUI backend.
Examples:
>>> theta = symbols("θ")
>>> circ = QCircuit([P(theta, 0)])
>>> circ.display("text")
┌──────┐
q: ┤ P(θ) ├
└──────┘
>>> print(circ.display("latex_source")) # doctest: +NORMALIZE_WHITESPACE
\documentclass[border=2px]{standalone}
\usepackage[braket, qm]{qcircuit}
\usepackage{graphicx}
\begin{document}
\scalebox{1.0}{
\Qcircuit @C=1.0em @R=0.2em @!R { \\
\nghost{{q} : } & \lstick{{q} : } & \gate{\mathrm{P}\,(\mathrm{{\ensuremath{\theta}}})} & \qw & \qw\\
\\ }}
\end{document}
"""
from matplotlib.figure import Figure
from qiskit.visualization import circuit_drawer
qc = self.to_other_language(language=Language.QISKIT)
if TYPE_CHECKING:
assert isinstance(qc, QuantumCircuit)
fig = circuit_drawer(qc, output=output, style={"backgroundcolor": "#EEEEEE"})
if isinstance(fig, Figure):
fig.show(warn=warn)
return fig
[docs] def size(self) -> tuple[int, int]:
"""Provides the size of the circuit, in terms of the number of quantum and
classical bits.
Returns:
A couple ``(q, c)`` of integers, with ``q`` the number of qubits,
and ``c`` the number of cbits of this circuit.
Examples:
>>> c1 = QCircuit([CNOT(0,1),CNOT(1,2)])
>>> c1.size()
(3, 0)
>>> c2 = QCircuit(3,nb_cbits=2)
>>> c2.size()
(3, 2)
>>> c3 = QCircuit([CNOT(0,1),CNOT(1,2), BasisMeasure(shots=200)])
>>> c3.size()
(3, 3)
"""
return self.nb_qubits, (self.nb_cbits or 0)
[docs] def depth(self) -> int:
"""Computes the depth of the circuit.
Returns:
Depth of the circuit.
Examples:
>>> QCircuit([CNOT(0, 1), CNOT(1, 2), CNOT(0, 1), X(2)]).depth()
3
>>> QCircuit([CNOT(0, 1), CNOT(1, 2), CNOT(0, 1), Barrier(), X(2)]).depth()
4
"""
if len(self) == 0:
return 0
nb_qubits = self.nb_qubits
instructions = self.without_measurements().instructions
layers = np.zeros((nb_qubits, self.count_gates()), dtype=bool)
current_layer = 0
last_barrier = 0
for instr in instructions:
if isinstance(instr, Barrier):
last_barrier = current_layer
current_layer += 1
continue
conns = list(instr.connections())
if any(layers[conns, current_layer]):
current_layer += 1
fitting_layer_index = current_layer
for index in range(current_layer, last_barrier - 1, -1):
if any(layers[conns, index]):
fitting_layer_index = index + 1
break
layers[conns, fitting_layer_index] = [True] * len(conns)
return current_layer + 1
def __len__(self) -> int:
"""Returns the number of instructions added to this circuit.
Returns:
An integer representing the number of instructions in this circuit.
Example:
>>> c1 = QCircuit([CNOT(0,1), CNOT(1,2), X(1), CNOT(1,2)])
>>> len(c1)
4
"""
return len(self.instructions)
def is_equivalent(self, circuit: QCircuit) -> bool:
"""Whether the circuit in parameter is equivalent to this circuit, in
terms of gates, but not measurements.
Depending on the definition of the gates of the circuit, several methods
could be used to do it in an optimized way.
Args:
circuit: The circuit for which we want to know if it is equivalent
to this circuit.
Returns:
``True`` if the circuit in parameter is equivalent to this circuit
Example:
>>> c1 = QCircuit([H(0), H(0)])
>>> c2 = QCircuit([Rx(0, 0)])
>>> c1.is_equivalent(c2)
True
3M-TODO: do we want to approximate ? Also take into account Noise
in the equivalence verification
"""
return matrix_eq(self.to_matrix(), circuit.to_matrix())
def optimize(self, criteria: Optional[OneOrMany[str]] = None) -> QCircuit:
"""Optimize the circuit to satisfy some criteria (depth, number of
qubits, gate restriction) in parameter.
Args:
criteria: String, or list of strings, regrouping the criteria of optimization of the circuit.
Returns:
the optimized QCircuit
Examples:
>>>
>>>
>>>
# 6M-TODO implement, example and test
"""
# ideas: a circuit can be optimized
# - to reduce the depth of the circuit (combine gates, simplify some sequences)
# - according to a given topology or qubits connectivity map
# - to avoid the use of some gates (imperfect or more noisy)
# - to avoid multi-qubit gates
...
[docs] def to_matrix(self) -> npt.NDArray[np.complex128]:
"""Compute the unitary matrix associated to this circuit.
Returns:
a unitary matrix representing this circuit
Examples:
>>> c = QCircuit([H(0), CNOT(0,1)])
>>> pprint(c.to_matrix())
[[0.70711, 0 , 0.70711 , 0 ],
[0 , 0.70711, 0 , 0.70711 ],
[0 , 0.70711, 0 , -0.70711],
[0.70711, 0 , -0.70711, 0 ]]
"""
from qiskit import QuantumCircuit
from qiskit.quantum_info.operators import Operator
qiskit_circuit = self.to_other_language(Language.QISKIT)
if TYPE_CHECKING:
assert isinstance(qiskit_circuit, QuantumCircuit)
matrix = Operator.from_circuit(qiskit_circuit).reverse_qargs().to_matrix()
if TYPE_CHECKING:
assert isinstance(matrix, np.ndarray)
if self.gphase != 0:
matrix *= np.exp(1j * self.gphase)
return matrix
[docs] def inverse(self) -> QCircuit:
"""Generate the inverse (dagger) of this circuit.
Returns:
The inverse circuit.
Examples:
>>> c1 = QCircuit([T(0), CZ(0,1), H(1), Ry(4.56, 1)])
>>> print(c1) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ T ├─■──────────────────
└───┘ │ ┌───┐┌──────────┐
q_1: ──────■─┤ H ├┤ Ry(4.56) ├
└───┘└──────────┘
>>> print(c1.inverse()) # doctest: +NORMALIZE_WHITESPACE
┌────┐
q_0: ───────────────────■─┤ T† ├
┌───────────┐┌───┐ │ └────┘
q_1: ┤ Ry(-4.56) ├┤ H ├─■───────
└───────────┘└───┘
>>> c2 = QCircuit([T(0), CRk(2, 0, 1), Barrier(), H(1), Ry(4.56, 1)])
>>> print(c2) # doctest: +NORMALIZE_WHITESPACE
┌───┐ ░
q_0: ┤ T ├─■────────░──────────────────
└───┘ │P(π/2) ░ ┌───┐┌──────────┐
q_1: ──────■────────░─┤ H ├┤ Ry(4.56) ├
░ └───┘└──────────┘
>>> print(c2.inverse()) # doctest: +NORMALIZE_WHITESPACE
░ ┌────┐
q_0: ───────────────────░──■────────┤ T† ├
┌───────────┐┌───┐ ░ │P(-π/2) └────┘
q_1: ┤ Ry(-4.56) ├┤ H ├─░──■──────────────
└───────────┘└───┘ ░
"""
dagger = deepcopy(self)
dagger.instructions = []
for instr in self.instructions:
if isinstance(instr, Gate):
dagger.instructions.insert(0, instr.inverse())
elif isinstance(instr, Barrier):
dagger.instructions.insert(0, instr)
else:
warn(
f"{type(instr).__name__} is not invertible and has been added at the end of the circuit.",
NonReversibleWarning,
)
dagger.instructions.append(instr)
return dagger
[docs] def to_gate(self) -> Gate:
"""Generate a gate from this entire circuit.
Returns:
A gate representing this circuit.
Examples:
>>> c = QCircuit([CNOT(0, 1), CNOT(1, 2), CNOT(0, 1), CNOT(2, 3)])
>>> pprint(c.to_gate().definition.matrix) # doctest: +NORMALIZE_WHITESPACE
[[1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1],
[0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0]]
"""
gate_def = self.to_matrix()
return CustomGate(gate_def, list(range(self.nb_qubits)), label=self.label)
[docs] @classmethod
def initializer(cls, state: npt.NDArray[np.complex128]) -> QCircuit:
"""Initialize this circuit at a given state, given in parameter.
This will imply adding gates at the beginning of the circuit.
Args:
state: StateVector modeling the state for initializing the circuit.
Returns:
A copy of the input circuit with additional instructions added
before-hand to generate the right initial state.
Examples:
>>> qc = QCircuit.initializer(np.array([1, 0, 0 ,1])/np.sqrt(2))
>>> print(qc) # doctest: +SKIP
┌────────────┐
q_0: ──┤ U(π/2,0,0) ├────■──────────────────────────
┌─┴────────────┴─┐┌─┴─┐┌──────────────────────┐
q_1: ┤ U(0,-π/4,-π/4) ├┤ X ├┤ U(0,-6.8934,0.61023) ├
└────────────────┘└───┘└──────────────────────┘
>>> pprint(run(qc, IBMDevice.AER_SIMULATOR_STATEVECTOR).amplitudes)
[0.70711, 0, 0, 0.70711]
"""
from qiskit import QuantumCircuit
from qiskit.circuit.library import StatePreparation
from qiskit.quantum_info import Statevector
from mpqp.tools.circuit import replace_custom_gate
from mpqp.tools.maths import normalize
size = int(np.log2(len(state)))
if 2**size != len(state):
raise ValueError(f"Input state {state} should have a power of 2 size")
qiskit_circuit = QuantumCircuit(size)
qiskit_circuit.append(
StatePreparation(Statevector(normalize(state))), range(size)
)
circ, phase = replace_custom_gate(qiskit_circuit[0], size)
circ = circ.reverse_bits()
cls = QCircuit.from_other_language(circ)
cls.gphase = phase
return cls
[docs] def count_gates(self, gate: Optional[Type[Gate]] = None) -> int:
"""Returns the number of gates contained in the circuit. If a specific
gate is given in the ``gate`` arg, it returns the number of occurrences
of this gate.
Args:
gate: The gate whose occurrence we want to determine in this circuit.
Returns:
The number of gates (of a specific type) contained in the
circuit.
Examples:
>>> circuit = QCircuit(
... [X(0), Y(1), Z(2), CNOT(0, 1), SWAP(0, 1), CZ(1, 2), X(2), X(1), X(0)]
... )
>>> circuit.count_gates()
9
>>> circuit.count_gates(X)
4
>>> circuit.count_gates(Ry)
0
"""
filter2 = Gate if gate is None else gate
return len([inst for inst in self.instructions if isinstance(inst, filter2)])
@property
def gates(self) -> list[Gate]:
"""Retrieve all the gates from the instructions in the circuit.
Returns:
The list of all gates present in the circuit.
Example:
>>> circuit = QCircuit([H(0), Barrier(), CNOT(0, 1), BasisMeasure()])
>>> circuit.gates
[H(0), CNOT(0, 1)]
"""
return [instr for instr in self.instructions if isinstance(instr, Gate)]
@property
def measurements(self) -> list[Measure]:
"""Returns all the measurements present in this circuit.
Returns:
The list of all measurements present in the circuit.
Example:
>>> circuit = QCircuit([
... BasisMeasure(shots=1000),
... ExpectationMeasure(Observable(np.identity(2)), [1], shots=1000)
... ])
>>> circuit.measurements # doctest: +NORMALIZE_WHITESPACE
[BasisMeasure(shots=1000),
ExpectationMeasure(Observable(array([[1.+0.j, 0.+0.j], [0.+0.j, 1.+0.j]]), 'observable_0'),
[1], shots=1000)]
"""
return [inst for inst in self.instructions if isinstance(inst, Measure)]
[docs] def without_measurements(self) -> QCircuit:
"""Provides a copy of this circuit with all the measurements removed.
Returns:
A copy of this circuit with all the measurements removed.
Example:
>>> circuit = QCircuit([X(0), CNOT(0, 1), BasisMeasure(shots=100)])
>>> print(circuit) # doctest: +NORMALIZE_WHITESPACE
┌───┐ ┌─┐
q_0: ┤ X ├──■──┤M├───
└───┘┌─┴─┐└╥┘┌─┐
q_1: ─────┤ X ├─╫─┤M├
└───┘ ║ └╥┘
c: 2/═══════════╩══╩═
0 1
>>> print(circuit.without_measurements()) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ X ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
"""
new_circuit = deepcopy(self)
new_circuit._nb_cbits = 0
new_circuit.instructions = [
inst for inst in self.instructions if not isinstance(inst, Measure)
]
return new_circuit
[docs] def without_breakpoints(self) -> QCircuit:
"""Provides a copy of this circuit with all the breakpoints removed.
Returns:
A copy of this circuit with all the breakpoints removed.
"""
new_circuit = deepcopy(self)
new_circuit.instructions = [
inst for inst in self.instructions if not isinstance(inst, Breakpoint)
]
return new_circuit
[docs] def without_noises(self) -> QCircuit:
"""Provides a copy of this circuit with all the noise models removed.
Returns:
A copy of this circuit with all the noise models removed.
Example:
>>> circuit = QCircuit(2)
>>> circuit.add([CNOT(0, 1), Depolarizing(prob=0.4, targets=[0, 1]), BasisMeasure(shots=100)])
>>> print(circuit) # doctest: +NORMALIZE_WHITESPACE
┌─┐
q_0: ──■──┤M├───
┌─┴─┐└╥┘┌─┐
q_1: ┤ X ├─╫─┤M├
└───┘ ║ └╥┘
c: 2/══════╩══╩═
0 1
NoiseModel: Depolarizing(0.4, [0, 1])
>>> print(circuit.without_noises()) # doctest: +NORMALIZE_WHITESPACE
┌─┐
q_0: ──■──┤M├───
┌─┴─┐└╥┘┌─┐
q_1: ┤ X ├─╫─┤M├
└───┘ ║ └╥┘
c: 2/══════╩══╩═
0 1
"""
new_circuit = deepcopy(self)
new_circuit.noises = []
return new_circuit
[docs] def pre_measure(self) -> QCircuit:
circuit = QCircuit()
circuit._set_nb_qubits_dynamic(self.nb_qubits)
for measure in self.measurements:
if isinstance(measure, BasisMeasure):
if len(measure.pre_measure.instructions) != 0:
circuit.add(Barrier())
circuit = circuit + measure.pre_measure
if isinstance(measure, ExpectationMeasure):
if len(measure.pre_measure.instructions) != 0:
circuit.add(Barrier())
circuit = circuit + measure.pre_measure
return circuit
@overload
def to_other_language(
self,
language: Literal[Language.QASM2, Language.QASM3],
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> str: ...
@overload
def to_other_language(
self,
language: Literal[Language.CIRQ],
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> cirq_Circuit: ...
@overload
def to_other_language(
self,
language: Literal[Language.BRAKET],
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> braket_Circuit: ...
@overload
def to_other_language(
self,
language: Literal[Language.MY_QLM],
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> myQLM_Circuit: ...
@overload
def to_other_language(
self,
language: Literal[Language.QISKIT],
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> QuantumCircuit: ...
@overload
def to_other_language(
self,
language: Language,
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> QuantumCircuit | myQLM_Circuit | braket_Circuit | cirq_Circuit | str: ...
[docs] def to_other_language(
self,
language: Language = Language.QISKIT,
translation_warning: bool = True,
skip_pre_measure: bool = False,
printing: bool = False,
) -> QuantumCircuit | myQLM_Circuit | braket_Circuit | cirq_Circuit | str:
"""Transforms this circuit into the corresponding circuit in the language
specified in the ``language`` arg.
Some measurements require some adaptation between the user defined
circuit and the measure. For instance if the targets are not given in a
contiguous ordered list or if the basis measurement is in a basis other
than the computational basis. We automatically add this adaptation as an
intermediate circuit called ``pre_measure``.
By default, the circuit is translated to the corresponding
``QuantumCircuit`` in Qiskit since this is the interface we use to
generate the OpenQASM code.
In the future, we will generate the OpenQASM code on our own, and this
method will be used only for complex objects that are not tractable with
OpenQASM (like hybrid structures).
Args:
language: Enum representing the target language.
translation_warning: If `True`, a warning will be raised.
skip_pre_measure: If true, the ``pre_measure`` circuit will not be
added to the output.
printing: If ``True`` dummy gates will replace custom gates (because
qiskit's ``Operators`` cannot have ``Parameters`` in their
definition.)
Returns:
The corresponding circuit in the target language.
Examples:
>>> circuit = QCircuit([X(0), CNOT(0, 1)])
>>> qc = circuit.to_other_language()
>>> type(qc)
<class 'qiskit.circuit.quantumcircuit.QuantumCircuit'>
>>> circuit2 = QCircuit([H(0), CZ(0,1), Depolarizing(0.6, [0]), BasisMeasure()])
>>> print(circuit2.to_other_language(Language.BRAKET)) # doctest: +NORMALIZE_WHITESPACE
T : │ 0 │ 1 │
┌───┐ ┌───────────┐ ┌───────────┐
q0 : ─┤ H ├─┤ DEPO(0.6) ├───●───┤ DEPO(0.6) ├─
└───┘ └───────────┘ │ └───────────┘
┌─┴─┐
q1 : ─────────────────────┤ Z ├───────────────
└───┘
T : │ 0 │ 1 │
>>> print(circuit2.to_other_language(Language.QASM2)) # doctest: +NORMALIZE_WHITESPACE
OPENQASM 2.0;
include "qelib1.inc";
qreg q[2];
creg c[2];
h q[0];
cz q[0],q[1];
measure q[0] -> c[0];
measure q[1] -> c[1];
>>> print(circuit2.to_other_language(Language.QASM3, translation_warning=False)) # doctest: +NORMALIZE_WHITESPACE
OPENQASM 3.0;
include "stdgates.inc";
qubit[2] q;
bit[2] c;
h q[0];
cz q[0],q[1];
c[0] = measure q[0];
c[1] = measure q[1];
Note:
Most providers take noise into account at the job level. A notable
exception is Braket, where the noise is contained in the circuit
object. For this reason, you will find the noise included in the Braket
circuits.
"""
if not skip_pre_measure:
circuit = self.without_measurements()
circuit += self.pre_measure()
circuit.add(self.measurements)
circuit_other = circuit.to_other_language(
language,
translation_warning=translation_warning,
skip_pre_measure=True,
printing=printing,
)
self.gphase = circuit.gphase
return circuit_other
if language == Language.QISKIT:
from qiskit.circuit import Operation, QuantumCircuit
from qiskit.circuit.quantumcircuit import CircuitInstruction
from qiskit.quantum_info import Operator
# to avoid defining twice the same parameter, we keep trace of the
# added parameters, and we use those instead of new ones when they
# are used more than once
qiskit_parameters = set()
if self.nb_cbits == 0:
new_circ = QuantumCircuit(self.nb_qubits)
else:
new_circ = QuantumCircuit(self.nb_qubits, self.nb_cbits)
if self.label is not None:
new_circ.name = self.label
for instruction in self.instructions:
if isinstance(instruction, (Measure, Breakpoint)):
continue
options = (
{"printing": printing}
if isinstance(instruction, CustomGate)
else {}
)
qiskit_inst = instruction.to_other_language(
language, qiskit_parameters, **options
)
if TYPE_CHECKING:
assert isinstance(
qiskit_inst, (CircuitInstruction, Operation, Operator)
)
cargs = []
if isinstance(instruction, CustomGate):
if TYPE_CHECKING:
assert isinstance(qiskit_inst, Operator)
new_circ.unitary(
qiskit_inst,
list(reversed(instruction.targets)), # dang qiskit qubits order
instruction.label,
)
else:
if isinstance(instruction, ControlledGate):
qargs = instruction.controls + instruction.targets
elif isinstance(instruction, Gate):
qargs = instruction.targets
elif isinstance(instruction, Barrier):
qargs = range(self.nb_qubits)
else:
raise ValueError(f"Instruction not handled: {instruction}")
if TYPE_CHECKING:
assert not isinstance(qiskit_inst, Operator)
new_circ.append(
qiskit_inst,
qargs,
cargs,
)
for measurement in self.measurements:
if isinstance(measurement, ExpectationMeasure):
# these measures have no equivalent in Qiskit
continue
qiskit_inst = measurement.to_other_language(language, qiskit_parameters)
if isinstance(measurement, BasisMeasure):
if TYPE_CHECKING:
assert measurement.c_targets is not None
qargs = [measurement.targets]
cargs = [measurement.c_targets]
else:
raise ValueError(f"measurement not handled: {measurement}")
if TYPE_CHECKING:
assert not isinstance(qiskit_inst, Operator)
new_circ.append(
qiskit_inst,
qargs,
cargs,
)
return new_circ
elif language == Language.MY_QLM:
cleaned_circuit = self.without_measurements()
qasm2_code = cleaned_circuit.to_other_language(
Language.QASM2,
translation_warning=translation_warning,
skip_pre_measure=True,
)
self.gphase = cleaned_circuit.gphase
if TYPE_CHECKING:
assert isinstance(qasm2_code, str)
from mpqp.qasm.qasm_to_myqlm import qasm2_to_myqlm_Circuit
myqlm_circuit = qasm2_to_myqlm_Circuit(qasm2_code)
return myqlm_circuit
elif language == Language.BRAKET:
# filling the circuit with identity gates when some qubits don't have any instruction
used_qubits = set().union(
*(
inst.connections()
for inst in self.instructions
if isinstance(inst, Gate)
)
)
circuit = QCircuit(
[
Id(qubit)
for qubit in range(self.nb_qubits)
if qubit not in used_qubits
],
nb_qubits=self.nb_qubits,
) + deepcopy(self)
from mpqp.execution.providers.aws import apply_noise_to_braket_circuit
if len(self.noises) != 0:
if any(isinstance(instr, CRk) for instr in self.instructions):
raise NotImplementedError(
"Cannot simulate noisy circuit with CRk gate due to "
"an error on AWS Braket side."
)
qasm3_code = circuit.to_other_language(
Language.QASM3,
translation_warning=translation_warning,
skip_pre_measure=True,
)
self.gphase = circuit.gphase
if TYPE_CHECKING:
assert isinstance(qasm3_code, str)
from mpqp.qasm.qasm_to_braket import qasm3_to_braket_Circuit
return apply_noise_to_braket_circuit(
qasm3_to_braket_Circuit(qasm3_code, translation_warning),
self.noises,
self.nb_qubits,
)
elif language == Language.CIRQ:
from cirq.circuits.circuit import Circuit as CirqCircuit
from cirq.ops.identity import I
from cirq.ops.named_qubit import NamedQubit
cirq_qubits = [NamedQubit(f"q_{i}") for i in range(self.nb_qubits)]
cirq_circuit = CirqCircuit()
for qubit in cirq_qubits:
cirq_circuit.append(I(qubit))
for instruction in self.instructions:
if isinstance(instruction, (ExpectationMeasure, Barrier, Breakpoint)):
continue
elif isinstance(instruction, (CustomGate, CustomControlledGate)):
custom_circuit = QCircuit(self.nb_qubits)
custom_circuit.add(instruction)
qasm2_code = custom_circuit.to_other_language(
Language.QASM2,
translation_warning=translation_warning,
skip_pre_measure=True,
)
if TYPE_CHECKING:
assert isinstance(qasm2_code, str)
from mpqp.qasm.qasm_to_cirq import qasm2_to_cirq_Circuit
custom_cirq_circuit = qasm2_to_cirq_Circuit(qasm2_code)
cirq_circuit += custom_cirq_circuit
self.gphase += custom_circuit.gphase
elif isinstance(instruction, ControlledGate):
targets = []
for target in instruction.targets:
targets.append(cirq_qubits[target])
controls = []
for control in instruction.controls:
controls.append(cirq_qubits[control])
cirq_instruction = instruction.to_other_language(Language.CIRQ)
cirq_circuit.append(cirq_instruction.on(*controls, *targets))
else:
targets = []
for target in instruction.targets:
targets.append(cirq_qubits[target])
cirq_instruction = instruction.to_other_language(Language.CIRQ)
cirq_circuit.append(cirq_instruction.on(*targets))
if self.noises:
from mpqp.execution.providers.google import apply_noise_to_cirq_circuit
return apply_noise_to_cirq_circuit(
cirq_circuit,
self.noises,
)
return cirq_circuit
elif language == Language.QASM2:
from mpqp.qasm.mpqp_to_qasm import mpqp_to_qasm2
qasm_str, gphase = mpqp_to_qasm2(self)
self.gphase = gphase
return qasm_str
elif language == Language.QASM3:
qasm2_code = self.to_other_language(
Language.QASM2,
translation_warning=translation_warning,
skip_pre_measure=True,
)
if TYPE_CHECKING:
assert isinstance(qasm2_code, str)
from mpqp.qasm.open_qasm_2_and_3 import open_qasm_2_to_3
qasm3_code = open_qasm_2_to_3(
qasm2_code, translation_warning=translation_warning
)
return qasm3_code
else:
raise NotImplementedError(f"Error: {language} is not supported")
@overload
def to_other_device(
self,
device: ATOSDevice,
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> myQLM_Circuit: ...
@overload
def to_other_device(
self,
device: AWSDevice,
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> braket_Circuit: ...
@overload
def to_other_device(
self,
device: GOOGLEDevice,
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> cirq_Circuit: ...
@overload
def to_other_device(
self,
device: Union[IBMDevice, IBMSimulatedDevice],
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> QuantumCircuit: ...
@overload
def to_other_device(
self,
device: AvailableDevice,
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> QuantumCircuit | myQLM_Circuit | braket_Circuit | cirq_Circuit: ...
[docs] def to_other_device(
self,
device: AvailableDevice,
translation_warning: bool = True,
skip_pre_measure: bool = False,
) -> QuantumCircuit | myQLM_Circuit | braket_Circuit | cirq_Circuit:
"""Transforms this circuit into the corresponding device specified
in the ``device`` arg.
Some measurements require some adaptation between the user defined
circuit and the measure. For instance if the targets are not given in a
contiguous ordered list or if the basis measurement is in a basis other
than the computational basis. We automatically add this adaptation as an
intermediate circuit called ``pre_measure``.
Args:
device: representing the target device.
translation_warning: If `True`, a warning will be raised.
skip_pre_measure: If true, the ``pre_measure`` circuit will not be
added to the output.
Returns:
The corresponding circuit in the target device.
Examples:
>>> circuit = QCircuit([H(0), BasisMeasure()])
>>> qc = circuit.to_other_device(IBMDevice.AER_SIMULATOR)
>>> type(qc)
<class 'qiskit.circuit.quantumcircuit.QuantumCircuit'>
>>> print(qc) # doctest: +NORMALIZE_WHITESPACE
┌───┐┌─┐
q: ┤ H ├┤M├
└───┘└╥┘
c: 1/══════╩═
0
>>> print(circuit.to_other_device(IBMDevice.IBM_BRISBANE)) # doctest: +SKIP
global phase: π/4
┌─────────┐┌────┐┌─────────┐┌─┐
q_0 -> 0 ┤ Rz(π/2) ├┤ √X ├┤ Rz(π/2) ├┤M├
└─────────┘└────┘└─────────┘└╥┘
ancilla_0 -> 1 ─────────────────────────────╫─ ...
║
ancilla_125 -> 126 ─────────────────────────────╫─
║
c: 1/═════════════════════════════╩═
0
Note:
Most providers take noise into account at the job level. A notable
exception is Braket, where the noise is contained in the circuit
object. For this reason, you will find the noise included in the Braket
circuits.
"""
from mpqp.execution.devices import (
ATOSDevice,
AWSDevice,
GOOGLEDevice,
IBMDevice,
)
from mpqp.execution.simulated_devices import IBMSimulatedDevice
if isinstance(device, (IBMDevice, IBMSimulatedDevice)):
from mpqp.execution.providers.ibm import generate_qiskit_noise_model
circuit = deepcopy(self)
backend_sim = None
if not device.is_remote():
from qiskit_aer import AerSimulator
if isinstance(device, IBMSimulatedDevice):
if len(circuit.noises) != 0:
warn(
"NoiseModel are ignored when running the circuit on a "
"SimulatedDevice"
)
backend_sim = device.to_noisy_simulator()
elif len(circuit.noises) != 0:
noise_model, circuit = generate_qiskit_noise_model(
circuit, translation_warning
)
self.transpiled_noise_model = noise_model
backend_sim = AerSimulator(
method=device.value, noise_model=noise_model
)
else:
backend_sim = AerSimulator(method=device.value)
if any(
isinstance(i, tuple(device.incompatible_gate()))
for i in circuit.instructions
):
raise ValueError(
f"Gate(s) {', '.join(map(str, device.incompatible_gate()))} cannot be simulated on {device}."
)
if (
isinstance(device, IBMSimulatedDevice)
and device.value().num_qubits < circuit.nb_qubits
):
raise DeviceJobIncompatibleError(
f"Number of qubits of the circuit ({circuit.nb_qubits}) is higher "
f"than the one of the IBMSimulatedDevice ({device.value().num_qubits})."
)
qiskit_circuit = circuit.to_other_language(
Language.QISKIT, translation_warning, skip_pre_measure
)
if TYPE_CHECKING:
assert isinstance(qiskit_circuit, QuantumCircuit)
qiskit_circuit = qiskit_circuit.reverse_bits()
if not device.is_remote():
if len(self.measurements) == 1:
if (
isinstance(self.measurements[0], BasisMeasure)
and self.measurements[0].shots <= 0
): # JobType.SAMPLE
from qiskit import transpile
qiskit_circuit = transpile(qiskit_circuit, backend_sim)
elif isinstance(
self.measurements[0], ExpectationMeasure
): # JobType.OBSERVABLE
if isinstance(device, IBMSimulatedDevice):
from qiskit.transpiler.preset_passmanagers import (
generate_preset_pass_manager,
)
backend = device.value()
pm = generate_preset_pass_manager(
optimization_level=0, backend=backend
)
qiskit_circuit = pm.run(qiskit_circuit)
else:
from qiskit.transpiler.preset_passmanagers import (
generate_preset_pass_manager,
)
from mpqp.execution.connection.ibm_connection import get_backend
if TYPE_CHECKING:
assert isinstance(device, IBMDevice)
backend = get_backend(device)
pm = generate_preset_pass_manager(backend=backend, optimization_level=1)
qiskit_circuit = pm.run(qiskit_circuit)
# TODO: removed with PR - Circuit Handling and PauliString Utilities #154
if any(
isinstance(gate, CustomControlledGate) for gate in self.instructions
):
from qiskit import transpile
if TYPE_CHECKING:
assert isinstance(qiskit_circuit, QuantumCircuit)
qiskit_circuit = transpile(qiskit_circuit, backend_sim)
return qiskit_circuit
elif isinstance(device, GOOGLEDevice):
from cirq.circuits.circuit import Circuit as CirqCircuit
cirq_circuit = self.to_other_language(
Language.CIRQ, translation_warning, skip_pre_measure
)
if TYPE_CHECKING:
assert isinstance(cirq_circuit, CirqCircuit)
if device.is_remote() and device.is_ionq():
from cirq.devices.line_qubit import LineQubit
from cirq.transformers.optimize_for_target_gateset import (
optimize_for_target_gateset,
)
from cirq_ionq.ionq_gateset import IonQTargetGateset
cirq_circuit = optimize_for_target_gateset(
cirq_circuit, gateset=IonQTargetGateset()
)
cirq_circuit = cirq_circuit.transform_qubits(
{qb: LineQubit(i) for i, qb in enumerate(cirq_circuit.all_qubits())}
)
elif device.is_processor():
from cirq.transformers.optimize_for_target_gateset import (
optimize_for_target_gateset,
)
from cirq.transformers.routing.route_circuit_cqc import RouteCQC
from cirq.transformers.target_gatesets.sqrt_iswap_gateset import (
SqrtIswapTargetGateset,
)
from cirq_google.engine.virtual_engine_factory import (
create_device_from_processor_id,
)
cirq_device = create_device_from_processor_id(device.value)
if cirq_device.metadata is None:
raise ValueError(
f"Device {device} does not have metadata for processor {device.value}"
)
# For some processors, the circuits need to be optimized for the
# architecture. This is done here.
router = RouteCQC(cirq_device.metadata.nx_graph)
route_circ, _, _ = router.route_circuit(cirq_circuit)
cirq_circuit = optimize_for_target_gateset(
route_circ, gateset=SqrtIswapTargetGateset()
)
cirq_device.validate_circuit(cirq_circuit)
return cirq_circuit
elif isinstance(device, AWSDevice):
aws_circuit = self.to_other_language(
Language.BRAKET, translation_warning, skip_pre_measure
)
return aws_circuit
elif isinstance(device, ATOSDevice):
circuit = self.to_other_language(
Language.MY_QLM, translation_warning, skip_pre_measure
)
return circuit
else:
raise NotImplementedError(f"Error: {device} is not supported")
[docs] @classmethod
def from_other_language(
cls,
qcircuit: QuantumCircuit | cirq_Circuit | braket_Circuit | myQLM_Circuit | str,
) -> QCircuit:
"""Transforms a quantum circuit from an external representation (Qiskit, Cirq, Braket, MyQLM, QASM2 or QASM3) into
the corresponding internal ``QCircuit`` format.
Args:
qcircuit: The input quantum circuit which can be one of the following types:
- ``QuantumCircuit`` : A Qiskit QuantumCircuit object.
- ``cirq_Circuit`` : A Cirq Circuit object.
- ``braket_Circuit``: A Braket Circuit object.
- ``myQLM_Circuit``: A MyQLM Circuit object.
- ``str``: A string representing an OpenQASM 2.0 or OpenQASM3 circuit.
Returns:
The mpqp ``QCircuit`` corresponding to the external circuit in parameter.
Raises:
NotImplementedError: If the input circuit is from an other provider or a string but not in OpenQASM 2.0 or 3.0 format.
Examples:
>>> from qiskit.circuit import QuantumCircuit
>>> qiskit_circuit = QuantumCircuit(2)
>>> _ = qiskit_circuit.h(0)
>>> _ = qiskit_circuit.cx(0, 1)
>>> qcircuit1 = QCircuit.from_other_language(qiskit_circuit)
>>> print(qcircuit1) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
>>> import cirq
>>> q0, q1 = cirq.LineQubit.range(2)
>>> cirq_circuit = cirq.Circuit()
>>> cirq_circuit.append(cirq.H(q0))
>>> cirq_circuit.append(cirq.CNOT(q0, q1))
>>> qcircuit2 = QCircuit.from_other_language(cirq_circuit)
>>> print(qcircuit2) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
>>> from braket.circuits import Circuit
>>> braket_circuit = Circuit().h(0).cnot(0, 1)
>>> qcircuit3 = QCircuit.from_other_language(braket_circuit)
>>> print(qcircuit3) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
c: 2/══════════
>>> from qat.lang.AQASM import Program, H, CNOT
>>> prog = Program()
>>> qbits = prog.qalloc(2)
>>> _ = H(qbits[0])
>>> _ = CNOT(qbits[0], qbits[1])
>>> myqlm_circuit = prog.to_circ()
>>> qcircuit4 = QCircuit.from_other_language(myqlm_circuit)
>>> print(qcircuit4) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
>>> qasm2_code = '''
... OPENQASM 2.0;
... qreg q[2];
... h q[0];
... cx q[0], q[1];
... '''
>>> qcircuit5 = QCircuit.from_other_language(qasm2_code)
>>> print(qcircuit5) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
>>> qasm3_code = '''
... OPENQASM 3.0;
... qubit[2] q;
... h q[0];
... cx q[0], q[1];
... '''
>>> qcircuit6 = QCircuit.from_other_language(qasm3_code)
>>> print(qcircuit6) # doctest: +NORMALIZE_WHITESPACE
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
"""
from braket.circuits import Circuit as braket_Circuit
from cirq.circuits.circuit import Circuit as cirq_Circuit
from cirq.circuits.moment import Moment
from qat.core.wrappers.circuit import Circuit as myQLM_Circuit
from qiskit import QuantumCircuit
from mpqp.qasm.qasm_to_mpqp import qasm2_parse
if isinstance(qcircuit, QuantumCircuit):
from qiskit import qasm3
from mpqp.qasm import open_qasm_3_to_2
qasm3_code = qasm3.dumps(qcircuit)
qasm2_code, phase = open_qasm_3_to_2(
str(qasm3_code), language=Language.QISKIT
)
qc = qasm2_parse(qasm2_code)
qc.gphase = phase
return qc
elif isinstance(qcircuit, cirq_Circuit) or isinstance(qcircuit, Moment):
from mpqp.qasm.qasm_to_mpqp import parse_qasm2_gates
if isinstance(qcircuit, Moment):
qcircuit = cirq_Circuit([qcircuit])
qasm2_code, gphase = parse_qasm2_gates(qcircuit.to_qasm())
qc = qasm2_parse(qasm2_code)
qc.gphase = gphase
return qc
elif isinstance(qcircuit, braket_Circuit):
from braket.circuits.serialization import IRType
from braket.ir.openqasm.program_v1 import Program
from mpqp.qasm.open_qasm_2_and_3 import open_qasm_3_to_2
from mpqp.qasm.qasm_to_braket import (
braket_noise_to_mpqp,
braket_custom_gates_to_mpqp,
)
qasm3_code = qcircuit.to_ir(IRType.OPENQASM)
if TYPE_CHECKING:
assert isinstance(qasm3_code, Program)
custom_gates = braket_custom_gates_to_mpqp(qasm3_code.source)
noises = braket_noise_to_mpqp(qasm3_code.source)
qasm2_code, phase = open_qasm_3_to_2(
str(qasm3_code.source), language=Language.BRAKET
)
qc = qasm2_parse(qasm2_code)
qc.gphase = phase
qc = qc.without_measurements()
if len(custom_gates) != 0:
qc.add(custom_gates)
if len(noises) != 0:
qc.add(noises)
return qc
elif isinstance(qcircuit, myQLM_Circuit):
from mpqp.qasm.myqlm_to_mpqp import from_myqlm_to_mpqp
return from_myqlm_to_mpqp(qcircuit)
elif isinstance(qcircuit, str):
for line in qcircuit.split('\n'):
if not line.startswith("//") and line != '':
OPENQASM_VERSIONS = ("OPENQASM 2.0", "OPENQASM 3.0")
if not any(
line.startswith(version) for version in OPENQASM_VERSIONS
):
raise NotImplementedError(
f"Error: only OpenQASM2 and OpenQASM3 are supported for qasm external description of the circuit"
)
elif line.startswith("OPENQASM 2.0"):
from mpqp.qasm.qasm_to_mpqp import parse_qasm2_gates
qasm2_code, gphase = parse_qasm2_gates(qcircuit)
qc = qasm2_parse(qasm2_code)
qc.gphase = gphase
return qc
elif line.startswith("OPENQASM 3.0"):
from mpqp.qasm import open_qasm_3_to_2
qasm2_code, phase = open_qasm_3_to_2(qcircuit)
qc = qasm2_parse(qasm2_code)
qc.gphase = phase
return qc
break
return qasm2_parse(qcircuit)
else:
raise NotImplementedError(f"Error: {type(qcircuit)} is not supported.")
[docs] def subs(
self, values: dict[Expr | str, Complex], remove_symbolic: bool = False
) -> QCircuit:
r"""Substitute the parameters of the circuit with values for each of the
specified parameters. Optionally also remove all symbolic variables such
as `\pi` (needed for example for circuit execution).
Since we use ``sympy`` for the gate parameters, the ``values`` can in fact be
anything the ``subs`` method from ``sympy`` would accept.
Args:
values: Mapping between the variables and the replacing values.
remove_symbolic: Whether symbolic values should be replaced by their
numeric counterparts.
Returns:
The circuit with the replaced parameters.
Examples:
>>> theta, k = symbols("θ k")
>>> c = QCircuit(
... [Rx(theta, 0), CNOT(1,0), CNOT(1,2), X(2), Rk(2,1), H(0), CRk(k, 0, 1),
... BasisMeasure(shots=1000)]
... )
>>> print(c) # doctest: +NORMALIZE_WHITESPACE
┌───────┐┌───┐┌───┐ ┌─┐
q_0: ┤ Rx(θ) ├┤ X ├┤ H ├───────────■─────────────────┤M├───
└───────┘└─┬─┘└───┘┌────────┐ │P(2**(1 - k)*pi) └╥┘┌─┐
q_1: ───────────■────■──┤ P(π/2) ├─■──────────────────╫─┤M├
┌─┴─┐└─┬───┬──┘ ┌─┐ ║ └╥┘
q_2: ──────────────┤ X ├──┤ X ├───────────┤M├─────────╫──╫─
└───┘ └───┘ └╥┘ ║ ║
c: 3/══════════════════════════════════════╩══════════╩══╩═
2 0 1
>>> print(c.subs({theta: np.pi, k: 1})) # doctest: +NORMALIZE_WHITESPACE
┌───────┐┌───┐┌───┐ ┌─┐
q_0: ┤ Rx(π) ├┤ X ├┤ H ├───────────■─────┤M├───
└───────┘└─┬─┘└───┘┌────────┐ │P(π) └╥┘┌─┐
q_1: ───────────■────■──┤ P(π/2) ├─■──────╫─┤M├
┌─┴─┐└─┬───┬──┘ ┌─┐ ║ └╥┘
q_2: ──────────────┤ X ├──┤ X ├─────┤M├───╫──╫─
└───┘ └───┘ └╥┘ ║ ║
c: 3/════════════════════════════════╩════╩══╩═
2 0 1
"""
new_circuit = deepcopy(self)
new_circuit.instructions = [
inst.subs(values, remove_symbolic) for inst in self.instructions
]
return new_circuit
[docs] def pretty_print(self):
"""Provides a pretty print of the QCircuit.
Examples:
>>> c = QCircuit([H(0), CNOT(0,1)])
>>> c.pretty_print() # doctest: +NORMALIZE_WHITESPACE
QCircuit : Size (Qubits, Cbits) = (2, 0), Nb instructions = 2
┌───┐
q_0: ┤ H ├──■──
└───┘┌─┴─┐
q_1: ─────┤ X ├
└───┘
"""
print(
f"QCircuit {self.label or ''}: Size (Qubits, Cbits) = {self.size()},"
f" Nb instructions = {len(self)}"
)
for noise in self.noises:
print(noise.info())
qiskit_circuit = self.to_other_language(Language.QISKIT)
if TYPE_CHECKING:
assert isinstance(qiskit_circuit, QuantumCircuit)
print(qiskit_circuit.draw(output="text", fold=0))
def __str__(self) -> str:
qiskit_circ = self.to_other_language(Language.QISKIT, printing=True)
if TYPE_CHECKING:
from qiskit import QuantumCircuit
assert isinstance(qiskit_circ, QuantumCircuit)
output = str(qiskit_circ.draw(output="text", fold=0))
if len(self.noises) != 0:
noises = "\n ".join(str(noise) for noise in self.noises)
output += f"\nNoiseModel:\n {noises}"
return output
def __repr__(self) -> str:
args = []
components: list[Instruction | NoiseModel] = self.instructions + self.noises
if len(components) != 0:
args.append(f"[{', '.join(repr(component) for component in components)}]")
if self._user_nb_qubits is not None:
if len(components) == 0:
args.append(f"{self.nb_qubits}")
else:
args.append(f"nb_qubits={self.nb_qubits}")
if self._user_nb_cbits is not None:
args.append(f"nb_cbits={self.nb_cbits}")
if self.label is not None:
args.append(f'label="{self.label}"')
args_repr = ', '.join(args)
return f'QCircuit({args_repr})'
[docs] def variables(self) -> set[Basic]:
"""Returns all the symbolic parameters involved in this circuit.
Returns:
All the parameters of the circuit.
Example:
>>> circ = QCircuit([
... Rx(theta, 0), CNOT(1,0), CNOT(1,2), X(2), Rk(2,1),
... H(0), CRk(k, 0, 1), ExpectationMeasure(obs, [1])
... ])
>>> circ.variables() # doctest: +SKIP
{θ, k}
"""
from sympy import Expr
params: set[Basic] = set()
for inst in self.instructions:
if isinstance(inst, ParametrizedGate):
for param in inst.parameters:
if isinstance(param, Expr):
params.update(param.free_symbols)
return params
@property
def breakpoints(self) -> list[Breakpoint]:
"""Returns the breakpoints of the circuit in order."""
return [inst for inst in self.instructions if isinstance(inst, Breakpoint)]