Skip to main content

PennyLane plugin for Qulacs.

Project description

GitHub Workflow Status (branch) Codecov coverage CodeFactor Grade Read the Docs PyPI PyPI - Python Version

The PennyLane-Qulacs plugin integrates the Qulacs quantum computing framework with PennyLane’s quantum machine learning capabilities.

PennyLane is a cross-platform Python library for quantum machine learning, automatic differentiation, and optimization of hybrid quantum-classical computations.

Qulacs is a software library for quantum computing, written in C++ and with GPU support.

The plugin documentation can be found here: https://pennylane-qulacs.readthedocs.io/en/latest/.

Features

  • Provides access to Qulacs’ simulator backend via the qulacs.simulator device

  • Support for all PennyLane core functionality

Benchmarks

We ran a 100 executions of 4 layer quantum neural network strongly entangling layer and compared the runtimes between CPU and GPU.

https://raw.githubusercontent.com/soudy/pennylane-qulacs/master/images/qnn_cpu_vs_gpu.png

https://raw.githubusercontent.com/soudy/pennylane-qulacs/master/images/qulacs_table.png

Installation

This plugin requires Python version 3.6 or above, as well as PennyLane and Qulacs. Installation of this plugin, as well as all dependencies, can be done using pip:

$ pip install pennylane-qulacs

Alternatively, you can install PennyLane-Qulacs from the source code by navigating to the top directory and running:

$ python setup.py install

Dependencies

PennyLane-Qulacs requires the following libraries be installed:

as well as the following Python packages:

If you currently do not have Python 3 installed, we recommend Anaconda for Python 3, a distributed version of Python packaged for scientific computation.

Tests

To test that the PennyLane-Qulacs plugin is working correctly you can run

$ make test

in the source folder.

Documentation

To build the HTML documentation, go to the top-level directory and run:

$ make docs

The documentation can then be found in the doc/_build/html/ directory.

Contributing

We welcome contributions - simply fork the repository of this plugin, and then make a pull request containing your contribution. All contributers to this plugin will be listed as authors on the releases.

We also encourage bug reports, suggestions for new features and enhancements, and even links to cool projects or applications built on PennyLane.

Authors

PennyLane-Qulacs is the work of many contributors.

If you are doing research using PennyLane and PennyLane-Qulacs, please cite our paper:

Ville Bergholm, Josh Izaac, Maria Schuld, Christian Gogolin, M. Sohaib Alam, Shahnawaz Ahmed, Juan Miguel Arrazola, Carsten Blank, Alain Delgado, Soran Jahangiri, Keri McKiernan, Johannes Jakob Meyer, Zeyue Niu, Antal Száva, and Nathan Killoran. PennyLane: Automatic differentiation of hybrid quantum-classical computations. 2018. arXiv:1811.04968

Support

If you are having issues, please let us know by posting the issue on our Github issue tracker, or by asking a question in the forum.

License

The PennyLane-Qulacs plugin is free and open source, released under the Apache License, Version 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pennylane-qulacs-0.11.0.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pennylane_qulacs-0.11.0-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

File details

Details for the file pennylane-qulacs-0.11.0.tar.gz.

File metadata

  • Download URL: pennylane-qulacs-0.11.0.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0.post20200511 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for pennylane-qulacs-0.11.0.tar.gz
Algorithm Hash digest
SHA256 3881e792c379e00434a39bd82f45349dea307b235dd8086f84c3a8d16368a481
MD5 1020c2b84b82cb14bdef7181b786e303
BLAKE2b-256 241e311b238486b62ceee5d38a22a8ef1e955bc04b3c9829b941a8b9abf175b8

See more details on using hashes here.

File details

Details for the file pennylane_qulacs-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: pennylane_qulacs-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 12.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.2.0.post20200511 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for pennylane_qulacs-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6629bae88a1244b950990ab80bff009d0b34f51a6a413cd2603782094ea61233
MD5 0578491211d1baa0ae1c302db1d6fcfe
BLAKE2b-256 bbc278fd0ba2cf0d0c0a91d7cf129ca82b05269be71dbc0799f0ad95c9cacfc6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page