Package: quple
Quple is a framework for quantum machine learning based on the GoogleCirqandTensorFlow Quantumlibraries. It contains implementation of a wide range of quantum machine learning algorithms, including:Variational Quantum Classifier (VQC)Quantum Support Vector Machine (QSVM)Quantum Convolutional Neural Network (QCNN)Quantum Generative Adversarial Network (QGAN)Quple was originally developed for applications in high energy physics (HEP) analyses. The letter "Q" refers to the use of quantum computational methods in this framework. The homophone to the word "couple" references the concept in HEP which refers to the interaction between two objects - machine learning and high energy physics in this case.Quple started as a Google Summer of Code (GSoC) project in 2020 and 2021 for theML4Sciumbrella organization. References to related projects can be found in the descriptions below.Installing the packageTo install the current release, simply dopip install qupleTutorialsFor GSoC 2020:Tutorial-01 Quantum CircuitTutorial-02 Parameterised Quantum Circuit (PQC)Tutorial-03 Interaction GraphsTutorial-04 Encoding FunctionTutorial-05 Encoding CircuitTutorial-06 Variational CircuitTutorial-07 Circuit DescriptorsTutorial-08 Variational Quantum ClassifierFor GSoC 2021:Tutorial-09 Parameterized Quantum Circuit (PQC) layerTutorial-10 Quantum Convolution 2D (QConv2D) layerTutorial-11 Quantum Generative Adversarial Network (QGAN)Advanced Tutorial-01 QGAN High Energy Physics ApplicationGSoC 2020 : QupleThe project archive can be foundhere.For documentation and report, please checkhere.GSoC 2021 : Quple - Quantum GANThe proposed projectQuple - Quantum GANserves as an extension to the 2020 GSoC project with a major focus on the implementation of Quantum Generative Adversarial Networks (QGAN).In this project, two major concepts are developed:Quantum convolution using quantum filters (QFilter)Quantum image generation and discrimination based on quantum convolutionQuantum Convolution using Quantum FiltersRelevant tutorial notebooks:Tutorial 09,Tutorial 10.Quantum convolution uses aquantum filteras the basic building block. It replaces the classical filter by a Parameterised Quantum Circuit (PQC) which scan across the local regions (the receptive field) of an image.In the classical case, an output pixel value (neuron) that are connected to a local region in the input image is computed as the dot product between the kernel weights of the classical filter and the pixel values in the local region.In the quantum case, a quantum filter transforms the pixel values in the local region into the quantum states of its data circuit via a suitable feature map, hence projecting the data into a higher dimensional quantum (Hilbert) space. The quantum states are then propagated to the model circuit of the quantum filter which undergoes a sequence parameterised gate operations and outputs the expectation value of a given measurement operator.Implementation of the above concept is done via theQConv2Dclass with API similar to thetf.keras.layers.Conv2Dclass. It borrows common concepts in traditional convolution such asfilters,kernel_size,stridesandpadding.Note that thekernel_sizeof a quantum filter does not refer to the number of trainable weights in the quantum filter but instead to the dimensions of the receptive field passed to the data circuit.Quantum Image Generation and DiscriminationRelevant tutorial notebooks:Tutorial 11The essence of a quantum version of the Generative Adversarial Network (GAN) is to replace the generator and discriminator neural networks with quantum neural networks made up of parameterized quantum circuits (PQCs).Both quantum generator and discriminator neural networks consist of two key components. The first component is a data encoding circuit (i.e. theinput layer) that maps classical input dataofvariables into a quantum stateusing a quantum feature map. The quantum state is then passed to a PQC layer (represented by the circuit ($W(\theta)$) made up of a series of parameterized local single-qubit rotationsand two-qubit entagling operations in which the circuit parameters represent the weights of a neural network.A pure quantum neural network therefore represents the combined circuit operation.Finally a total of(repetitions) of measurements (via a measurement operatorwhich usually is the Paulioperator acting on the i-th qubit) is made on one or multiple qubits of the combined circuit to measure the expectation values.Application of GAN to HEP - Generation of Electromagnetic Calorimeter Energy DepositionRelevant tutorial notebooks:Advanced Tutorial 01.The dataset of interest is a set of 32 x 32 images that represent the energy deposition on the detector cells of an electromagnetic calorimeter (ECAL).The local geometry of the energy deposition contains information about the properties of the particles that went through the detector cells which is crucial in identifying the particles of origin.In this particular dataset, two class of particles are involved: photons (class label "0") and electrons (class label "1"). Each image correspond to a single particle of origin, either photon or electron. In total, there are 498,000 samples, equally distributed between the two classes.The goal of a quantum GAN model in this case would be to generate images that simulate the given photon/electron images.One potential application of this model would be to perform fast simulation of ECAL enery deposition which can be used as an alternative to standard Monte Carlo simulators like GEANT4. This is especially useful when the requirement on the quality of the generated samples are less stringent such as for evaluation of ECAL related systematics uncertainties.Example photon images:Example electron images:The effective size of the images is roughly 8x8, so for demonstration purpose a cropped version of the images are used:Some example training outputs using theQGANclass from Quple:GAN with quantum generator + quantum discriminator using the modified mini-max loss function:GAN with quantum generator + quantum discriminator using the Wasserstein loss function: