Skip to content

Latest commit

 

History

History
140 lines (84 loc) · 4.64 KB

README.rst

File metadata and controls

140 lines (84 loc) · 4.64 KB

PennyLane Q# Plugin

Read the Docs

The PennyLane Q# plugin integrates the Q# quantum computing framework with PennyLane's quantum machine learning capabilities.

The Microsoft Quantum Development Kit is an open-source library for quantum programming using the .NET Q# quantum programming language. Resulting quantum programs can be executed using built in local simulators, or via the cloud-based Azure quantum simulator.

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

The documentation can be found here.

Features

  • Provides a Microsoft QDK device to be used with PennyLane: microsoft.QuantumSimulator. This provides access to the local full state simulator.
  • All provided devices support all core qubit PennyLane operations and observables.
  • Provides custom PennyLane operations to cover additional Q# operations, including T, S, ISWAP, CCNOT, PSWAP, and many more. Every custom operation supports analytic differentiation.
  • Combine Microsoft Azure quantum simulators with PennyLane's automatic differentiation and optimization.

Installation

Installation of this plugin, as well as all dependencies, can be done using pip:

$ python -m pip install pennylane-qsharp

Make sure you are using the Python 3 version of pip.

Alternatively, you can install PennyLane Q# from the source code by navigating to the top directory and running

$ python setup.py install

Dependencies

PennyLane Q# 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.

Software tests

To ensure that PennyLane Q# is working correctly after installation, the test suite can be run by navigating to the source code folder and running

$ make test

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 PennyLane-Q# repository, and then make a pull request containing your contribution.

All contributers to PennyLane-Q# 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 and the Microsoft QDK.

Authors

PennyLane-Q# is the work of many contributors.

If you are doing research using PennyLane and PennyLane-Q#, 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

PennyLane-Q# is free and open source, released under the Apache License, Version 2.0.