Skip to main content
Travis Codecov coverage Codacy grade Read the Docs PyPI PyPI - Python Version

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

qiskit is an open-source compilation framework capable of targeting various types of hardware and a high-performance quantum computer simulator with emulation capabilities, and various compiler plug-ins.

This PennyLane plugin allows to use both the software and hardware backends of qiskit as devices for PennyLane.

Features

  • Provides two providers to be used with PennyLane: qiskit.basicaer and qiskit.ibm. These provide access to the respective qiskit backends.

  • Supports a wide range of PennyLane operations and expectation values across the providers.

  • Combine qiskit high performance simulator and hardware backend support with PennyLane’s automatic differentiation and optimization.

Installation

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

$ python -m pip install pennylane_qiskit

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

$ make test

in the source folder. Tests restricted to a specific provider can be run by executing make test-aer or make test-ibm.

Getting started

You can instantiate a 'qiskit.basicaer' device for PennyLane with:

import pennylane as qml
dev = qml.device('qiskit.basicaer', wires=2)

This device can then be used just like other devices for the definition and evaluation of QNodes within PennyLane. A simple quantum function that returns the expectation value of a measurement and depends on three classical input parameters would look like:

@qml.qnode(dev)
def circuit(x, y, z):
    qml.RZ(z, wires=[0])
    qml.RY(y, wires=[0])
    qml.RX(x, wires=[0])
    qml.CNOT(wires=[0, 1])
    return qml.expval.PauliZ(wires=1)

You can then execute the circuit like any other function to get the quantum mechanical expectation value.

circuit(0.2, 0.1, 0.3)

You can also change the default device’s backend with

dev = qml.device('qiskit.basicaer', wires=2, backend='unitary_simulator')

To get a current overview what backends are available you can query this by

dev.capabilities()['backend']

Running your code on an IBM Quantum Experience simulator or even a real hardware chip is just as easy. Instead of the device above, you would instantiate a 'qiskit.ibm' device by giving your IBM Quantum Experience token:

import pennylane as qml
dev = qml.device('qiskit.ibm', wires=2, ibmqx_token="XXX")

In order to avoid any publishing of your token it is also possible to define an environment variable IBMQX_TOKEN, which will be taken if non is provided. Per default the backend ibm uses the simulator backend ibmq_qasm_simulator, but you can change that to be any of the real backends as given by

dev.capabilities()['backend']

Please refer to the documentation of the PennyLane qiskit Plugin as well as well as to the documentation of PennyLane for further reference.

How to cite

If you are doing research using PennyLane, please cite our whitepaper:

Ville Bergholm, Josh Izaac, Maria Schuld, Christian Gogolin, and Nathan Killoran. PennyLane. arXiv, 2018. arXiv:1811.04968

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

Carsten Blank

Support

If you are having issues, please let us know by posting the issue on our Github issue tracker.

License

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

Download files

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

Source Distribution

PennyLane-qiskit-0.0.2.tar.gz (10.2 kB view details)

Uploaded Source

Built Distribution

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

PennyLane_qiskit-0.0.2-py3-none-any.whl (17.3 kB view details)

Uploaded Python 3

File details

Details for the file PennyLane-qiskit-0.0.2.tar.gz.

File metadata

  • Download URL: PennyLane-qiskit-0.0.2.tar.gz
  • Upload date:
  • Size: 10.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/20.7.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for PennyLane-qiskit-0.0.2.tar.gz
Algorithm Hash digest
SHA256 c8b1fc62c47a12909c81ab8538b8cb0edd507a6bf127181a5022ac7be6f3db85
MD5 3b48aa7e94019ac3472c9ee46e8a0528
BLAKE2b-256 7de0758ae04912e178a8b585aaf1082287ab22b7ddc9c7b510be62eee045c136

See more details on using hashes here.

File details

Details for the file PennyLane_qiskit-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: PennyLane_qiskit-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 17.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/20.7.0 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.7

File hashes

Hashes for PennyLane_qiskit-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4971bc92f7af17ea74fc88ac28bdd8f57d47ee1257c419d5e00b1e0dc30bf1a1
MD5 58fe119b8618154905c10708aa73b1f4
BLAKE2b-256 6bf5fdea0f99bfd9faff4c3d1940b44a2c24f504620ce0093f30e1a890b27649

See more details on using hashes here.

Release history Release notifications | RSS feed

0.45.0

1 file

0.44.1

1 file

0.44.0

1 file

0.43.0

1 file

0.42.0

1 file

0.41.0.post0

1 file

0.41.0

1 file

0.40.1

1 file

0.40.0

1 file

0.39.1

1 file

0.39.0

1 file

0.38.1

1 file

0.38.0

1 file

0.37.0

1 file

0.36.0

1 file

0.35.1

1 file

0.35.0

1 file

0.34.1

1 file

0.34.0

1 file

0.33.1

1 file

0.33.0

1 file

0.32.0

1 file

0.31.0

1 file

0.30.1

1 file

0.30.0

1 file

0.29.0

1 file

0.28.0

2 files

0.27.0

1 file

0.24.0

1 file

0.23.0

1 file

0.22.0

1 file

0.21.0

1 file

0.20.0

2 files

0.18.0

1 file

0.17.0

1 file

0.16.0

1 file

0.15.0

1 file

0.14.0

1 file

0.13.0

1 file

0.12.0

1 file

0.11.0

1 file

0.9.0

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

2 files

0.0.8

1 file

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

This release

0.0.2 This release

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page