Migrate to pyQuil v3

README.rst

@@ -28,11 +28,11 @@ PennyLane Forest Plugin
 .. header-start-inclusion-marker-do-not-remove
 
 The PennyLane Forest plugin allows different Rigetti devices to work with
-PennyLane --- the wavefunction simulator, and the Quantum Virtual Machine (QVM).
+PennyLane --- the wavefunction simulator, the Quantum Virtual Machine (QVM), and Quantum Processing Units (QPUs).
 
 `pyQuil <https://pyquil.readthedocs.io>`__ is a Python library for quantum programming using the
 quantum instruction language (Quil) --- resulting quantum programs can be executed using the
-`Rigetti Forest SDK <https://pyquil-docs.rigetti.com/en/stable/>`__ and the `Rigetti QCS
+`Rigetti Forest SDK <https://pyquil-docs.rigetti.com/en/stable/>`__ and `Rigetti Quantum Cloud Services (QCS)
 <https://qcs.rigetti.com/>`__.
 
 `PennyLane <https://pennylane.readthedocs.io>`__ is a cross-platform Python library for quantum machine
@@ -46,23 +46,14 @@ The plugin documentation can be found here: `<https://docs.pennylane.ai/projects
 Features
 ========
 
-* Provides three devices to be used with PennyLane: ``forest.numpy_wavefunction``,
-  ``forest.wavefunction``, and ``forest.qvm``. These provide access to the pyQVM
-  Numpy wavefunction simulator, Forest wavefunction simulator, and quantum
-  virtual machine (QVM) respectively.
+* Provides four devices to be used with PennyLane: ``forest.numpy_wavefunction``,
+  ``forest.wavefunction``, ``forest.qvm``, and ``forest.qpu``. These provide access to the pyQVM
+  Numpy wavefunction simulator, pyQuil wavefunction simulator, quantum
+  virtual machine (QVM), and quantum processing units (QPUs) respectively.
 
 
 * All provided devices support all core qubit PennyLane operations and observables.
 
-
-* Provides custom PennyLane operations to cover additional pyQuil operations:
-  ``ISWAP``, ``PSWAP``, and ``CPHASE``. Every custom operation supports analytic
-  differentiation.
-
-* Combine Forest and the Rigetti Cloud Services with PennyLane's automatic differentiation and
-  optimization.
-
-
 .. installation-start-inclusion-marker-do-not-remove
 
 Installation
@@ -86,14 +77,12 @@ Dependencies
 
 PennyLane-Forest requires the following libraries be installed:
 
-* `Python <http://python.org/>`__ >=3.6
+* `Python <http://python.org/>`__ >=3.7
 
 as well as the following Python packages:
 
-* `PennyLane <http://pennylane.readthedocs.io/>`__
-* `pyQuil <https://pyquil-docs.rigetti.com/en/stable/>`__ >=2.16, <2.28.3
-
-Note that the latest PyQuil version 3.0 is not currently supported.
+* `PennyLane <http://pennylane.readthedocs.io/>`__ >=0.15.0
+* `pyQuil <https://pyquil-docs.rigetti.com/en/stable/>`__ >=3.3.1, <4.0.0
 
 If you currently do not have Python 3 installed, we recommend
 `Anaconda for Python 3 <https://www.anaconda.com/download/>`__, a distributed version
@@ -105,11 +94,11 @@ Forest software development kit (SDK):
 
 * `Forest SDK <https://pyquil-docs.rigetti.com/en/stable/>`__
 
-Alternatively, you may sign up for Rigetti's Quantum Cloud Services (QCS) to acquire a Quantum Machine
-Image (QMI) which will allow you to compile your quantum code and run on real quantum processing units (QPUs),
-or on a preinstalled QVM. Note that this requires a valid QCS account.
+Alternatively, you may sign up for Rigetti's Quantum Cloud Services (QCS)  which will allow you to compile your 
+quantum code and run on real QPUs. Note that this requires a valid QCS account and the QCS CLI:
 
-* `Quantum Cloud Services <https://docs.rigetti.com/en/>`__
+* `QCS <https://docs.rigetti.com/en/>`__
+* `QCS CLI <https://docs.rigetti.com/qcs/guides/using-the-qcs-cli>`__
 
 Tests
 ~~~~~

doc/devices/numpy_wavefunction.rst

@@ -58,15 +58,4 @@ array([0.97517033, 0.04904283])
 Supported operations
 ~~~~~~~~~~~~~~~~~~~~
 
-All Forest devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with
-the exception of the PennyLane ``QubitStateVector`` state preparation operation.
-
-In addition, PennyLane-Forest provides the following PyQuil-specific operations for PennyLane.
-These are all importable from :mod:`pennylane_forest.ops <.ops>`.
-
-These operations include:
-
-.. autosummary::
-    pennylane_forest.ops.CPHASE
-    pennylane_forest.ops.ISWAP
-    pennylane_forest.ops.PSWAP
+All Forest devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with the exception of the PennyLane ``QubitStateVector`` state preparation operation.

doc/devices/qpu.rst

@@ -1,11 +1,9 @@
-:orphan:
-
 The QPU device
 ==============
 
 The intention of the ``forest.qpu`` device is to construct a device that will allow for execution on an actual QPU.
-Constructing and using this device is very similar to very similar in design and implementation as the
-``forest.qvm`` device, with slight differences at initialization, such as not supporting the keyword argument ``noisy``.
+Constructing and using this device is very similar in design and implementation as the ``forest.qvm`` device, with 
+slight differences at initialization, such as not supporting the keyword argument ``noisy``.
 
 In addition, ``forest.qpu`` also accepts the optional ``active_reset`` keyword argument:
 
@@ -21,7 +19,7 @@ Usage
 A QPU device can be created via:
 
 >>> import pennylane as qml
->>> dev_qpu = qml.device('forest.qpu', device='Aspen-8', shots=1000)
+>>> dev_qpu = qml.device('forest.qpu', device='Aspen-M-2', shots=1000)
 
 Note that additional Quil gates not provided directly in PennyLane are importable from :mod:`~.ops`.
 An example that demonstrates the use of the native :class:`~.PSWAP` plugin gate is this:
@@ -51,46 +49,15 @@ We can then integrate the quantum hardware and PennyLane's automatic differentia
 Supported operations
 ~~~~~~~~~~~~~~~~~~~~
 
-All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with
-he exception of the PennyLane ``QubitStateVector`` state preparation operation.
-
-In addition, PennyLane-Forest provides the following PyQuil-specific operations for PennyLane.
-These are all importable from :mod:`pennylane_forest.ops <.ops>`.
-
-These operations include:
-
-.. autosummary::
-    pennylane_forest.ops.CPHASE
-    pennylane_forest.ops.ISWAP
-    pennylane_forest.ops.PSWAP
-
-Device options
-~~~~~~~~~~~~~~
+All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with the exception of the PennyLane ``QubitStateVector`` state preparation operation.
 
-On initialization, the PennyLane-Forest devices accept additional keyword 
-arguments beyond the PennyLane default device arguments.
-
-``forest_url`` (*str*)
-    the Forest URL server. Can also be set by
-    the environment variable ``FOREST_SERVER_URL``, or in the ``~/.qcs_config``
-    configuration file. Default value is ``"https://forest-server.qcs.rigetti.com"``.
-
-``qvm_url`` (*str*)
-    the QVM server URL. Can also be set by the environment
-    variable ``QVM_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:5000"``.
-
-``compiler_url`` (*str*)
-    the compiler server URL. Can also be set by the environment
-    variable ``COMPILER_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:6000"``.
+quilc server configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. note::
 
     If using the downloadable Forest SDK with the default server configurations
-    for the QVM and the Quil compiler (i.e., you launch them with the commands
-    ``qvm -S`` and ``quilc -R``), then you will not need to set these keyword arguments.
-
-    Likewise, if you are running PennyLane using the Rigetti Quantum Cloud Service (QCS)
-    on a provided QMI, these environment variables are set automatically and will also
-    not need to be passed in PennyLane.
+    for the Quil compiler (i.e., ``quilc -R``), then no special configuration is needed.
+    If using a non-default port or host for the server, see the 
+    `pyQuil configuration documentation <https://pyquil-docs.rigetti.com/en/stable/advanced_usage.html#pyquil-configuration>`_
+    for details on how to override the default values.

doc/devices/qvm.rst

@@ -96,18 +96,7 @@ Printing out the results of the three device expectation values:
 Supported operations
 ~~~~~~~~~~~~~~~~~~~~
 
-All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with
-he exception of the PennyLane ``QubitStateVector`` state preparation operation.
-
-In addition, PennyLane-Forest provides the following PyQuil-specific operations for PennyLane.
-These are all importable from :mod:`pennylane_forest.ops <.ops>`.
-
-These operations include:
-
-.. autosummary::
-    pennylane_forest.ops.CPHASE
-    pennylane_forest.ops.ISWAP
-    pennylane_forest.ops.PSWAP
+All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with the exception of the PennyLane ``QubitStateVector`` state preparation operation.
 
 Supported observables
 ~~~~~~~~~~~~~~~~~~~~~
@@ -190,36 +179,4 @@ After measuring the qubit state, we can determine the probability :math:`P_0` of
 
 This process is done automatically behind the scenes in the QVM device when ``qml.expval(qml.Hermitian)`` is returned.
 
-
-
-
-Device options
-~~~~~~~~~~~~~~
-
-On initialization, the PennyLane-Forest devices accept additional keyword
-arguments beyond the PennyLane default device arguments.
-
-``forest_url`` (*str*)
-    the Forest URL server. Can also be set by
-    the environment variable ``FOREST_SERVER_URL``, or in the ``~/.qcs_config``
-    configuration file. Default value is ``"https://forest-server.qcs.rigetti.com"``.
-
-``qvm_url`` (*str*)
-    the QVM server URL. Can also be set by the environment
-    variable ``QVM_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:5000"``.
-
-``compiler_url`` (*str*)
-    the compiler server URL. Can also be set by the environment
-    variable ``COMPILER_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:6000"``.
-
-.. note::
-
-    If using the downloadable Forest SDK with the default server configurations
-    for the QVM and the Quil compiler (i.e., you launch them with the commands
-    ``qvm -S`` and ``quilc -R``), then you will not need to set these keyword arguments.
-
-    Likewise, if you are running PennyLane using the Rigetti Quantum Cloud Service (QCS)
-    on a provided QMI, these environment variables are set automatically and will also
-    not need to be passed in PennyLane.
+.. include:: ./qvm_and_quilc_server_configuration.rst

doc/devices/qvm_and_quilc_server_configuration.rst

@@ -0,0 +1,11 @@
+QVM and quilc server configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. note::
+
+    If using the downloadable Forest SDK with the default server configurations
+    for the QVM and the Quil compiler (i.e., you launch them with the commands
+    ``qvm -S`` and ``quilc -R``), then no special configuration is needed.
+    If using a non-default port or host for either of the servers, see the 
+    `pyQuil configuration documentation <https://pyquil-docs.rigetti.com/en/stable/advanced_usage.html#pyquil-configuration>`_
+    for details on how to override the default values.

doc/devices/wavefunction.rst

@@ -50,49 +50,9 @@ You can then execute the circuit like any other function to get the quantum mech
 >>> circuit(0.2, 0.1, 0.3)
 array([0.97517033, 0.04904283])
 
-Device options
-~~~~~~~~~~~~~~
-
-On initialization, the PennyLane-Forest devices accept additional keyword
-arguments beyond the PennyLane default device arguments.
-
-``forest_url`` (*str*)
-    the Forest URL server. Can also be set by
-    the environment variable ``FOREST_SERVER_URL``, or in the ``~/.qcs_config``
-    configuration file. Default value is ``"https://forest-server.qcs.rigetti.com"``.
-
-``qvm_url`` (*str*)
-    the QVM server URL. Can also be set by the environment
-    variable ``QVM_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:5000"``.
-
-``compiler_url`` (*str*)
-    the compiler server URL. Can also be set by the environment
-    variable ``COMPILER_URL``, or in the ``~/.forest_config`` configuration file.
-    Default value is ``"http://127.0.0.1:6000"``.
-
-.. note::
-
-    If using the downloadable Forest SDK with the default server configurations
-    for the QVM and the Quil compiler (i.e., you launch them with the commands
-    ``qvm -S`` and ``quilc -R``), then you will not need to set these keyword arguments.
-
-    Likewise, if you are running PennyLane using the Rigetti Quantum Cloud Service (QCS)
-    on a provided QMI, these environment variables are set automatically and will also
-    not need to be passed in PennyLane.
-
 Supported operations
 ~~~~~~~~~~~~~~~~~~~~
 
-All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with
-he exception of the PennyLane ``QubitStateVector`` state preparation operation.
-
-In addition, PennyLane-Forest provides the following PyQuil-specific operations for PennyLane.
-These are all importable from :mod:`pennylane_forest.ops <.ops>`.
-
-These operations include:
+All devices support all PennyLane `operations and observables <https://pennylane.readthedocs.io/en/stable/introduction/operations.html#qubit-operations>`_, with the exception of the PennyLane ``QubitStateVector`` state preparation operation.
 
-.. autosummary::
-    pennylane_forest.ops.CPHASE
-    pennylane_forest.ops.ISWAP
-    pennylane_forest.ops.PSWAP
+.. include:: ./qvm_and_quilc_server_configuration.rst

doc/index.rst

@@ -16,19 +16,24 @@ Currently, PennyLane-Forest provides these Forest devices for PennyLane:
 
 .. title-card::
     :name: 'forest.numpy_wavefunction'
-    :description: Forest's Numpy wavefunction simulator backend.
+    :description: pyQuil's Numpy wavefunction simulator backend.
     :link: devices/numpy_wavefunction.html
 
 .. title-card::
     :name: 'forest.wavefunction'
-    :description: The Forest SDK wavefunction simulator backend.
+    :description: The QCS wavefunction simulator backend.
     :link: devices/wavefunction.html
 
 .. title-card::
     :name: 'forest.qvm'
-    :description: Forest's QVM and pyQuil pyQVM simulator.
+    :description: QCS QVM and pyQuil pyQVM simulator.
     :link: devices/qvm.html
 
+.. title-card::
+    :name: 'forest.qpu'
+    :description: QCS QPU.
+    :link: devices/qpu.html
+
 .. raw:: html
 
         <div style='clear:both'></div>
@@ -45,20 +50,19 @@ Check out these demos to see the PennyLane-Forest plugin in action:
     <div class="row">
 
 .. title-card::
-    :name: Ensemble classification with Forest and Qiskit devices
-    :figure: <img src="https://pennylane.ai/qml/_images/ensemble_diagram.png" width="100%" />
+    :name: Ensemble classification with QCS and Qiskit devices
+    :description: Use two QPUs in parallel to help solve a machine learning classification problem.
     :link:  https://pennylane.ai/qml/demos/ensemble_multi_qpu.html
 
 .. title-card::
     :name: PyTorch and noisy devices
-    :figure: <img src="https://pennylane.ai/qml/_images/bloch.gif" width="100%" />
+    :description: Use PyTorch and a noisy QVM to see how optimization responds to noisy qubits.
     :link:  https://pennylane.ai/qml/demos/pytorch_noise.html
 
 .. raw:: html
 
     </div></div><div style='clear:both'> <br/>
 
-
 You can also try it out using any of the qubit based `demos from the PennyLane documentation
 <https://pennylane.ai/qml/demonstrations.html>`_, for example the tutorial on
 `qubit rotation <https://pennylane.ai/qml/demos/tutorial_qubit_rotation.html>`_.
@@ -89,6 +93,7 @@ hardware access.
    devices/numpy_wavefunction
    devices/wavefunction
    devices/qvm
+   devices/qpu
 
 .. toctree::
    :maxdepth: 1

pennylane_forest/__init__.py

@@ -3,6 +3,7 @@
 ===============
 """
 from .ops import CPHASE, ISWAP, PSWAP
+from .qpu import QPUDevice
 from .qvm import QVMDevice
 from .wavefunction import WavefunctionDevice
 from .numpy_wavefunction import NumpyWavefunctionDevice