qiskit.transpiler.passes.basis.decompose のソースコード
# This code is part of Qiskit.
#
# (C) Copyright IBM 2017, 2018.
#
# This code is licensed under the Apache License, Version 2.0. You may
# obtain a copy of this license in the LICENSE.txt file in the root directory
# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
#
# Any modifications or derivative works of this code must retain this
# copyright notice, and modified files need to carry a notice indicating
# that they have been altered from the originals.
"""Expand a gate in a circuit using its decomposition rules."""
import warnings
from typing import Type, Union, List, Optional
from fnmatch import fnmatch
from qiskit.transpiler.basepasses import TransformationPass
from qiskit.dagcircuit.dagcircuit import DAGCircuit
from qiskit.converters.circuit_to_dag import circuit_to_dag
from qiskit.circuit.gate import Gate
from qiskit.utils.deprecation import deprecate_arguments
[ドキュメント]class Decompose(TransformationPass):
"""Expand a gate in a circuit using its decomposition rules."""
@deprecate_arguments({"gate": "gates_to_decompose"})
def __init__(
self,
gate: Optional[Type[Gate]] = None,
gates_to_decompose: Optional[Union[Type[Gate], List[Type[Gate]], List[str], str]] = None,
) -> None:
"""Decompose initializer.
Args:
gate: DEPRECATED gate to decompose.
gates_to_decompose: optional subset of gates to be decomposed,
identified by gate label, name or type. Defaults to all gates.
"""
super().__init__()
if gate is not None:
self.gates_to_decompose = gate
else:
self.gates_to_decompose = gates_to_decompose
@property
def gate(self) -> Gate:
"""Returns the gate"""
warnings.warn(
"The gate argument is deprecated as of qiskit-terra 0.19.0, and "
"will be removed no earlier than 3 months after that "
"release date. You should use the gates_to_decompose argument "
"instead.",
DeprecationWarning,
stacklevel=2,
)
return self.gates_to_decompose
@gate.setter
def gate(self, value):
"""Sets the gate
Args:
value (Gate): new value for gate
"""
warnings.warn(
"The gate argument is deprecated as of qiskit-terra 0.19.0, and "
"will be removed no earlier than 3 months after that "
"release date. You should use the gates_to_decompose argument "
"instead.",
DeprecationWarning,
stacklevel=2,
)
self.gates_to_decompose = value
[ドキュメント] def run(self, dag: DAGCircuit) -> DAGCircuit:
"""Run the Decompose pass on `dag`.
Args:
dag: input dag.
Returns:
output dag where ``gate`` was expanded.
"""
# Walk through the DAG and expand each non-basis node
for node in dag.op_nodes():
if self._should_decompose(node):
if node.op.definition is None:
continue
# TODO: allow choosing among multiple decomposition rules
rule = node.op.definition.data
if len(rule) == 1 and len(node.qargs) == len(rule[0].qubits) == 1:
if node.op.definition.global_phase:
dag.global_phase += node.op.definition.global_phase
dag.substitute_node(node, rule[0].operation, inplace=True)
else:
decomposition = circuit_to_dag(node.op.definition)
dag.substitute_node_with_dag(node, decomposition)
return dag
def _should_decompose(self, node) -> bool:
"""Call a decomposition pass on this circuit,
to decompose one level (shallow decompose)."""
if self.gates_to_decompose is None: # check if no gates given
return True
has_label = False
if not isinstance(self.gates_to_decompose, list):
gates = [self.gates_to_decompose]
else:
gates = self.gates_to_decompose
strings_list = [s for s in gates if isinstance(s, str)]
gate_type_list = [g for g in gates if isinstance(g, type)]
if hasattr(node.op, "label") and node.op.label is not None:
has_label = True
if has_label and ( # check if label or label wildcard is given
node.op.label in gates or any(fnmatch(node.op.label, p) for p in strings_list)
):
return True
elif not has_label and ( # check if name or name wildcard is given
node.name in gates or any(fnmatch(node.name, p) for p in strings_list)
):
return True
elif not has_label and ( # check if Gate type given
any(isinstance(node.op, op) for op in gate_type_list)
):
return True
else:
return False