diff --git a/doc/releases/changelog-dev.md b/doc/releases/changelog-dev.md index 1a667c45a16..f206fb023e3 100644 --- a/doc/releases/changelog-dev.md +++ b/doc/releases/changelog-dev.md @@ -65,6 +65,9 @@

Breaking changes 💔

+* `qml.is_commuting` no longer accepts the `wire_map` argument, which does not bring any functionality. + [(#5660)](https://github.com/PennyLaneAI/pennylane/pull/5660) + * ``qml.from_qasm_file`` has been removed. The user can open files and load their content using `qml.from_qasm`. [(#5659)](https://github.com/PennyLaneAI/pennylane/pull/5659) diff --git a/pennylane/ops/functions/is_commuting.py b/pennylane/ops/functions/is_commuting.py index 68d54aaa4ac..97367963b9a 100644 --- a/pennylane/ops/functions/is_commuting.py +++ b/pennylane/ops/functions/is_commuting.py @@ -19,41 +19,31 @@ import pennylane as qml from pennylane.ops.op_math import Prod, SProd, Sum -from pennylane.pauli.utils import _wire_map_from_pauli_pair -def _pword_is_commuting(pauli_word_1, pauli_word_2, wire_map=None): +def _pword_is_commuting(pauli_word_1, pauli_word_2): r"""Checks if two Pauli words commute. Args: - pauli_word_1 (Observable): first Pauli word in commutator - pauli_word_2 (Observable): second Pauli word in commutator - wire_map (dict[Union[str, int], int]): dictionary containing all wire labels used in - the Pauli word as keys, and unique integer labels as their values + pauli_word_1 (Operator): first Pauli word in commutator. + pauli_word_2 (Operator): second Pauli word in commutator. Returns: - bool: returns True if the input Pauli commute, False otherwise + bool: returns True if the input Pauli commute, False otherwise. **Example** - >>> wire_map = {'a' : 0, 'b' : 1, 'c' : 2} >>> pauli_word_1 = qml.prod(qml.X("a"), qml.Y("b")) >>> pauli_word_2 = qml.prod(qml.Z("a"), qml.Z("c")) - >>> _pword_is_commuting(pauli_word_1, pauli_word_2, wire_map=wire_map) + >>> _pword_is_commuting(pauli_word_1, pauli_word_2) False - >>> wire_map = {'a' : 0, 'b' : 1, 'c' : 2} >>> pauli_word_1 = qml.sum(qml.X('a') , qml.Y('b')) >>> pauli_word_2 = qml.sum(qml.Z('c') , qml.X('a')) - >>> _pword_is_commuting(pauli_word_1, pauli_word_2, wire_map=wire_map) + >>> _pword_is_commuting(pauli_word_1, pauli_word_2) True """ - if wire_map is None: - wire_map = _wire_map_from_pauli_pair(pauli_word_1, pauli_word_2) - pauli_word_1 = pauli_word_1.map_wires(wire_map) - pauli_word_2 = pauli_word_2.map_wires(wire_map) - pr1 = pauli_word_1.pauli_rep pr2 = pauli_word_2.pauli_rep @@ -146,11 +136,11 @@ def commutes_inner(op_name1, op_name2): Relies on ``commutation_map`` from the enclosing namespace of ``_create_commute_function``. Args: - op_name1 (str): name of one operation - op_name2 (str): name of the second operation + op_name1 (str): name of one operation. + op_name2 (str): name of the second operation. Returns: - Bool + bool: True if the operations commute, False otherwise. """ return op_name1 in commutation_map[op_name2] @@ -183,7 +173,7 @@ def intersection(wires1, wires2): wires2 (pennylane.wires.Wires: Second set of wires. Returns: - bool: True if the two sets of wires are not disjoint and False if disjoint. + bool: True if the two sets of wires are not disjoint and False if disjoint. """ return len(qml.wires.Wires.shared_wires([wires1, wires2])) != 0 @@ -196,7 +186,7 @@ def check_commutation_two_non_simplified_crot(operation1, operation2): operation2 (pennylane.Operation): Second operation. Returns: - Bool: True if commutation, False otherwise. + bool: True if commutation, False otherwise. """ # Two non simplified CRot target_wires_1 = qml.wires.Wires( @@ -234,7 +224,7 @@ def check_commutation_two_non_simplified_rotations(operation1, operation2): operation2 (pennylane.Operation): Second operation. Returns: - Bool: True if commutation, False otherwise, None if not two rotations. + bool: True if commutation, False otherwise, None if not two rotations. """ target_wires_1 = qml.wires.Wires( @@ -318,7 +308,7 @@ def check_commutation_two_non_simplified_rotations(operation1, operation2): ] -def is_commuting(operation1, operation2, wire_map=None): +def is_commuting(operation1, operation2): r"""Check if two operations are commuting using a lookup table. A lookup table is used to check the commutation between the @@ -339,11 +329,9 @@ def is_commuting(operation1, operation2, wire_map=None): Args: operation1 (.Operation): A first quantum operation. operation2 (.Operation): A second quantum operation. - wire_map (dict[Union[str, int], int]): dictionary for Pauli word commutation containing all - wire labels used in the Pauli word as keys, and unique integer labels as their values Returns: - bool: True if the operations commute, False otherwise. + bool: True if the operations commute, False otherwise. **Example** @@ -364,7 +352,7 @@ def is_commuting(operation1, operation2, wire_map=None): raise qml.QuantumFunctionError(f"Operation {operation2.name} not supported.") if operation1.pauli_rep is not None and operation2.pauli_rep is not None: - return _pword_is_commuting(operation1, operation2, wire_map) + return _pword_is_commuting(operation1, operation2) # operations are disjoints if not intersection(operation1.wires, operation2.wires): diff --git a/tests/ops/functions/test_is_commuting.py b/tests/ops/functions/test_is_commuting.py index 2ee3ae3c28f..7e1ecaef810 100644 --- a/tests/ops/functions/test_is_commuting.py +++ b/tests/ops/functions/test_is_commuting.py @@ -775,53 +775,47 @@ def test_barrier_u3_identity(self, wires, res): assert commutation == res @pytest.mark.parametrize( - "pauli_word_1,pauli_word_2,wire_map,commute_status", + "pauli_word_1,pauli_word_2,commute_status", [ - (qml.Identity(0), qml.PauliZ(0), {0: 0}, True), - (qml.PauliY(0), qml.PauliZ(0), {0: 0}, False), - (qml.PauliX(0), qml.PauliX(1), {0: 0, 1: 1}, True), - (qml.PauliY("x"), qml.PauliX("y"), None, True), + (qml.Identity(0), qml.PauliZ(0), True), + (qml.PauliY(0), qml.PauliZ(0), False), + (qml.PauliX(0), qml.PauliX(1), True), + (qml.PauliY("x"), qml.PauliX("y"), True), ( qml.prod(qml.PauliZ("a"), qml.PauliY("b"), qml.PauliZ("d")), qml.prod(qml.PauliX("a"), qml.PauliZ("c"), qml.PauliY("d")), - {"a": 0, "b": 1, "c": 2, "d": 3}, True, ), ( qml.prod(qml.PauliX("a"), qml.PauliY("b"), qml.PauliZ("d")), qml.prod(qml.PauliX("a"), qml.PauliZ("c"), qml.PauliY("d")), - {"a": 0, "b": 1, "c": 2, "d": 3}, False, ), ( qml.operation.Tensor(qml.PauliX("a"), qml.PauliY("b"), qml.PauliZ("d")), qml.operation.Tensor(qml.PauliX("a"), qml.PauliZ("c"), qml.PauliY("d")), - {"a": 0, "b": 1, "c": 2, "d": 3}, False, ), ( qml.sum(qml.PauliZ("a"), qml.PauliY("b"), qml.PauliZ("d")), qml.sum(qml.PauliX("a"), qml.PauliZ("c"), qml.PauliY("d")), - {"a": 0, "b": 1, "c": 2, "d": 3}, False, ), ( qml.sum(qml.PauliZ("a"), qml.PauliY("a"), qml.PauliZ("b")), qml.sum(qml.PauliX("c"), qml.PauliZ("c"), qml.PauliY("d")), - {"a": 0, "b": 0, "c": 1, "d": 1}, True, ), ( qml.sum(qml.PauliZ("a"), qml.PauliY("b"), qml.PauliZ("d")), qml.sum(qml.PauliZ("a"), qml.PauliY("c"), qml.PauliZ("d")), - {"a": 0, "b": 1, "c": 2, "d": 3}, True, ), ], ) - def test_pauli_words(self, pauli_word_1, pauli_word_2, wire_map, commute_status): + def test_pauli_words(self, pauli_word_1, pauli_word_2, commute_status): """Test that (non)-commuting Pauli words are correctly identified.""" - do_they_commute = qml.is_commuting(pauli_word_1, pauli_word_2, wire_map=wire_map) + do_they_commute = qml.is_commuting(pauli_word_1, pauli_word_2) assert do_they_commute == commute_status @pytest.mark.parametrize(