qclatticeh
Definition of the Hamiltonian for a lattice model suitable for quantum devices
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 2 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org, springer.com, aps.org, zenodo.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (18.9%) to scientific vocabulary
Repository
Definition of the Hamiltonian for a lattice model suitable for quantum devices
Basic Info
- Host: GitHub
- Owner: ariannacrippa
- License: mit
- Language: Jupyter Notebook
- Default Branch: main
- Size: 10.2 MB
Statistics
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 3
- Releases: 1
Metadata Files
README.md
Lattice QED Hamiltonian for Quantum Computing
This repository contains useful Python functions and classes for seamlessly designing and obtaining Quantum Electrodynamic (QED) Hamiltonians for 1D, 2D or 3D lattices with staggered fermionic degrees of freedom, i.e., Kogut and Susskind formulation[^1].
The implementation is useful for carrying out research on QED quantum simulation assisted by quantum computing and quantum algorithms, as well as for analysis and comparison with known exact-diagonalization (ED) methods. In turn, the classes in this module are compatible with exact diagonalization libraries and the Qiskit library.
Related work: - Analysis of the confinement string in (2 + 1)-dimensional Quantum Electrodynamics with a trapped-ion quantum computer - Towards determining the (2+1)-dimensional Quantum Electrodynamics running coupling with Monte Carlo and quantum computing methods
Installation
This source code is now available at PyPI as a package for quick installation and usage. One can simply pip install it with the command below:
console
pip install qclatticeh
Note: if you are not using a python environment (recommended), you may need to use the pip3 command instead of pip in MacOS and Linux.
Manual Installation through Github
It may be useful to some researchers to adapt the current package to their own models. In that case, a manual installation may be easier for making changes in the hamiltonian formulation.
Clone
The first step is to download the latest stable release of this package below and unzip de file.
Altenatively, you can clone this repo for development builds:
console
git clone https://github.com/ariannacrippa/QC_lattice_H.git
Virtual Environment
Before installing this package manually, make sure you have made a dedicated Python virtual environment and installed all required dependencies.
There are many distinct ways of creating Python environments which might be suitable for different applications, e.g., Anaconda, Miniconda, PyEnv, Venv, and others. Use the one that best suits your needs.
For convenience purposes, we provide an example of how to create and activate a simple environment using Venv:
Unix Systems (Zsh and Bash):
bash
python3 -m venv qc_lattice_h && source qc_lattice_h/bin/activate
Windows:
bash
python -m venv qc_lattice_h && qc_lattice_h/Scripts/activate
To leave this environment, simply run 'deactivate'.
Dependencies
General Dependencies:
numpy,matplotlib,networkx,sympy,iteration_utilitiesFor Exact Diagonalization:
scipyFor Quantum Computation:
qiskit,qiskit.quantum_info
It is possible to install all dependencies with the command below:
bash
pip install numpy matplotlib networkx sympy scipy qiskit iteration_utilities
Manual installation
You can use pip to carry out the manual installation. With your python environment activated, run:
console
pip install .
Usage
This module consists of three main Python classes found in three separate submodules, as explained below, each focused on a particular component of QED Hamiltonian creation.
Important Submodules
- 'lattice' link to source code
-Contains a python class 'HCLattice' that builds a lattice in generic N dimensions, with periodic or open boundary conditions.
It finds the set of links and sites, builds plaquettes and chains for Jordan-Wigner[^2] definition (version up to 3D).
- 'hamiltonian' link to source code
-Has a python class 'HamiltonianQED_sym' that builds a symbolic expression of QED Hamiltonian N-dimensional lattice, both with open and periodic boundary conditions. The formulation considered is from Kogut and Susskind and the Gauss’ law can be applied.
By doing so, it results in a gauge-invariant system, reducing the number of dynamical links needed for the computation, leading to a resource-efficient Hamiltonian.
It is also possible to consider a formulation for a magnetic basis[^3].
-Also contains a 'HamiltonianQED_oprt' class. It imports the Hamiltonian from symbolic expression and builds its respective operator form (sparse matrices or PauliOp, suitable for qiskit quantum circuits).
It considers two types of encoding: ed returns sparse matrix; gray with option sparse=False returns PauliOp expression. Otherwise, a sparse matrix is returned.
- 'circuits' link to source code
-Contains an 'Ansatz' class. Consists of ansaetze proposals of variational circuits for Gray encoding (for gauge fields) and zero-charge sector (for fermionic degrees of freedom).
Importing classes
As shorthand, you can import all the classes into your python project as below.
python
from qclatticeh.lattice import HCLattice
from qclatticeh.hamiltonian import HamiltonianQED_sym, HamiltonianQED_oprt
from qclatticeh.circuits import Ansatz
Migration Guide
In case you were using older versions of this source code before packaging, you may have imported the same python classes as seen below:
python
import sys
sys.path.append("../") # go to parent dir
from Hamiltonian_QED_sym import HamiltonianQED_sym
from Hamiltonian_QED_oprt import HamiltonianQED_oprt
from HC_Lattice import HCLattice
from Ansaetze import Ansatz
You can simply replace the imports with the new package import commands, and most of the old functionality and codebase should work successfully:
python
from qclatticeh.lattice import HCLattice
from qclatticeh.hamiltonian import HamiltonianQED_sym, HamiltonianQED_oprt
from qclatticeh.circuits import Ansatz
Examples
For code examples illustrating a typical workflow with this module, please refer to the notebooks folder and the Jupyter Notebooks examples there:
- Test class Hamiltonian symbolic and operators
- Test class lattices
- Test class Ansaetze
- Qiskit VQE example
For an example of Hamiltonian design, let us consider a 2x2 OBC system as in the following figure:
where the black arrow represents the gauge field that remains dynamical after Gauss law is applied, i.e.
$$- E{00x} - E{00y} - q_{00} = 0 $$
$$ E{00y} - E{01x} - q_{01} = 0 $$
$$ E{00x} - E{10y} - q_{10} = 0 $$
$$ E{01x} + E{10y} - q_{11} = 0 $$
$$ q{00} + q{01} + q{10} + q{11} = 0. $$
After this step, the Hamiltonian will be:
$$ H{E} = \frac{g^{2} \left(E{10y}^{2} + \left(- E{10y} + q{11}\right)^{2} + \left(E{10y} + q{10}\right)^{2} + \left(- E{10y} + q{01} + q_{11}\right)^{2}\right)}{2} $$
for the electric part,
$$ H{B} = - \frac{U{10y} + h.c.}{2 g^{2}} $$
for magnetic. If matter fields are considered, then we have a mass term
$$ H{m} = m \left(\Phi{1}^{\dagger} \Phi{1} - \Phi{2}^{\dagger} \Phi{2} + \Phi{3}^{\dagger} \Phi{3} - \Phi{4}^{\dagger} \Phi_{4}\right) $$
and a kinetic term
$$ H{K} = \Omega \left(0.5 i \left(- h.c.(x) + \Phi{1}^{\dagger} \Phi{2} + \Phi{4}^{\dagger} \Phi{3}\right) - 0.5 \left(h.c.(y) + \Phi{1}^{\dagger} \Phi{4} - \Phi{2}^{\dagger} U{10y}^{\dagger} \Phi{3}\right)\right). $$
One can visualize the Hamiltonian and then decide which encoding to use and if the final expression must be written in terms of Qiskit's Pauli operators.
It is also possible to put static charges on the sites and study the static potential.
To encode the fermions for a quantum circuit implementation we consider the Jordan-Wigner formulation with:
$$ \begin{aligned}\Phij &= \prod{k} (-i\sigma^zk) \sigma^{+}j , \quad \text{where } k < j, \end{aligned} $$
$$ \begin{aligned}\Phij^{\dagger}&= \prod{k} (i\sigma^zk) \sigma^{-}j, \quad \text{where } k < j. \end{aligned} $$
The dynamical charges can be written as
$$q{\vec{n}} = \Phi^{\dagger} \Phi-\frac{1}{2}(1+(-1)^{n{x} +n{y} + 1}) \ \to \ \ \begin{cases} \frac{I-\sigma{z}}{2}, & \text{if $\vec{n}$ even}\ -\frac{I+\sigma_{z}}{2}, & \text{if $\vec{n}$ odd} \end{cases}$$
Gray circuit
After discretizing and truncating the U(1) gauge group to the discrete group Z(2l+1), the gauge fields can be represented in the electric basis as
$$ \hat{E} = \sum_{i=-l}^l i \ket{i}\bra{i}, $$
$$ \hat{U} = \sum_{i=-l}^{l-1} \ket{i+1}\bra{i}, $$
$$ \hat{U^\dagger} = \sum_{i=-l+1}^l \ket{i-1}\bra{i}, $$
$$\text{where}\ket{i}=\ket{i}_{\text{ph}} $$.
For numerical calculations, it is advantageous to employ a suitable encoding that accurately represents the physical values of the gauge fields.
In this work, we consider the Gray encoding.
For the truncation l=1, we can use the circuit in the following Figure to represent a gauge field.
The action of the circuit is straightforward: starting from the state |00>, setting both parameters θ1 and θ2 to zero allows for the exploration of the physical state |-1>. The introduction of a non-zero value for θ1 allows the state to change to |01>, which represents the physical vacuum state |0>, with a certain probability. A complete rotation occurs if θ1 = π, resulting in the exclusive presence of the second state with a probability of 1.0. Subsequently, the second controlled gate operates only when the first qubit is |1>, limiting the exploration to |11> (i.e., physical |1>) and excluding |10>.
Circuits for larger truncations (l=3,7,15) are:
Fermionic circuit
For simulating the fermionic degrees of freedom we employ the iSWAP gate, see Ref.[^4].
Feedback and Bugs
If any bugs related to installation, usage and workflow are encountered, and in case of suggestions for improvements and new features, please open a New Issue
Contributing
To assist with potential contributions, please submit a Pull Request.
License
References
[^1]: Lattice fermions L Susskind - Physical Review D, 1977 - APS [^2]: P. Jordan and E. P. Wigner, Über das paulische äquivalenzverbot, in The Collected Works of Eugene Paul Wigner (Springer, New York, 1993), pp. 109–129 [^3]: JF Haase, L Dellantonio, A Celi, D Paulson, A Kan, K Jansen, CA Muschik Quantum, 2021•quantum-journal.org [^4]: D. Paulson, L. Dellantonio, J. F. Haase, A. Celi, A. Kan, A. Jena, C. Kokail, R. van Bijnen, K. Jansen, P. Zoller, C. A. Muschik, arXiv:2008.09252
Owner
- Name: Arianna Crippa
- Login: ariannacrippa
- Kind: user
- Repositories: 2
- Profile: https://github.com/ariannacrippa
Citation (CITATION.cff)
cff-version: 1.2.0 message: "If you use this software in your research, please consider citing it as below." authors: - family-names: "Crippa" given-names: "Arianna" orcid: "https://orcid.org/0000-0003-2376-5682" - family-names: "Itaborai" given-names: "Paulo Vitor" orcid: "https://orcid.org/0000-0002-4956-2958" - family-names: "Rosanowski" given-names: "Emil" orcid: "https://orcid.org/0009-0002-4072-2801" title: "Lattice QED Hamiltonian for Quantum Computing" version: 0.1.0 doi: 10.5281/zenodo.11046038 date-released: 2025-05-28 url: "https://github.com/ariannacrippa/QC_lattice_H"
GitHub Events
Total
- Issues event: 2
- Watch event: 2
- Delete event: 1
- Push event: 28
- Pull request review event: 1
- Pull request event: 5
- Create event: 3
Last Year
- Issues event: 2
- Watch event: 2
- Delete event: 1
- Push event: 28
- Pull request review event: 1
- Pull request event: 5
- Create event: 3
Packages
- Total packages: 1
-
Total downloads:
- pypi 43 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 4
- Total maintainers: 3
pypi.org: qclatticeh
Lattice QED Hamiltonian for Quantum Computing
- Documentation: https://github.com/ariannacrippa/QC_lattice_H#readme
- License: mit
-
Latest release: 0.1.0
published 10 months ago