Skip to content

Commit

Permalink
Updates to v0.36 release notes - part 2 (#5573)
Browse files Browse the repository at this point in the history
**Context:**

The release notes need to be tidied in time for the 0.36 release on May
7th.

**Description of the Change:**

This is the second phase of changes to the release notes after
#5554, where aim to
finalize a polished version.

---------

Co-authored-by: Isaac De Vlugt <34751083+isaacdevlugt@users.noreply.github.com>
Co-authored-by: Diksha Dhawan <40900030+ddhawan11@users.noreply.github.com>
Co-authored-by: Isaac De Vlugt <isaacdevlugt@gmail.com>
Co-authored-by: Diego <67476785+DSGuala@users.noreply.github.com>
  • Loading branch information
5 people committed May 3, 2024
1 parent 88e87f3 commit 287cb54
Show file tree
Hide file tree
Showing 2 changed files with 487 additions and 315 deletions.
56 changes: 30 additions & 26 deletions doc/development/deprecations.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,36 @@ deprecations are listed below.
Pending deprecations
--------------------

New operator arithmetic deprecations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The v0.36 release completes the main phase of PennyLane's switchover to an updated approach for handling
arithmetic operations between operators, check out the :ref:`Updated operators <new_opmath>` page
for more details. The old system is still accessible via :func:`~.disable_new_opmath`. However, the
old system will be removed in an upcoming release and should be treated as deprecated. The following
functionality will explicitly raise a deprecation warning when used:

* ``op.ops`` and ``op.coeffs`` will be deprecated in the future. Use
:meth:`~.Operator.terms` instead.

- Added and deprecated for ``Sum`` and ``Prod`` instances in v0.35

* Accessing ``qml.ops.Hamiltonian`` is deprecated because it points to the old version of the class
that may not be compatible with the new approach to operator arithmetic. Instead, using
``qml.Hamiltonian`` is recommended because it dispatches to the :class:`~.LinearCombination` class
when the new approach to operator arithmetic is enabled. This will allow you to continue to use
``qml.Hamiltonian`` with existing code without needing to make any changes.

- Use of ``qml.ops.Hamiltonian`` is deprecated in v0.36

* Accessing terms of a tensor product (e.g., ``op = X(0) @ X(1)``) via ``op.obs`` is deprecated with new operator arithmetic.
A user should use :class:`op.operands <~.CompositeOp>` instead.

- Deprecated in v0.36

Other deprecations
~~~~~~~~~~~~~~~~~~

* PennyLane Lightning and Catalyst will no longer support ``manylinux2014`` (GLIBC 2.17) compatibile Linux operating systems, and will be migrated to ``manylinux_2_28`` (GLIBC 2.28). See `pypa/manylinux <https://github.com/pypa/manylinux>`_ for additional details.

- Last supported version of ``manylinux2014`` with v0.36
Expand All @@ -35,32 +65,6 @@ Pending deprecations
- Deprecated in v0.36
- Will be removed in v0.37

New operator arithmetic deprecations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* ``op.ops`` and ``op.coeffs`` will be deprecated in the future. Use ``op.terms()`` instead.

- Added and deprecated for ``Sum`` and ``Prod`` instances in v0.35

* Accessing ``qml.ops.Hamiltonian`` with new operator arithmetic enabled is deprecated. Using ``qml.Hamiltonian``
with new operator arithmetic enabled now returns a ``LinearCombination`` instance. Some functionality
may not work as expected, and use of the Hamiltonian class with the new operator arithmetic will not
be supported in future releases of PennyLane.

You can update your code to the new operator arithmetic by using ``qml.Hamiltonian`` instead of importing
the Hamiltonian class directly or via ``qml.ops.Hamiltonian``. When the new operator arithmetic is enabled,
``qml.Hamiltonian`` will access the new corresponding implementation.

Alternatively, to continue accessing the legacy functionality, you can use
``qml.operation.disable_new_opmath()``.

- Deprecated in v0.36

* Accessing terms of a tensor product ``op = X(0) @ X(1)`` via ``op.obs`` is deprecated with new operator arithmetic.
A user should use ``op.operands`` instead.

- Deprecated in v0.36

Completed deprecation cycles
----------------------------

Expand Down
Loading

0 comments on commit 287cb54

Please sign in to comment.