Merge v0.39.0_rc to master

.github/workflows/compat-docker-release.yml

@@ -14,7 +14,7 @@ jobs:
     name: Docker release - Linux::x86_64
     uses: ./.github/workflows/docker_linux_x86_64.yml
     with:
-      lightning-version: v0.38.0_rc
-      pennylane-version: v0.38.0-rc0
+      lightning-version: v0.39.0_rc
+      pennylane-version: v0.39.0-rc0
       push-to-dockerhub: false
     secrets: inherit # pass all secrets

.github/workflows/tests_gpu_python.yml

@@ -206,6 +206,19 @@ jobs:
         run: |
           DEVICENAME=`echo ${{ matrix.pl_backend }} | sed "s/_/./g"`
           PL_DEVICE=${DEVICENAME} python -m pytest tests/ $COVERAGE_FLAGS
+
+      - name: Test wheels for Lightning-GPU
+        if : matrix.pl_backend == 'lightning_gpu'
+        run: |
+          python -m pip install -r requirements-dev.txt
+          PL_BACKEND=lightning_qubit python scripts/configure_pyproject_toml.py
+          SKIP_COMPILATION=True python -m pip install . -vv
+
+          DEVICENAME=`echo ${{ matrix.pl_backend }} | sed "s/_/./g"`
+          PL_BACKEND=${DEVICENAME} python scripts/configure_pyproject_toml.py
+          python -m build
+          python -m pip install dist/*.whl --force-reinstall --no-deps
+          PL_DEVICE=${DEVICENAME} python -m pytest tests/test_device.py $COVERAGE_FLAGS
 
       - name: Move coverage file
         run: |

.github/workflows/tests_lkcpu_python.yml

@@ -256,6 +256,17 @@ jobs:
           pl-device-test --device ${DEVICENAME} --shots=None --skip-ops $COVERAGE_FLAGS --cov-append
           mv .coverage ${{ github.workspace }}/.coverage-${{ github.job }}-${{ matrix.pl_backend }}-${{ matrix.group }}
 
+      - name: Test editable install
+        run: |
+          rm -r build
+          pip uninstall pennylane-lightning pennylane-lightning-kokkos -y
+          python scripts/configure_pyproject_toml.py
+          SKIP_COMPILATION=True python -m pip install -e . --config-settings editable_mode=compat
+          DEVICENAME=`echo ${{ matrix.pl_backend }} | sed "s/_/./g"`
+          PL_BACKEND=${DEVICENAME} python scripts/configure_pyproject_toml.py
+          python -m pip install -e . --config-settings editable_mode=compat -vv
+          PL_DEVICE=${DEVICENAME} python -m pytest tests/test_device.py $COVERAGE_FLAGS
+
       - name: Upload test durations
         uses: actions/upload-artifact@v4
         with:

.github/workflows/wheel_macos_arm64.yml

@@ -23,7 +23,7 @@ env:
   ARCHS: 'arm64'
   PYTHON3_MIN_VERSION: "10"
   PYTHON3_MAX_VERSION: "12"
-  MACOSX_DEPLOYMENT_TARGET: 12.0
+  MACOSX_DEPLOYMENT_TARGET: 13.0
 
 concurrency:
   group: wheel_macos_arm64-${{ github.ref }}
@@ -63,7 +63,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [macos-12]
+        os: [macos-13]
         arch: [arm64]
         pl_backend: ["lightning_kokkos", "lightning_qubit"]
         cibw_build: ${{fromJson(needs.mac-set-matrix-arm.outputs.python_version)}}

.github/workflows/wheel_macos_x86_64.yml

@@ -20,7 +20,7 @@ on:
   workflow_dispatch:
 
 env:
-  MACOSX_DEPLOYMENT_TARGET: 12.0
+  MACOSX_DEPLOYMENT_TARGET: 13.0
 
 concurrency:
   group: wheel_macos_x86_64-${{ github.ref }}
@@ -40,7 +40,7 @@ jobs:
     needs: [set_wheel_build_matrix]
     strategy:
       matrix:
-        os: [macos-12]
+        os: [macos-13]
         arch: [x86_64]
         exec_model: ${{ fromJson(needs.set_wheel_build_matrix.outputs.exec_model) }}
         kokkos_version: ${{ fromJson(needs.set_wheel_build_matrix.outputs.kokkos_version) }}
@@ -97,7 +97,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [macos-12]
+        os: [macos-13]
         arch: [x86_64]
         pl_backend: ["lightning_kokkos", "lightning_qubit"]
         cibw_build: ${{fromJson(needs.set_wheel_build_matrix.outputs.python_version)}}

README.rst

@@ -383,8 +383,20 @@ Lightning-Tensor requires CUDA 12 and the `cuQuantum SDK <https://developer.nvid
 The SDK may be installed within the Python environment ``site-packages`` directory using ``pip`` or ``conda`` or the SDK library path appended to the ``LD_LIBRARY_PATH`` environment variable.
 Please see the `cuQuantum SDK <https://developer.nvidia.com/cuquantum-sdk>`_ install guide for more information.
 
+Lightning-Tensor and ``cutensornet-cu12`` can be installed via:
+
+.. code-block:: bash
+
+    pip install cutensornet-cu12
+    pip install pennylane-lightning-tensor
+
 Install Lightning-Tensor from source
 ====================================
+
+.. note::
+
+    The below contains instructions for installing Lightning-Tensor ***from source***. For most cases, *this is not required* and one can simply use the installation instructions at `pennylane.ai/install <https://pennylane.ai/install/#high-performance-computing-and-gpus>`__. If those instructions do not work for you, or you have a more complex build environment that requires building from source, then consider reading on.
+
 Lightning-Qubit should be installed before Lightning-Tensor (compilation is not necessary):
 
 .. code-block:: bash

cmake/support_catalyst.cmake

@@ -0,0 +1,74 @@
+###############################################################################################
+# This file provides macros to process Catalyst.
+###############################################################################################
+
+# Include this only once
+include_guard()
+
+macro(FindCatalyst target_name)
+    if(LIGHTNING_CATALYST_SRC_PATH)
+        if(NOT IS_ABSOLUTE ${LIGHTNING_CATALYST_SRC_PATH})
+            message(FATAL_ERROR " LIGHTNING_CATALYST_SRC_PATH=${LIGHTNING_CATALYST_SRC_PATH} must be set to an absolute path")
+        endif()
+        if(CATALYST_GIT_TAG)
+            message(WARN " Setting `LIGHTNING_CATALYST_SRC_PATH=${LIGHTNING_CATALYST_SRC_PATH}` overrides `CATALYST_GIT_TAG=${CATALYST_GIT_TAG}`")
+        endif()
+
+        # Acquire local git hash and use for CATALYST_GIT_TAG
+        execute_process(COMMAND git rev-parse --short HEAD
+            WORKING_DIRECTORY ${LIGHTNING_CATALYST_SRC_PATH}
+            OUTPUT_VARIABLE CATALYST_GIT_TAG
+        )
+        message(INFO " Building against local Catalyst - path: ${LIGHTNING_CATALYST_SRC_PATH} - GIT TAG: ${CATALYST_GIT_TAG}")
+
+        target_include_directories(${target_name} PUBLIC ${LIGHTNING_CATALYST_SRC_PATH}/runtime/lib/backend/common)
+        target_include_directories(${target_name} PUBLIC ${LIGHTNING_CATALYST_SRC_PATH}/runtime/include)
+
+    else()
+        if(NOT CATALYST_GIT_TAG)
+            set(CATALYST_GIT_TAG "main" CACHE STRING "GIT_TAG value to build Catalyst")
+        endif()
+        message(INFO " Building against Catalyst GIT TAG ${CATALYST_GIT_TAG}")
+
+        # Fetching /lib/backend/common hpp headers
+        set(LIB_BACKEND_COMMON_HEADERS  CacheManager.hpp
+                                    QubitManager.hpp
+                                    Utils.hpp
+        )
+
+        foreach(HEADER ${LIB_BACKEND_COMMON_HEADERS})
+            string(REGEX REPLACE "\\.[^.]*$" "" HEADER_NAME ${HEADER})
+            FetchContent_Declare(
+                ${HEADER_NAME}
+                URL                 https://raw.githubusercontent.com/PennyLaneAI/catalyst/${CATALYST_GIT_TAG}/runtime/lib/backend/common/${HEADER}
+                DOWNLOAD_NO_EXTRACT True
+                SOURCE_DIR          include
+            )
+
+            FetchContent_MakeAvailable(${HEADER_NAME})
+        endforeach()
+
+        # Fetching include hpp headers
+        set(INCLUDE_HEADERS DataView.hpp
+                        Exception.hpp
+                        QuantumDevice.hpp
+                        RuntimeCAPI.h
+                        Types.h
+        )
+
+        foreach(HEADER ${INCLUDE_HEADERS})
+            string(REGEX REPLACE "\\.[^.]*$" "" HEADER_NAME ${HEADER})
+            FetchContent_Declare(
+                ${HEADER_NAME}
+                URL                 https://raw.githubusercontent.com/PennyLaneAI/catalyst/${CATALYST_GIT_TAG}/runtime/include/${HEADER}
+                DOWNLOAD_NO_EXTRACT True
+                SOURCE_DIR          include
+            )
+
+            FetchContent_MakeAvailable(${HEADER_NAME})
+        endforeach()
+
+        target_include_directories(${target_name} PUBLIC ${CMAKE_CURRENT_BINARY_DIR}/include)
+
+    endif()
+endmacro()

doc/lightning_tensor/device.rst

@@ -53,6 +53,9 @@ Check out the :doc:`/lightning_tensor/installation` guide for more information.
 
 .. seealso:: `DefaultTensor <https://docs.pennylane.ai/en/latest/code/api/pennylane.devices.default_tensor.DefaultTensor.html>`__ for a CPU only tensor network simulator device.
 
+Note that as ``lightning.tensor`` cannot be cleaned up like other state-vector devices because the data is attached to the graph. It is recommended to create a new ``lightning.tensor`` device per circuit to ensure resources are correctly handled.
+
+
 Operations and observables support
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

pennylane_lightning/core/_version.py

@@ -16,4 +16,4 @@
    Version number (major.minor.patch[-label])
 """
 
-__version__ = "0.39.0-dev52"
+__version__ = "0.40.0-dev0"

pennylane_lightning/core/lightning_base.py

@@ -50,7 +50,7 @@
             OpenMP.
     """
 
-    pennylane_requires = ">=0.37"
+    pennylane_requires = ">=0.38"
     version = __version__
     author = "Xanadu Inc."
     short_name = "lightning.base"

pennylane_lightning/core/src/simulators/lightning_gpu/CMakeLists.txt

@@ -74,6 +74,7 @@ endif()
 ###############################################################################
 set(COMPONENT_SUBDIRS      algorithms
                            bindings
+                           catalyst
                            measurements
                            gates
                            observables

pennylane_lightning/core/src/simulators/lightning_gpu/catalyst/CMakeLists.txt

@@ -0,0 +1,22 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(lightning_gpu_catalyst LANGUAGES CXX)
+
+set(LGPU_CATALYST_FILES LightningGPUSimulator.cpp CACHE INTERNAL "")
+add_library(lightning_gpu_catalyst SHARED ${LGPU_CATALYST_FILES})
+
+include(FetchContent)
+
+include("${pennylane_lightning_SOURCE_DIR}/cmake/support_catalyst.cmake")
+FindCatalyst(lightning_gpu_catalyst)
+
+target_include_directories(lightning_gpu_catalyst INTERFACE  ${CMAKE_CURRENT_SOURCE_DIR})
+target_link_libraries(lightning_gpu_catalyst PUBLIC  lightning_compile_options
+                                                        lightning_gpu_algorithms
+                                                        lightning_gpu_measurements
+)
+
+if (BUILD_TESTS)
+    enable_testing()
+    add_subdirectory("tests")
+endif()