Release v0.20.0

.flake8

@@ -15,4 +15,5 @@ per-file-ignores =
   tests/*: D100, D101, D102, D103
   __init__.py: F401
   pulser-core/pulser/backends.py: F401
+  pulser-core/pulser/math/__init__.py: D103
   setup.py: D100

.github/workflows/ci.yml

@@ -59,6 +59,7 @@ jobs:
       fail-fast: false
       matrix:
         python-version: ["3.8", "3.12"]
+        with-torch: ["with-torch", "no-torch"]
     steps:
       - name: Check out Pulser
         uses: actions/checkout@v4
@@ -67,9 +68,14 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           extra-packages: pytest
+          with-torch: ${{ matrix.with-torch }}
       - name: Run the unit tests & generate coverage report
+        if: ${{ matrix.with-torch == 'with-torch' }}
         run: pytest --cov --cov-fail-under=100
+      - name: Run the unit tests without torch installed
+        if: ${{ matrix.with-torch != 'with-torch' }}
+        run: pytest --cov
       - name: Test validation with legacy jsonschema
         run: |
           pip install jsonschema==4.17.3
-          pytest tests/test_abstract_repr.py
+          pytest tests/test_abstract_repr.py -W ignore::DeprecationWarning

.github/workflows/pulser-setup/action.yml

@@ -9,6 +9,10 @@ inputs:
     description: Extra packages to install (give to grep)
     required: false
     default: ""
+  with-torch:
+    description: Whether to include pytorch
+    required: false
+    default: "with-torch"
 runs:
   using: "composite"
   steps:
@@ -17,11 +21,18 @@ runs:
       with:
         python-version: ${{ inputs.python-version }}
         cache: "pip"
-    - name: Install Pulser
+    - name: Install Pulser (with torch)
+      if: ${{ inputs.with-torch == 'with-torch' }}
       shell: bash
       run: |
         python -m pip install --upgrade pip
         make dev-install
+    - name: Install Pulser (without torch)
+      if: ${{ inputs.with-torch != 'with-torch' }} 
+      shell: bash
+      run: |
+        python -m pip install --upgrade pip
+        make dev-install-no-torch
     - name: Install extra packages from the dev requirements
       if: "${{ inputs.extra-packages != '' }}"
       shell: bash

.github/workflows/test.yml

@@ -18,6 +18,7 @@ jobs:
         # Python 3.8 and 3.9 does not run on macos-latest (14)
         # Uses macos-13 for 3.8 and 3.9 and macos-latest for >=3.10 
         os: [ubuntu-latest, macos-13, macos-latest, windows-latest]
+        with-torch: ["with-torch", "no-torch"]
         python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
         exclude:
           - os: macos-latest
@@ -38,5 +39,6 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           extra-packages: pytest
+          with-torch: ${{ matrix.with-torch }}
       - name: Run the unit tests & generate coverage report
-        run: pytest --cov --cov-fail-under=100
+        run: pytest --cov

.gitignore

@@ -17,3 +17,4 @@ dist/
 env*
 *.egg-info/
 __venv__/
+venv

Makefile

@@ -1,8 +1,15 @@
 .PHONY: dev-install
 dev-install: dev-install-core dev-install-simulation dev-install-pasqal
 
+.PHONY: dev-install-no-torch
+dev-install-no-torch: dev-install-core-no-torch dev-install-simulation dev-install-pasqal
+
 .PHONY: dev-install-core
 dev-install-core:
+	pip install -e ./pulser-core[torch]
+
+.PHONY: dev-install-core-no-torch
+dev-install-core-no-torch:
 	pip install -e ./pulser-core
 
 .PHONY: dev-install-simulation

README.md

@@ -39,6 +39,24 @@ If you wish to install only the core ``pulser`` features, you can instead run:
 pip install pulser-core
 ```
 
+### Including PyTorch
+
+To include PyTorch in your installation, append the ``[torch]`` suffix to the commands outlined above, i.e.
+
+```bash
+pip install pulser[torch]
+```
+
+for the standard ``pulser`` distribution with PyTorch, **or**
+
+```bash
+pip install pulser-core[torch]
+```
+
+for just the core features plus PyTorch support.
+
+### Development install
+
 If you wish to **install the development version of Pulser from source** instead, do the following from within this repository after cloning it:
 
 ```bash

VERSION.txt

@@ -1 +1 @@
-0.19.0
+0.20.0

pulser-core/pulser/backend/qpu.py

@@ -65,10 +65,7 @@ def run(
         self.validate_job_params(
             job_params or [], self._sequence.device.max_runs
         )
-        results = self._connection.submit(
-            self._sequence, job_params=job_params, wait=wait
-        )
-        return cast(RemoteResults, results)
+        return cast(RemoteResults, super().run(job_params, wait))
 
     @staticmethod
     def validate_job_params(