Merge branch 'master' into deprecate-BasisStatePreparation

.github/workflows/install_deps/action.yml

@@ -15,23 +15,23 @@ inputs:
  jax_version:
  description: The version of JAX to install for any job that requires JAX
  required: false
- default: 0.4.23
+ default: '0.4.28'
  install_tensorflow:
  description: Indicate if TensorFlow should be installed or not
  required: false
  default: 'true'
  tensorflow_version:
  description: The version of TensorFlow to install for any job that requires TensorFlow
  required: false
- default: 2.16.0
+ default: '2.16.0'
  install_pytorch:
  description: Indicate if PyTorch should be installed or not
  required: false
  default: 'true'
  pytorch_version:
  description: The version of PyTorch to install for any job that requires PyTorch
  required: false
- default: 2.3.0
+ default: '2.3.0'
  install_pennylane_lightning_master:
  description: Indicate if PennyLane-Lightning should be installed from the master branch
  required: false
@@ -86,7 +86,7 @@ runs:
  if: inputs.install_jax == 'true'
  env:
  JAX_VERSION: ${{ inputs.jax_version != '' && format('=={0}', inputs.jax_version) || '' }}
- run: pip install "jax${{ env.JAX_VERSION}}" "jaxlib${{ env.JAX_VERSION }}" scipy~=1.12.0
+ run: pip install "jax${{ env.JAX_VERSION}}" "jaxlib${{ env.JAX_VERSION }}"
 
  - name: Install additional PIP packages
  shell: bash

.github/workflows/interface-unit-tests.yml

@@ -379,8 +379,7 @@ jobs:
  # catalyst requires the latest version of pennylane that is about to be released.
  # Installing catalyst after pennylane to make sure that the latest catalyst is used.
  install_catalyst_nightly: true
- # using lightning master does not work for the tests with external libraries
- install_pennylane_lightning_master: false
+ install_pennylane_lightning_master: true
  pytest_coverage_flags: ${{ inputs.pytest_coverage_flags }}
  pytest_markers: external
  additional_pip_packages: pyzx matplotlib stim quimb mitiq pennylane-qiskit ply

.github/workflows/tests-gpu.yml

@@ -15,7 +15,7 @@ concurrency:
  cancel-in-progress: true
 
 env:
- TORCH_VERSION: 2.2.0
+ TORCH_VERSION: 2.3.0
 
 jobs:
  gpu-tests:

.gitignore

@@ -27,3 +27,5 @@ config.toml
 qml_debug.log
 datasets/*
 .benchmarks/*
+*.h5
+*.hdf5

Makefile

@@ -60,12 +60,10 @@ clean-docs:
 
 test:
  $(PYTHON) $(TESTRUNNER)
- $(PYTHON) $(PLUGIN_TESTRUNNER) --device=default.qubit.autograd
 
 coverage:
  @echo "Generating coverage report..."
  $(PYTHON) $(TESTRUNNER) $(COVERAGE)
- $(PYTHON) $(PLUGIN_TESTRUNNER) --device=default.qubit.autograd $(COVERAGE) --cov-append
 
 .PHONY:format
 format:

doc/code/qml_qinfo.rst

@@ -4,6 +4,13 @@ qml.qinfo
 Overview
 --------
 
+.. warning::
+
+ The ``qinfo`` module is deprecated and scheduled to be removed in v0.40. Most quantum information transforms
+ are available as measurement processes (see the :mod:`~pennylane.measurements` module for more details).
+ Additionally, the transforms are also available as standalone functions in the :mod:`~pennylane.math` and
+ :mod:`~pennylane.gradients` modules.
+
 This module provides a collection of methods to return quantum information quantities from :class:`~.QNode`
 returning :func:`~pennylane.state`.
 
@@ -15,8 +22,4 @@ Transforms
 .. automodapi:: pennylane.qinfo.transforms
  :no-heading:
  :no-inherited-members:
- :skip: metric_tensor
- :skip: adjoint_metric_tensor
  :skip: transform
- :skip: classical_fisher
- :skip: quantum_fisher

doc/development/deprecations.rst

@@ -9,33 +9,45 @@ deprecations are listed below.
 Pending deprecations
 --------------------
 
-* `QNode.gradient_fn` is deprecated. Please use `QNode.diff_method` instead. `QNode.get_gradient_fn` can also be used to
- process the diff method.
+* The ``'ancilla'`` argument for :func:`~pennylane.iterative_qpe` has been deprecated. Instead, use the ``'aux_wire'``
+ argument.
 
  - Deprecated in v0.39
  - Will be removed in v0.40
 
-* All of the legacy devices (any with the name ``default.qubit.{autograd,torch,tf,jax,legacy}``) are deprecated. Use ``default.qubit`` instead,
- as it supports backpropagation for the many backends the legacy devices support.
+* The ``qml.shadows.shadow_expval`` transform has been deprecated. Instead, please use the
+ ``qml.shadow_expval`` measurement process.
 
- - Deprecated in v0.38
- - Will be removed in v0.39
+ - Deprecated in v0.39
+ - Will be removed in v0.40
 
-* The logic for internally switching a device for a different backpropagation
- compatible device is now deprecated, as it was in place for the deprecated ``default.qubit.legacy``.
+* ``qml.broadcast`` has been deprecated. Users should use ``for`` loops instead.
 
- - Deprecated in v0.38
- - Will be removed in v0.39 
+ - Deprecated in v0.39
+ - Will be removed in v0.40
 
-* The ``decomp_depth`` argument in ``qml.device`` is deprecated. 
+* The ``qml.qinfo`` module has been deprecated. Please see the respective functions in the ``qml.math`` and ``qml.measurements``
+ modules instead.
 
- - Deprecated in v0.38
- - Will be removed in v0.39
+ - Deprecated in v0.39
+ - Will be removed in v0.40
 
-* The functions ``qml.qinfo.classical_fisher`` and ``qml.qinfo.quantum_fisher`` are deprecated since they are being migrated
- to the ``qml.gradients`` module. Therefore, ``qml.gradients.classical_fisher`` and ``qml.gradients.quantum_fisher`` should be used instead.
+* ``Device``, ``QubitDevice``, and ``QutritDevice`` will no longer be imported top level in v0.40. They instead
+ we be available as ``qml.devices.LegacyDevice``, ``qml.devices.QubitDevice``, and ``qml.devices.QutritDevice``
+ respectively.
 
- - Deprecated and Duplicated in v0.38
+ - Deprecated top level access in v0.39
+ - Top level access will be removed in v0.40
+
+* ``QNode.gradient_fn`` is deprecated. Please use ``QNode.diff_method`` instead. ``QNode.get_gradient_fn`` can also be used to
+ process the diff method.
+
+ - Deprecated in v0.39
+ - Will be removed in v0.40
+
+* The ``decomp_depth`` argument in ``qml.device`` is deprecated. 
+
+ - Deprecated in v0.38
  - Will be removed in v0.39
 
 * The ``simplify`` argument in ``qml.Hamiltonian`` and ``qml.ops.LinearCombination`` is deprecated. 
@@ -47,6 +59,9 @@ Pending deprecations
 * The :class:`~pennylane.BasisStatePreparation` template is deprecated.
  Instead, use :class:`~pennylane.BasisState`.
 
+* The ``QubitStateVector`` template is deprecated.
+ Instead, use ``StatePrep``.
+
  - Deprecated in v0.39
  - Will be removed in v0.40
 
@@ -94,6 +109,24 @@ Other deprecations
 Completed deprecation cycles
 ----------------------------
 
+* The functions ``qml.qinfo.classical_fisher`` and ``qml.qinfo.quantum_fisher`` have been removed and migrated to the ``qml.gradients``
+ module. Therefore, ``qml.gradients.classical_fisher`` and ``qml.gradients.quantum_fisher`` should be used instead.
+
+ - Deprecated in v0.38
+ - Removed in v0.39
+
+* All of the legacy devices (any with the name ``default.qubit.{autograd,torch,tf,jax,legacy}``) are removed. Use ``default.qubit`` instead,
+ as it supports backpropagation for the many backends the legacy devices support.
+
+ - Deprecated in v0.38
+ - Removed in v0.39
+
+* The logic for internally switching a device for a different backpropagation
+ compatible device is removed, as it was in place for removed ``default.qubit.legacy``.
+
+ - Deprecated in v0.38
+ - Removed in v0.39
+
 * `Operator.expand` is now removed. Use `qml.tape.QuantumScript(op.deocomposition())` instead.
 
  - Deprecated in v0.38

doc/releases/changelog-dev.md

@@ -6,28 +6,32 @@
 
 <h3>Improvements 🛠</h3>
 
+* PennyLane is now compatible with NumPy 2.0.
+ [(#6061)](https://github.com/PennyLaneAI/pennylane/pull/6061)
+ [(#6258)](https://github.com/PennyLaneAI/pennylane/pull/6258)
+
+* PennyLane is now compatible with Jax 0.4.28.
+ [(#6255)](https://github.com/PennyLaneAI/pennylane/pull/6255)
+
 * `qml.qchem.excitations` now optionally returns fermionic operators.
-  [(#6171)](https://github.com/PennyLaneAI/pennylane/pull/6171)
+ [(#6171)](https://github.com/PennyLaneAI/pennylane/pull/6171)
 
 * The `diagonalize_measurements` transform now uses a more efficient method of diagonalization 
  when possible, based on the `pauli_rep` of the relevant observables.
  [#6113](https://github.com/PennyLaneAI/pennylane/pull/6113/)
 
-<h4>Capturing and representing hybrid programs</h4>
-
-* Differentiation of hybrid programs via `qml.grad` can now be captured into plxpr.
- When evaluating a captured `qml.grad` instruction, it will dispatch to `jax.grad`,
- which differs from the Autograd implementation of `qml.grad` itself.
- [(#6120)](https://github.com/PennyLaneAI/pennylane/pull/6120)
+* The `Hermitian` operator now has a `compute_sparse_matrix` implementation.
+ [(#6225)](https://github.com/PennyLaneAI/pennylane/pull/6225)
 
 <h4>Capturing and representing hybrid programs</h4>
 
 * Differentiation of hybrid programs via `qml.grad` and `qml.jacobian` can now be captured
  into plxpr. When evaluating a captured `qml.grad` (`qml.jacobian`) instruction, it will
  dispatch to `jax.grad` (`jax.jacobian`), which differs from the Autograd implementation
- without capture.
+ without capture. Pytree inputs and outputs are supported.
  [(#6120)](https://github.com/PennyLaneAI/pennylane/pull/6120)
  [(#6127)](https://github.com/PennyLaneAI/pennylane/pull/6127)
+ [(#6134)](https://github.com/PennyLaneAI/pennylane/pull/6134)
 
 * Improve unit testing for capturing of nested control flows.
  [(#6111)](https://github.com/PennyLaneAI/pennylane/pull/6111)
@@ -50,19 +54,28 @@
  unique representation of the object.
  [(#6167)](https://github.com/PennyLaneAI/pennylane/pull/6167)
 
+* A `ReferenceQubit` is introduced for testing purposes and as a reference for future plugin development.
+ [(#6181)](https://github.com/PennyLaneAI/pennylane/pull/6181)
+
 * The `to_mat` methods for `FermiWord` and `FermiSentence` now optionally return
  a sparse matrix.
  [(#6173)](https://github.com/PennyLaneAI/pennylane/pull/6173)
 
 <h3>Breaking changes 💔</h3>
 
+* The functions `qml.qinfo.classical_fisher` and `qml.qinfo.quantum_fisher` have been removed and migrated to the `qml.gradients`
+ module. Therefore, `qml.gradients.classical_fisher` and `qml.gradients.quantum_fisher` should be used instead.
+ [(#5911)](https://github.com/PennyLaneAI/pennylane/pull/5911)
+
 * Remove support for Python 3.9.
  [(#6223)](https://github.com/PennyLaneAI/pennylane/pull/6223)
 
-* `DefaultQubitTF`, `DefaultQubitTorch`, and `DefaultQubitJax` are removed. Please use `default.qubit` for all interfaces.
+* `DefaultQubitTF`, `DefaultQubitTorch`, `DefaultQubitJax`, and `DefaultQubitAutograd` are removed.
+ Please use `default.qubit` for all interfaces.
  [(#6207)](https://github.com/PennyLaneAI/pennylane/pull/6207)
  [(#6208)](https://github.com/PennyLaneAI/pennylane/pull/6208)
  [(#6209)](https://github.com/PennyLaneAI/pennylane/pull/6209)
+ [(#6210)](https://github.com/PennyLaneAI/pennylane/pull/6210)
 
 * `expand_fn`, `max_expansion`, `override_shots`, and `device_batch_transform` are removed from the
  signature of `qml.execute`.
@@ -81,12 +94,35 @@
 * `Operator.expand` is now removed. Use `qml.tape.QuantumScript(op.deocomposition())` instead.
  [(#6227)](https://github.com/PennyLaneAI/pennylane/pull/6227)
 
+
 <h3>Deprecations 👋</h3>
 
 * The `qml.BasisStatePreparation` template is deprecated.
  Instead, use `qml.BasisState`.
  [(#6021)](https://github.com/PennyLaneAI/pennylane/pull/6021)
 
+* The `'ancilla'` argument for `qml.iterative_qpe` has been deprecated. Instead, use the `'aux_wire'` argument.
+ [(#6277)](https://github.com/PennyLaneAI/pennylane/pull/6277)
+
+* `qml.shadows.shadow_expval` has been deprecated. Instead, use the `qml.shadow_expval` measurement
+ process.
+ [(#6277)](https://github.com/PennyLaneAI/pennylane/pull/6277)
+
+* `qml.broadcast` has been deprecated. Please use `for` loops instead.
+ [(#6277)](https://github.com/PennyLaneAI/pennylane/pull/6277)
+
+* The `qml.QubitStateVector` template is deprecated. Instead, use `qml.StatePrep`.
+ [(#6172)](https://github.com/PennyLaneAI/pennylane/pull/6172)
+
+* The `qml.qinfo` module has been deprecated. Please see the respective functions in the `qml.math` and
+ `qml.measurements` modules instead.
+ [(#5911)](https://github.com/PennyLaneAI/pennylane/pull/5911)
+
+* `Device`, `QubitDevice`, and `QutritDevice` will no longer be accessible via top-level import in v0.40.
+ They will still be accessible as `qml.devices.LegacyDevice`, `qml.devices.QubitDevice`, and `qml.devices.QutritDevice`
+ respectively.
+ [(#6238)](https://github.com/PennyLaneAI/pennylane/pull/6238/)
+
 * `QNode.gradient_fn` is deprecated. Please use `QNode.diff_method` and `QNode.get_gradient_fn` instead.
  [(#6244)](https://github.com/PennyLaneAI/pennylane/pull/6244)
 
@@ -97,29 +133,40 @@
 * Fix a bug where zero-valued JVPs were calculated wrongly in the presence of shot vectors.
  [(#6219)](https://github.com/PennyLaneAI/pennylane/pull/6219)
 
-* Fix `qml.PrepSelPrep` template to work with `torch`:
+* Fix `qml.PrepSelPrep` template to work with `torch`.
  [(#6191)](https://github.com/PennyLaneAI/pennylane/pull/6191)
 
 * Now `qml.equal` compares correctly `qml.PrepSelPrep` operators.
  [(#6182)](https://github.com/PennyLaneAI/pennylane/pull/6182)
 
-* The ``qml.QSVT`` template now orders the ``projector`` wires first and the ``UA`` wires second, which is the expected order of the decomposition.
+* The `qml.QSVT` template now orders the `projector` wires first and the `UA` wires second, which is the expected order of the decomposition.
  [(#6212)](https://github.com/PennyLaneAI/pennylane/pull/6212)
 
-* The ``qml.Qubitization`` template now orders the ``control`` wires first and the ``hamiltonian`` wires second, which is the expected according to other templates.
+* The `qml.Qubitization` template now orders the `control` wires first and the `hamiltonian` wires second, which is the expected according to other templates.
  [(#6229)](https://github.com/PennyLaneAI/pennylane/pull/6229)
 
-* The ``qml.FABLE`` template now returns the correct value when JIT is enabled.
+* The `qml.FABLE` template now returns the correct value when JIT is enabled.
  [(#6263)](https://github.com/PennyLaneAI/pennylane/pull/6263)
 
-* <h3>Contributors ✍️</h3>
+* Fixes a bug where a circuit using the `autograd` interface sometimes returns nested values that are not of the `autograd` interface.
+ [(#6225)](https://github.com/PennyLaneAI/pennylane/pull/6225)
+
+* Fixes a bug where a simple circuit with no parameters or only builtin/numpy arrays as parameters returns autograd tensors.
+ [(#6225)](https://github.com/PennyLaneAI/pennylane/pull/6225)
+
+<h3>Contributors ✍️</h3>
 
 This release contains contributions from (in alphabetical order):
 
 Guillermo Alonso,
 Utkarsh Azad,
+Astral Cai,
+Isaac De Vlugt,
 Lillian M. A. Frederiksen,
+Pietropaolo Frisoni,
+Emiliano Godinez,
 Christina Lee,
 William Maxwell,
 Lee J. O'Riordan,
+Mudit Pandey,
 David Wierichs,

pennylane/__init__.py

@@ -16,8 +16,6 @@
 PennyLane can be directly imported.
 """
 
-import numpy as _np
-
 
 from pennylane.boolean_fn import BooleanFn
 import pennylane.numpy
@@ -180,13 +178,30 @@ def __getattr__(name):
  if name == "plugin_devices":
  return pennylane.devices.device_constructor.plugin_devices
 
+ from warnings import warn # pylint: disable=import-outside-toplevel
+
  if name == "QubitDevice":
+ warn(
+ "QubitDevice will no longer be accessible top level. Please access "
+ " the class as pennylane.devices.QubitDevice",
+ PennyLaneDeprecationWarning,
+ )
  return pennylane.devices._qubit_device.QubitDevice # pylint:disable=protected-access
 
  if name == "QutritDevice":
+ warn(
+ "QutritDevice will no longer be accessible top level. Please access "
+ " the class as pennylane.devices.QutritDevice",
+ PennyLaneDeprecationWarning,
+ )
  return pennylane.devices._qutrit_device.QutritDevice # pylint:disable=protected-access
 
  if name == "Device":
+ warn(
+ "Device will no longer be accessible top level. Please access "
+ " the class as pennylane.devices.LegacyDevice",
+ PennyLaneDeprecationWarning,
+ )
  return pennylane.devices._legacy_device.Device # pylint:disable=protected-access
 
  raise AttributeError(f"module 'pennylane' has no attribute '{name}'")