Skip to main content

VQE on linear optical circuits

Project description

Repository build European Union Unitary Foundation Documentation Status codecov PyPI version Downloads License Discord Chat

qlass

qlass is a package to compile quantum algorithms on photonic devices. Part of the Quantum Glass-based Photonic Integrated Circuits (QLASS) project funded by the European Union.

Installing qlass

Stable release (PyPI)

To install the latest stable release of qlass from PyPI:

pip install qlass

Development install

To install the development version, set the working directory to the top level of the repository and run:

pip install -e .

qlass builds upon open-source scientific software packages in Python: scipy for numerical optimization, pyscf and openfermion for quantum chemistry, qiskit for quantum computing, and perceval for quantum photonics compilation.

Getting started

You can use this demo notebook on the variational quantum eigensolver (VQE) to get started with the qlass package, or check out the example script.

Features

Circuit Compilation

qlass provides a convenient function to compile Qiskit quantum circuits to Perceval processors:

from qiskit import QuantumCircuit
from qlass import compile

# Create a Qiskit circuit
qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)

# Compile to Perceval processor
processor = compile(qc)

Variational Quantum Eigensolver (VQE)

qlass includes tools for implementing the Variational Quantum Eigensolver on photonic quantum computers:

from qlass.vqe import VQE, le_ansatz
from qlass.utils import loss_function
from qlass.quantum_chemistry import LiH_hamiltonian

# Generate a Hamiltonian for the LiH molecule
hamiltonian = LiH_hamiltonian(num_electrons=2, num_orbitals=1)

# Define an executor function that uses the linear entangled ansatz
def executor(params, pauli_string):
    processor = le_ansatz(params, pauli_string)
    sampler = Sampler(processor)
    samples = sampler.samples(10_000)
    return samples

# Initialize the VQE solver
vqe = VQE(
    hamiltonian=hamiltonian,
    executor=executor,
    num_params=4, # Number of parameters in the linear entangled ansatz
)

# Run the VQE optimization
vqe_energy = vqe.run(
    max_iterations=10,
    verbose=True
)

Quantum Chemistry

The package provides tools for working with quantum chemistry Hamiltonians:

from qlass.quantum_chemistry import LiH_hamiltonian, brute_force_minimize

# Generate a Hamiltonian for the LiH molecule
hamiltonian = LiH_hamiltonian(num_electrons=2, num_orbitals=1)

# Calculate the exact ground state energy for comparison
exact_energy = brute_force_minimize(hamiltonian)

Module Structure

The qlass package is organized into several modules:

  • qlass.compiler: Functions for compiling quantum circuits to photonic processors
  • qlass.quantum_chemistry: Tools for generating and manipulating Hamiltonians
  • qlass.vqe: VQE ansatz implementations for photonic quantum computing
  • qlass.utils: Utility functions for executing algorithms and processing results

Documentation

The main functions of the package are commented using the Google style format and can be found here.

Contributing

qlass is developed by the Unitary Foundation, in collaboration with QLASS performers.

You can join the UF Discord server for community support.

Funding

Funded by the European Union. Views and opinions expressed are however those of the authors only and do not necessarily reflect those of the European Union. Neither the European Union nor the granting authority can be held responsible for them.

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

qlass-0.2.0.tar.gz (43.9 kB view details)

Uploaded Source

Built Distribution

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

qlass-0.2.0-py3-none-any.whl (50.0 kB view details)

Uploaded Python 3

File details

Details for the file qlass-0.2.0.tar.gz.

File metadata

  • Download URL: qlass-0.2.0.tar.gz
  • Upload date:
  • Size: 43.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for qlass-0.2.0.tar.gz
Algorithm Hash digest
SHA256 f49dfa99422f833dfc9be52f32969f6f905c9865a66c48270f88f180b7515366
MD5 e57652d4241e8d3e4b9eb46fd9aae672
BLAKE2b-256 cf7f8f02aa224e2d1dfa4ad0dba9b2db9632566fe6b42e28d9b54fc0210f1e94

See more details on using hashes here.

File details

Details for the file qlass-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: qlass-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 50.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.11

File hashes

Hashes for qlass-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7694d2b722664cb4fdd67059ae49f6a4b189924ea5070117b2052498d60cf04a
MD5 1ab08945086089d08f5d76e6332eaa6b
BLAKE2b-256 f685987b544b320e1b3482c076d45f3428840a9dfc741582b73e20b35a1e3711

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