We hope the HamLib dataset is a useful resource for you.

We kindly ask that you include a citation to the HamLib paper in any work that makes use of the HamLib dataset, either in whole or in part. A BibTeX string is included below.

The HamLib authors.


@misc{hamlib,
      title={HamLib: A library of Hamiltonians for benchmarking quantum algorithms and hardware}, 
      author={Nicolas PD Sawaya and Daniel Marti-Dafcik and Yang Ho and Daniel P Tabor and David E Bernal Neira and Alicia B Magann and Shavindra Premaratne and Pradeep Dubey and Anne Matsuura and Nathan Bishop and Wibe A de Jong and Simon Benjamin and Ojas D Parekh and Norm Tubman and Katherine Klymko and Daan Camps},
      year={2024},
      eprint={2306.13126},
      archivePrefix={arXiv},
      primaryClass={quant-ph},
      url={https://arxiv.org/abs/2306.13126}, 
}


Release history:
----------------

* v1.0: June 2023
       * first release!

* v1.1: August 2024

        Changelog:
        ---------
        * added of attributes "nqubits", "terms", "one_norm" to qubit hamiltonians 
        * attributes summarized in CSV files and histogram plots throughout library
        * removed the chemistry/vibrational/old directory
        * biqmac hamiltonians in qmaxcut and maxcut changed from tar.gz to zip archives
        * qiskit SparsePauliOp support in hamlib_snippets.py
        * removed incorrect keys from:
            * condensedmatter/bosehubbard/BH_D-2_d-8.zip
            * condensedmatter/bosehubbard/BH_D-3_d-8.zip
            * binaryoptimization/qmaxcut/ciqube/Karloff-hams.zip
        * improved uniformity of zip file name and structures across dataset
        * removed the H70 and H80 hydrogen chains due to file corruption