Metadata-Version: 2.3
Name: qlass
Version: 0.1.2
Summary: VQE on linear optical circuits
License: Apache License
Author: Farrokh Labib
Author-email: farrokh@unitary.foundation
Requires-Python: >=3.9,<3.14
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: openfermion
Requires-Dist: openfermionpyscf
Requires-Dist: perceval-quandela (==0.13.0)
Requires-Dist: pyscf
Requires-Dist: qiskit (==1.4.2)
Requires-Dist: tqdm
Project-URL: Homepage, https://github.com/unitaryfoundation/qlass
Project-URL: Issues, https://github.com/unitaryfoundation/qlass/issues
Description-Content-Type: text/markdown

[![Repository](https://img.shields.io/badge/GitHub-5C5C5C.svg?logo=github)](https://github.com/unitaryfund/qlass)
[![European Union](https://img.shields.io/badge/Supported%20By-%20The%20EU-004494.svg)]([https://wellcomeleap.org](https://cordis.europa.eu/project/id/101135876))
[![Discord Chat](https://img.shields.io/badge/dynamic/json?color=blue&label=Discord&query=approximate_presence_count&suffix=%20online.&url=https%3A%2F%2Fdiscord.com%2Fapi%2Finvites%2FJqVGmpkP96%3Fwith_counts%3Dtrue)](http://discord.unitary.fund)


# qlass
`qlass` is a package to compile quantum algorithms on photonic devices. Part of the Quantum Glass-based Photonic Integrated Circuits ([QLASS](https://www.qlass-project.eu/))
project funded by the European Union. 

## Installing `qlass`
The development install of `qlass` requirements can be done by setting the working directory to the top level of the repository and running `pip install -e .`. 
`qlass` builds upon open-source scientific software packages in Python: `scipy` for numerical optimization, `pyscf` and `qiskit-nature` for quantum chemistry, `qiskit` for quantum computing, and `perceval` for quantum photonics compilation.

## Getting started
You can use [this notebook on the variational quantum eigensolver (VQE)](https://github.com/unitaryfund/qlass/blob/main/photonic_vqe.ipynb) to get started with the `qlass` package, or check out the [example script](https://github.com/unitaryfoundation/qlass/blob/main/examples/vqe_example.py).

## Features

### Circuit Compilation

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

```python
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:

```python
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:

```python
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](https://qlass.readthedocs.io/en/latest/).

## Contributing
`qlass` is developed by the [Unitary Foundation](https://unitary.foundation/), in collaboration with QLASS performers.

You can join the UF [Discord server](http://discord.unitary.fund) 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.

