qadence 1.5.1__tar.gz → 1.6.0__tar.gz

{qadence-1.5.1 → qadence-1.6.0}/.pre-commit-config.yaml

@@ -20,9 +20,10 @@ repos:
       - id: black
 
 -   repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.7.0
+    rev: v1.9.0
     hooks:
       - id: mypy
+        args: [--install-types, --non-interactive]
         exclude: examples|docs
 
 -   repo: https://github.com/DanielNoord/pydocstringformatter

{qadence-1.5.1 → qadence-1.6.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.3
 Name: qadence
-Version: 1.5.1
+Version: 1.6.0
 Summary: Pasqal interface for circuit-based quantum computing SDKs
-Author-email: Aleksander Wennersteen <aleksander.wennersteen@pasqal.com>, Gert-Jan Both <gert-jan.both@pasqal.com>, Niklas Heim <niklas.heim@pasqal.com>, Mario Dagrada <mario.dagrada@pasqal.com>, Vincent Elfving <vincent.elfving@pasqal.com>, Dominik Seitz <dominik.seitz@pasqal.com>, Roland Guichard <roland.guichard@pasqal.com>, "Joao P. Moutinho" <joao.moutinho@pasqal.com>, Vytautas Abramavicius <vytautas.abramavicius@pasqal.com>, Gergana Velikova <gergana.velikova@pasqal.com>
+Author-email: Aleksander Wennersteen <aleksander.wennersteen@pasqal.com>, Gert-Jan Both <gert-jan.both@pasqal.com>, Niklas Heim <niklas.heim@pasqal.com>, Mario Dagrada <mario.dagrada@pasqal.com>, Vincent Elfving <vincent.elfving@pasqal.com>, Dominik Seitz <dominik.seitz@pasqal.com>, Roland Guichard <roland.guichard@pasqal.com>, "Joao P. Moutinho" <joao.moutinho@pasqal.com>, Vytautas Abramavicius <vytautas.abramavicius@pasqal.com>, Gergana Velikova <gergana.velikova@pasqal.com>, Eduardo Maschio <eduardo.maschio@pasqal.com>
 License: Apache 2.0
 License-File: LICENSE
 Classifier: License :: OSI Approved :: Apache Software License
@@ -11,29 +11,37 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: <3.13,>=3.9
+Requires-Python: >=3.9
+Requires-Dist: arpeggio==2.0.2
 Requires-Dist: deepdiff
 Requires-Dist: jsonschema
 Requires-Dist: matplotlib
 Requires-Dist: nevergrad
 Requires-Dist: numpy
 Requires-Dist: openfermion
-Requires-Dist: pyqtorch==1.1.0
+Requires-Dist: pyqtorch==1.1.2
+Requires-Dist: pyyaml
 Requires-Dist: rich
 Requires-Dist: scipy
 Requires-Dist: sympytorch>=0.1.2
 Requires-Dist: tensorboard>=2.12.0
 Requires-Dist: torch
 Provides-Extra: all
-Requires-Dist: amazon-braket-sdk; extra == 'all'
+Requires-Dist: amazon-braket-sdk<1.71.2; extra == 'all'
 Requires-Dist: graphviz; extra == 'all'
 Requires-Dist: libs; extra == 'all'
+Requires-Dist: pasqal-cloud==0.8.1; extra == 'all'
 Requires-Dist: protocols; extra == 'all'
-Requires-Dist: pulser>=0.15.2; extra == 'all'
+Requires-Dist: pulser-core==0.18.0; extra == 'all'
+Requires-Dist: pulser-simulation==0.18.0; extra == 'all'
 Provides-Extra: braket
-Requires-Dist: amazon-braket-sdk==1.71.0; extra == 'braket'
+Requires-Dist: amazon-braket-sdk<1.71.2; extra == 'braket'
+Provides-Extra: dlprof
+Requires-Dist: nvidia-dlprof[pytorch]; extra == 'dlprof'
+Requires-Dist: nvidia-pyindex; extra == 'dlprof'
 Provides-Extra: horqrux
 Requires-Dist: einops; extra == 'horqrux'
 Requires-Dist: flax; extra == 'horqrux'
@@ -47,25 +55,28 @@ Requires-Dist: qadence-libs; extra == 'libs'
 Provides-Extra: protocols
 Requires-Dist: qadence-protocols; extra == 'protocols'
 Provides-Extra: pulser
-Requires-Dist: pasqal-cloud>=0.3.5; extra == 'pulser'
-Requires-Dist: pulser>=v0.15.2; extra == 'pulser'
+Requires-Dist: pasqal-cloud==0.8.1; extra == 'pulser'
+Requires-Dist: pulser-core==0.18.0; extra == 'pulser'
+Requires-Dist: pulser-simulation==0.18.0; extra == 'pulser'
 Provides-Extra: visualization
 Requires-Dist: graphviz; extra == 'visualization'
 Description-Content-Type: text/markdown
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/logo/qadence_logo_white.svg">
-  <source media="(prefers-color-scheme: light)" srcset="./docs/assets/logo/qadence_logo.svg">
-  <img alt="Qadence logo" src="./docs/assets/logo/qadence_logo.svg">
-</picture>
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/extras/assets/logo/qadence_logo_white.svg" width="75%">
+    <source media="(prefers-color-scheme: light)" srcset="./docs/extras/assets/logo/qadence_logo.svg" width="75%">
+    <img alt="Qadence logo" src="./docs/assets/logo/qadence_logo.svg" width="75%">
+  </picture>
+</p>
+
+**Qadence** is a Python package that provides a simple interface to build **digital-analog quantum
+programs** with tunable qubit interactions and arbitrary register topologies realizable on neutral atom devices.
 
 **For a high-level overview of Qadence features, [check out our white paper](https://arxiv.org/abs/2401.09915).**
 
 **For more detailed information, [check out the documentation](https://pasqal-io.github.io/qadence/latest/).**
 
-**Qadence** is a Python package that provides a simple interface to build _**digital-analog quantum
-programs**_ with tunable qubit interaction defined on _**arbitrary register topologies**_ realizable on neutral atom devices.
-
 [![Linting](https://github.com/pasqal-io/qadence/actions/workflows/lint.yml/badge.svg)](https://github.com/pasqal-io/qadence/actions/workflows/lint.yml)
 [![Tests](https://github.com/pasqal-io/qadence/actions/workflows/test_fast.yml/badge.svg)](https://github.com/pasqal-io/qadence/actions/workflows/test_fast.yml)
 [![Documentation](https://github.com/pasqal-io/qadence/actions/workflows/build_docs.yml/badge.svg)](https://pasqal-io.github.io/qadence/latest)
@@ -74,27 +85,26 @@ programs**_ with tunable qubit interaction defined on _**arbitrary register topo
 
 ## Feature highlights
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/qadence_arch.svg">
-  <source media="(prefers-color-scheme: light)" srcset="./docs/assets/qadence_arch.svg">
-  <img alt="Qadence architecture" src="./docs/assets/qadence_arch.svg">
-</picture>
-
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/extras/assets/qadence_arch.svg" width="75%">
+    <source media="(prefers-color-scheme: light)" srcset="./docs/extras/assets/qadence_arch.svg" width="75%">
+    <img alt="Qadence architecture" src="./docs/assets/qadence_arch.svg" width="75%">
+  </picture>
+<p align="center">
 
-* A [block-based system](docs/tutorials/getting_started.md) for composing _**complex digital-analog
+* A [block-based system](docs/content/block_system.md) for composing _**complex digital-analog
   programs**_ in a flexible and scalable manner, inspired by the Julia quantum SDK
   [Yao.jl](https://github.com/QuantumBFS/Yao.jl) and functional programming concepts.
 
-* A [simple interface](docs/digital_analog_qc/analog-basics.md) to work with _**interacting neutral-atom qubit systems**_
-  using [arbitrary registers topologies](docs/tutorials/register.md).
-
-* An intuitive [expression-based system](docs/tutorials/parameters.md) developed on top of the symbolic library [Sympy](https://www.sympy.org/en/index.html) to construct _**parametric quantum programs**_ easily.
-
-* [High-order generalized parameter shift rules](docs/advanced_tutorials/differentiability.md) for _**differentiating parametrized quantum operations**_.
+* An intuitive [expression-based system](docs/content/parameters.md) developed on top of the symbolic library [Sympy](https://www.sympy.org/en/index.html) to construct _**parametric quantum programs**_ easily.
 
 * Out-of-the-box _**automatic differentiability**_ of quantum programs with [PyTorch](https://pytorch.org/) integration.
 
-* _**Efficient execution**_ on a variety of different purpose backends: from state vector simulators to tensor network emulators and real devices.
+* [High-order generalized parameter shift rules](docs/tutorials/advanced_tutorials/differentiability.md) for _**differentiating parametrized quantum operations**_.
+
+* A [simple interface](docs/tutorials/digital_analog_qc/analog-basics.md) to work with _**interacting neutral-atom qubit systems**_
+  using [arbitrary registers topologies](docs/content/register.md).
 
 ## Installation guide
 
@@ -106,11 +116,10 @@ pip install qadence
 
 The default, pre-installed backend for Qadence is [PyQTorch](https://github.com/pasqal-io/pyqtorch), a differentiable state vector simulator for digital-analog simulation based on `PyTorch`. It is possible to install additional, `PyTorch` -based backends and the circuit visualization library using the following extras:
 
-* `pulser`: The [Pulser](https://github.com/pasqal-io/Pulser) backend for composing, simulating and executing pulse sequences for neutral-atom quantum devices.
-* `braket`: The [Braket](https://github.com/amazon-braket/amazon-braket-sdk-python) backend, an open source library that provides a framework for interacting with quantum computing hardware devices through Amazon Braket.
 * `visualization`: A visualization library to display quantum circuit diagrams.
 * `protocols`: A collection of [protocols](https://github.com/pasqal-io/qadence-protocols) for error mitigation in Qadence.
 * `libs`: A collection of [functionalities](https://github.com/pasqal-io/qadence-libs) for graph machine learning problems build on top of Qadence.
+* `pulser`: The [Pulser](https://github.com/pasqal-io/Pulser) backend for composing, simulating and executing pulse sequences for neutral-atom quantum devices (experimental).
 
 Qadence also supports a `JAX` engine which is currently supporting the [Horqrux](https://github.com/pasqal-io/horqrux) backend. `horqrux` is currently only available via the [low-level API](examples/backends/low_level/horqrux_backend.py).
 
@@ -118,7 +127,7 @@ Qadence also supports a `JAX` engine which is currently supporting the [Horqrux]
 To install individual extras, use the following syntax (**IMPORTANT** Make sure to use quotes):
 
 ```bash
-pip install "qadence[braket,pulser,visualization]"
+pip install "qadence[pulser,visualization]"
 ```
 
 To install all available extras, simply do:
@@ -144,10 +153,10 @@ conda install python-graphviz
 
 ## Contributing
 
-Before making a contribution, please review our [code of conduct](docs/CODE_OF_CONDUCT.md).
+Before making a contribution, please review our [code of conduct](docs/getting_started/CODE_OF_CONDUCT.md).
 
 - **Submitting Issues:** To submit bug reports or feature requests, please use our [issue tracker](https://github.com/pasqal-io/qadence/issues).
-- **Developing in qadence:** To learn more about how to develop within `qadence`, please refer to [contributing guidelines](docs/CONTRIBUTING.md).
+- **Developing in qadence:** To learn more about how to develop within `qadence`, please refer to [contributing guidelines](docs/getting_started/CONTRIBUTING.md).
 
 ### Setting up qadence in development mode
 

{qadence-1.5.1 → qadence-1.6.0}/README.md

@@ -1,16 +1,18 @@
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/logo/qadence_logo_white.svg">
-  <source media="(prefers-color-scheme: light)" srcset="./docs/assets/logo/qadence_logo.svg">
-  <img alt="Qadence logo" src="./docs/assets/logo/qadence_logo.svg">
-</picture>
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/extras/assets/logo/qadence_logo_white.svg" width="75%">
+    <source media="(prefers-color-scheme: light)" srcset="./docs/extras/assets/logo/qadence_logo.svg" width="75%">
+    <img alt="Qadence logo" src="./docs/assets/logo/qadence_logo.svg" width="75%">
+  </picture>
+</p>
+
+**Qadence** is a Python package that provides a simple interface to build **digital-analog quantum
+programs** with tunable qubit interactions and arbitrary register topologies realizable on neutral atom devices.
 
 **For a high-level overview of Qadence features, [check out our white paper](https://arxiv.org/abs/2401.09915).**
 
 **For more detailed information, [check out the documentation](https://pasqal-io.github.io/qadence/latest/).**
 
-**Qadence** is a Python package that provides a simple interface to build _**digital-analog quantum
-programs**_ with tunable qubit interaction defined on _**arbitrary register topologies**_ realizable on neutral atom devices.
-
 [![Linting](https://github.com/pasqal-io/qadence/actions/workflows/lint.yml/badge.svg)](https://github.com/pasqal-io/qadence/actions/workflows/lint.yml)
 [![Tests](https://github.com/pasqal-io/qadence/actions/workflows/test_fast.yml/badge.svg)](https://github.com/pasqal-io/qadence/actions/workflows/test_fast.yml)
 [![Documentation](https://github.com/pasqal-io/qadence/actions/workflows/build_docs.yml/badge.svg)](https://pasqal-io.github.io/qadence/latest)
@@ -19,27 +21,26 @@ programs**_ with tunable qubit interaction defined on _**arbitrary register topo
 
 ## Feature highlights
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/assets/qadence_arch.svg">
-  <source media="(prefers-color-scheme: light)" srcset="./docs/assets/qadence_arch.svg">
-  <img alt="Qadence architecture" src="./docs/assets/qadence_arch.svg">
-</picture>
-
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/extras/assets/qadence_arch.svg" width="75%">
+    <source media="(prefers-color-scheme: light)" srcset="./docs/extras/assets/qadence_arch.svg" width="75%">
+    <img alt="Qadence architecture" src="./docs/assets/qadence_arch.svg" width="75%">
+  </picture>
+<p align="center">
 
-* A [block-based system](docs/tutorials/getting_started.md) for composing _**complex digital-analog
+* A [block-based system](docs/content/block_system.md) for composing _**complex digital-analog
   programs**_ in a flexible and scalable manner, inspired by the Julia quantum SDK
   [Yao.jl](https://github.com/QuantumBFS/Yao.jl) and functional programming concepts.
 
-* A [simple interface](docs/digital_analog_qc/analog-basics.md) to work with _**interacting neutral-atom qubit systems**_
-  using [arbitrary registers topologies](docs/tutorials/register.md).
-
-* An intuitive [expression-based system](docs/tutorials/parameters.md) developed on top of the symbolic library [Sympy](https://www.sympy.org/en/index.html) to construct _**parametric quantum programs**_ easily.
-
-* [High-order generalized parameter shift rules](docs/advanced_tutorials/differentiability.md) for _**differentiating parametrized quantum operations**_.
+* An intuitive [expression-based system](docs/content/parameters.md) developed on top of the symbolic library [Sympy](https://www.sympy.org/en/index.html) to construct _**parametric quantum programs**_ easily.
 
 * Out-of-the-box _**automatic differentiability**_ of quantum programs with [PyTorch](https://pytorch.org/) integration.
 
-* _**Efficient execution**_ on a variety of different purpose backends: from state vector simulators to tensor network emulators and real devices.
+* [High-order generalized parameter shift rules](docs/tutorials/advanced_tutorials/differentiability.md) for _**differentiating parametrized quantum operations**_.
+
+* A [simple interface](docs/tutorials/digital_analog_qc/analog-basics.md) to work with _**interacting neutral-atom qubit systems**_
+  using [arbitrary registers topologies](docs/content/register.md).
 
 ## Installation guide
 
@@ -51,11 +52,10 @@ pip install qadence
 
 The default, pre-installed backend for Qadence is [PyQTorch](https://github.com/pasqal-io/pyqtorch), a differentiable state vector simulator for digital-analog simulation based on `PyTorch`. It is possible to install additional, `PyTorch` -based backends and the circuit visualization library using the following extras:
 
-* `pulser`: The [Pulser](https://github.com/pasqal-io/Pulser) backend for composing, simulating and executing pulse sequences for neutral-atom quantum devices.
-* `braket`: The [Braket](https://github.com/amazon-braket/amazon-braket-sdk-python) backend, an open source library that provides a framework for interacting with quantum computing hardware devices through Amazon Braket.
 * `visualization`: A visualization library to display quantum circuit diagrams.
 * `protocols`: A collection of [protocols](https://github.com/pasqal-io/qadence-protocols) for error mitigation in Qadence.
 * `libs`: A collection of [functionalities](https://github.com/pasqal-io/qadence-libs) for graph machine learning problems build on top of Qadence.
+* `pulser`: The [Pulser](https://github.com/pasqal-io/Pulser) backend for composing, simulating and executing pulse sequences for neutral-atom quantum devices (experimental).
 
 Qadence also supports a `JAX` engine which is currently supporting the [Horqrux](https://github.com/pasqal-io/horqrux) backend. `horqrux` is currently only available via the [low-level API](examples/backends/low_level/horqrux_backend.py).
 
@@ -63,7 +63,7 @@ Qadence also supports a `JAX` engine which is currently supporting the [Horqrux]
 To install individual extras, use the following syntax (**IMPORTANT** Make sure to use quotes):
 
 ```bash
-pip install "qadence[braket,pulser,visualization]"
+pip install "qadence[pulser,visualization]"
 ```
 
 To install all available extras, simply do:
@@ -89,10 +89,10 @@ conda install python-graphviz
 
 ## Contributing
 
-Before making a contribution, please review our [code of conduct](docs/CODE_OF_CONDUCT.md).
+Before making a contribution, please review our [code of conduct](docs/getting_started/CODE_OF_CONDUCT.md).
 
 - **Submitting Issues:** To submit bug reports or feature requests, please use our [issue tracker](https://github.com/pasqal-io/qadence/issues).
-- **Developing in qadence:** To learn more about how to develop within `qadence`, please refer to [contributing guidelines](docs/CONTRIBUTING.md).
+- **Developing in qadence:** To learn more about how to develop within `qadence`, please refer to [contributing guidelines](docs/getting_started/CONTRIBUTING.md).
 
 ### Setting up qadence in development mode
 

qadence-1.6.0/mkdocs.yml

@@ -0,0 +1,171 @@
+site_name: Qadence
+repo_url: "https://github.com/pasqal-io/qadence/"
+site_url: "https://pasqal-io.github.io/qadence/"
+repo_name: "qadence"
+
+nav:
+  - Home: index.md
+
+  - Getting started:
+    - Installation: getting_started/installation.md
+    - Development & Info:
+      - Contributing: getting_started/CONTRIBUTING.md
+      - Code of conduct: getting_started/CODE_OF_CONDUCT.md
+      - License: getting_started/LICENSE.md
+
+  - Contents:
+    - Block system: content/block_system.md
+    - Parametric programs: content/parameters.md
+    - Quantum models: content/quantummodels.md
+    - Quantum registers: content/register.md
+    - State initialization: content/state_init.md
+    - Arbitrary Hamiltonians: content/hamiltonians.md
+    - QML Constructors: content/qml_constructors.md
+    - Wavefunction overlaps: content/overlap.md
+    - Backends: content/backends.md
+    - Useful info:
+      - State conventions: content/state_conventions.md
+      - Serialization: content/serializ_and_prep.md
+
+  - Tutorials:
+    - tutorials/index.md
+    - Digital-analog quantum computing:
+      - tutorials/digital_analog_qc/index.md
+      - Basic operations on neutral-atoms: tutorials/digital_analog_qc/analog-basics.md
+      - Fitting a simple function: tutorials/digital_analog_qc/analog-qcl.md
+      - Restricted local addressability: tutorials/digital_analog_qc/semi-local-addressing.md
+      - Pulse-level programming with Pulser: tutorials/digital_analog_qc/pulser-basic.md
+      - Solve a QUBO problem: tutorials/digital_analog_qc/analog-qubo.md
+      - CNOT with interacting qubits: tutorials/digital_analog_qc/daqc-cnot.md
+
+    - Variational quantum algorithms:
+      - tutorials/qml/index.md
+      - Training tools: tutorials/qml/ml_tools.md
+      - Quantum circuit learning: tutorials/qml/qcl.md
+      - Solving MaxCut with QAOA: tutorials/qml/qaoa.md
+      - Solving a 1D ODE: tutorials/qml/dqc_1d.md
+
+    - Advanced Tutorials:
+      - tutorials/advanced_tutorials/index.md
+      - Quantum circuits differentiation: tutorials/advanced_tutorials/differentiability.md
+      - Custom quantum models: tutorials/advanced_tutorials/custom-models.md
+      - Projector blocks: tutorials/advanced_tutorials/projectors.md
+      - Profiling and debugging on CUDA devices: tutorials/advanced_tutorials/profiling-and-debugging.md
+
+    - Realistic simulations:
+      - tutorials/realistic_sims/index.md
+      - Measurement protocols: tutorials/realistic_sims/measurements.md
+      - Simulated errors: tutorials/realistic_sims/noise.md
+      - Error mitigation: tutorials/realistic_sims/mitigation.md
+
+    - Development:
+      - Architecture and sharp bits: tutorials/development/architecture.md
+      - Drawing: tutorials/development/draw.md
+
+  - API:
+    - Block system: api/blocks.md
+    - Operations: api/operations.md
+    - Register: api/register.md
+    - QuantumCircuit: api/quantumcircuit.md
+    - Parameters: api/parameters.md
+    - State preparation: api/states.md
+    - Constructors: api/constructors.md
+    - Transpilation: api/transpile.md
+    - Execution: api/execution.md
+    - Quantum models: api/models.md
+    - QML tools: api/ml_tools.md
+    - Serialization: api/serialization.md
+    - Types: api/types.md
+    - Drawing: api/draw.md
+
+    - Backends:
+      - Abstract backend: api/backends/backend.md
+      - PyQTorch: api/backends/pyqtorch.md
+      - Pulser: api/backends/pulser.md
+      - DifferentiableBackend: api/backends/differentiable.md
+
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  custom_dir: docs/extras/overrides/
+  logo: extras/assets/logo/qadence_logo_small_white.svg
+  features:
+  - content.code.annotate
+  - navigation.tabs
+  - navigation.indexes
+  - navigation.sections
+  - content.code.copy
+  - content.code.annotate
+
+  palette:
+  - media: "(prefers-color-scheme: light)"
+    scheme: default
+    primary: custom
+    accent: custom
+    toggle:
+        icon: material/weather-sunny
+        name: Switch to dark mode
+  - media: "(prefers-color-scheme: dark)"
+    scheme: slate
+    primary: black
+    accent: custom
+    toggle:
+        icon: material/weather-night
+        name: Switch to light mode
+
+markdown_extensions:
+- admonition  # for notes
+- footnotes
+- pymdownx.arithmatex: # for mathjax
+    generic: true
+- pymdownx.highlight:
+    anchor_linenums: true
+- pymdownx.inlinehilite
+- pymdownx.snippets
+- pymdownx.details
+- pymdownx.superfences:
+    custom_fences:
+    - name: python
+      class: python
+      validator: "!!python/name:markdown_exec.validator"
+      format: "!!python/name:markdown_exec.formatter"
+
+plugins:
+- search
+- section-index
+- mkdocstrings:
+    default_handler: python
+    handlers:
+      python:
+        selection:
+          filters:
+            - "!^_"  # exlude all members starting with _
+            - "^__init__$"  # but always include __init__ modules and methods
+            - "^__new__$"  # but always include __init__ modules and methods
+        options:
+          show_root_toc_entry: false
+          heading_level: 3
+          merge_init_into_class: true
+          docstring_section_style: spacy
+
+- markdown-exec
+
+extra:
+ version:
+   provider: mike
+
+# To get nice tabs
+extra_css:
+- extras/css/mkdocstrings.css
+- extras/css/colors.css
+- extras/css/home.css
+
+# For mathjax
+extra_javascript:
+  - extras/javascripts/mathjax.js
+  - https://polyfill.io/v3/polyfill.min.js?features=es6
+  - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
+
+watch:
+- qadence

{qadence-1.5.1 → qadence-1.6.0}/pyproject.toml

@@ -17,10 +17,11 @@ authors = [
     { name = "Joao P. Moutinho", email = "joao.moutinho@pasqal.com"},
     { name = "Vytautas Abramavicius", email = "vytautas.abramavicius@pasqal.com" },
     { name = "Gergana Velikova", email = "gergana.velikova@pasqal.com" },
+    { name = "Eduardo Maschio", email = "eduardo.maschio@pasqal.com" },
 ]
-requires-python = ">=3.9,<3.13"
+requires-python = ">=3.9"
 license = {text = "Apache 2.0"}
-version = "1.5.1"
+version = "1.6.0"
 classifiers=[
     "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python",
@@ -28,6 +29,7 @@ classifiers=[
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
 ]
@@ -42,8 +44,10 @@ dependencies = [
     "jsonschema",
     "nevergrad",
     "scipy",
-    "pyqtorch==1.1.0",
+    "pyqtorch==1.1.2",
+    "pyyaml",
     "matplotlib",
+    "Arpeggio==2.0.2",
 ]
 
 [tool.hatch.metadata]
@@ -51,8 +55,8 @@ allow-direct-references = true
 allow-ambiguous-features = true
 
 [project.optional-dependencies]
-pulser = ["pulser>=v0.15.2", "pasqal-cloud>=0.3.5"]
-braket = ["amazon-braket-sdk==1.71.0"]
+pulser = ["pulser-core==0.18.0", "pulser-simulation==0.18.0","pasqal-cloud==0.8.1"]
+braket = ["amazon-braket-sdk<1.71.2"]
 visualization = [
   "graphviz",
   # FIXME: will be needed once we support latex labels
@@ -69,9 +73,12 @@ horqrux = [
     "sympy2jax"]
 protocols = ["qadence-protocols"]
 libs = ["qadence-libs"]
+dlprof = ["nvidia-pyindex", "nvidia-dlprof[pytorch]"]
 all = [
-  "pulser>=0.15.2",
-  "amazon-braket-sdk",
+  "pulser-core==0.18.0",
+  "pulser-simulation==0.18.0",
+  "pasqal-cloud==0.8.1",
+  "amazon-braket-sdk<1.71.2",
   "graphviz",
   "protocols",
   "libs",
@@ -88,6 +95,7 @@ dependencies = [
   "pytest-cov",
   "pytest-mypy",
   "pytest-xdist",
+  "types-PyYAML",
   "ipykernel",
   "pre-commit",
   "black",
@@ -179,9 +187,10 @@ line-length = 100
 required-imports = ["from __future__ import annotations"]
 
 [tool.ruff.per-file-ignores]
-"__init__.py" = ["F401"]
+"__init__.py" = ["F401", "E402"]
 "qadence/operations/primitive.py" = ["E742"]  # Avoid ambiguous class name warning for identity.
 "qadence/backends/horqrux/convert_ops.py" = ["E741"]  # Avoid ambiguous class name warning for 0.
+"examples/*" = ["E402"] # Allow torch seed to be set before qadence imports
 
 [tool.ruff.mccabe]
 max-complexity = 15

{qadence-1.5.1 → qadence-1.6.0}/qadence/__init__.py

@@ -1,10 +1,43 @@
 from __future__ import annotations
 
+import logging
+import logging.config
+import os
 from importlib import import_module
+from pathlib import Path
 
+import yaml
 from torch import cdouble, set_default_dtype
 from torch import float64 as torchfloat64
 
+DEFAULT_FLOAT_DTYPE = torchfloat64
+DEFAULT_COMPLEX_DTYPE = cdouble
+set_default_dtype(DEFAULT_FLOAT_DTYPE)
+
+logging_levels = {
+    "DEBUG": logging.DEBUG,
+    "INFO": logging.INFO,
+    "WARNING": logging.WARNING,
+    "ERROR": logging.ERROR,
+    "CRITICAL": logging.CRITICAL,
+}
+LOG_CONFIG_PATH = os.environ.get("QADENCE_LOG_CONFIG", f"{Path(__file__).parent}/log_config.yaml")
+LOG_BASE_LEVEL = os.environ.get("QADENCE_LOG_LEVEL", "").upper()
+
+with open(LOG_CONFIG_PATH, "r") as stream:
+    log_config = yaml.load(stream, Loader=yaml.FullLoader)
+logging.config.dictConfig(log_config)
+
+logger: logging.Logger = logging.getLogger(__name__)
+LOG_LEVEL = logging_levels.get(LOG_BASE_LEVEL, logging.INFO)  # type: ignore[arg-type]
+logger.setLevel(LOG_LEVEL)
+[
+    h.setLevel(LOG_LEVEL)  # type: ignore[func-returns-value]
+    for h in logger.handlers
+    if h.get_name() == "console"
+]
+logger.debug(f"Qadence logger successfully setup with log level {LOG_LEVEL}")
+
 from .analog import *
 from .backend import *
 from .backends import *
@@ -28,11 +61,6 @@ from .transpile import *
 from .types import *
 from .utils import *
 
-DEFAULT_FLOAT_DTYPE = torchfloat64
-DEFAULT_COMPLEX_DTYPE = cdouble
-set_default_dtype(DEFAULT_FLOAT_DTYPE)
-
-
 """Fetch the functions defined in the __all__ of each sub-module.
 
 Import to the qadence name space. Make sure each added submodule has the respective definition:

{qadence-1.5.1 → qadence-1.6.0}/qadence/backend.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from abc import ABC, abstractmethod
 from collections import Counter
 from dataclasses import dataclass, fields
+from logging import getLogger
 from typing import Any, Callable, Iterator, Tuple
 
 from openfermion import QubitOperator
@@ -20,14 +21,13 @@ from qadence.blocks import (
 )
 from qadence.blocks.analog import ConstantAnalogRotation, InteractionBlock
 from qadence.circuit import QuantumCircuit
-from qadence.logger import get_logger
 from qadence.measurements import Measurements
 from qadence.mitigations import Mitigations
 from qadence.noise import Noise
 from qadence.parameters import stringify
 from qadence.types import ArrayLike, BackendName, DiffMode, Endianness, Engine, ParamDictType
 
-logger = get_logger(__file__)
+logger = getLogger(__name__)
 
 
 @dataclass

{qadence-1.5.1 → qadence-1.6.0}/qadence/backends/adjoint.py

@@ -7,7 +7,7 @@ from pyqtorch.circuit import QuantumCircuit as PyQCircuit
 from pyqtorch.parametric import Parametric as PyQParametric
 from pyqtorch.primitive import Primitive as PyQPrimitive
 from pyqtorch.utils import inner_prod, param_dict
-from torch import Tensor, no_grad, tensor
+from torch import Tensor, no_grad, zeros
 from torch.autograd import Function
 from torch.nn import Module
 
@@ -125,7 +125,7 @@ class AdjointExpectation(Function):
                     ctx.projected_state, op.dagger(values), op.qubit_support
                 )
             elif isinstance(op, PyQCircuit):
-                grads = [g for sub_op in op.reverse() for g in _apply_adjoint(ctx, sub_op)]
+                grads = [g for sub_op in op.operations[::-1] for g in _apply_adjoint(ctx, sub_op)]
             elif isinstance(op, PyQPrimitive):
                 ctx.out_state = apply_operator(ctx.out_state, op.dagger(values), op.qubit_support)
                 if isinstance(op, PyQParametric) and values[op.param_name].requires_grad:
@@ -147,13 +147,17 @@ class AdjointExpectation(Function):
 
         grads = list(
             reversed(
-                [grad_out * g for op in ctx.circuit.reverse() for g in _apply_adjoint(ctx, op)]
+                [
+                    grad_out * g
+                    for op in ctx.circuit.operations[::-1]
+                    for g in _apply_adjoint(ctx, op)
+                ]
             )
         )
         num_grads = len(grads)
         num_params = len(ctx.saved_tensors)
         diff = num_params - num_grads
-        grads = grads + [tensor([0]) for _ in range(diff)]
+        grads = grads + [zeros(1, device=ctx.circuit.device) for _ in range(diff)]
         # Set observable grads to 0
         ctx.save_for_backward(*grads)
         return (None, None, None, None, *grads)