/OpenFermion-PySCF

OpenFermion plugin to interface with the electronic structure package PySCF.

Primary LanguagePythonApache License 2.0Apache-2.0

OpenFermion-PySCF

OpenFermion is an open source library (licensed under Apache 2) for compiling and analyzing quantum algorithms which simulate fermionic systems. This plugin library allows the electronic structure package PySCF (licensed under BSD-2-Clause) to interface with OpenFermion.

Installation

To start using OpenFermion-PySCF, first install PySCF. Then, to install the latest versions of OpenFermion and OpenFermion-PySCF (in development mode):

git clone https://github.com/quantumlib/OpenFermion-PySCF
cd OpenFermion-PySCF
python -m pip install -e .

Alternatively, to install the latest PyPI releases as libraries (in user mode):

python -m pip install --user openfermionpyscf

Also be sure to take a look at the ipython notebook demo.

How to contribute

We'd love to accept your contributions and patches to OpenFermion-PySCF. There are a few guidelines you need to follow. Contributions to OpenFermion-PySCF must be accompanied by a Contributor License Agreement. You (or your employer) retain the copyright to your contribution, this simply gives us permission to use and redistribute your contributions as part of the project. Head over to https://cla.developers.google.com/ to see your current agreements on file or to sign a new one.

All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests. Furthermore, please make sure your new code comes with extensive tests! We use automatic testing to make sure all pull requests pass tests and do not decrease overall test coverage by too much. Make sure you adhere to our style guide. Just have a look at our code for clues. We mostly follow PEP 8 and use the corresponding linter to check for it. Code should always come with documentation.

Authors

Ryan Babbush (Google), Jarrod McClean (Google), Kevin Sung (University of Michigan), Ian Kivlichan (Harvard), Dave Bacon (Google), Yudong Cao (Harvard), Chengyu Dai (University of Michigan), E. Schuyler Fried (Harvard), Craig Gidney (Google), Brendan Gimby (University of Michigan), Pranav Gokhale (University of Chicago), Thomas Häner (ETH Zurich), Tarini Hardikar (Dartmouth), Vojtĕch Havlíček (Oxford), Oscar Higgott (University College London), Cupjin Huang (University of Michigan), Josh Izaac (Xanadu), Zhang Jiang (NASA), Xinle Liu (Google), Sam McArdle (Oxford), Matthew Neeley (Google), Thomas O'Brien (Leiden University), Bryan O'Gorman (UC Berkeley, NASA), Isil Ozfidan (D-Wave Systems), Max Radin (UC Santa Barbara), Jhonathan Romero (Harvard), Nicholas Rubin (Google), Daniel Sank (Google), Nicolas Sawaya (Harvard), Kanav Setia (Dartmouth), Hannah Sim (Harvard), Damian Steiger (ETH Zurich), Mark Steudtner (Leiden University), Qiming Sun (Caltech), Wei Sun (Google), Daochen Wang (River Lane Research), Chris Winkler (University of Chicago) and Fang Zhang (University of Michigan).

How to cite

When using OpenFermion-PySCF for research projects, please cite:

Jarrod R. McClean, Kevin J. Sung, Ian D. Kivlichan, Yudong Cao, Chengyu Dai, E. Schuyler Fried, Craig Gidney, Brendan Gimby, Pranav Gokhale, Thomas Häner, Tarini Hardikar, Vojtĕch Havlíček, Oscar Higgott, Cupjin Huang, Josh Izaac, Zhang Jiang, Xinle Liu, Sam McArdle, Matthew Neeley, Thomas O'Brien, Bryan O'Gorman, Isil Ozfidan, Maxwell D. Radin, Jhonathan Romero, Nicholas Rubin, Nicolas P. D. Sawaya, Kanav Setia, Sukin Sim, Damian S. Steiger, Mark Steudtner, Qiming Sun, Wei Sun, Daochen Wang, Fang Zhang and Ryan Babbush. OpenFermion: The Electronic Structure Package for Quantum Computers. arXiv:1710.07629. 2017.

as well as

Qiming Sun, Timothy C. Berkelbach, Nick S. Blunt, George H. Booth, Sheng Guo, Zhendong Li, Junzi Liu, James McClain, Elvira. R. Sayfutyarova, Sandeep Sharma, Sebastian Wouters and Garnet Kin-Lic Chan. The Python-based Simulations of Chemistry Framework (PySCF). WIREs Compututational Molecular Science. 2017.

We are happy to include future contributors as authors on later OpenFermion releases.

Disclaimer

Copyright 2017 The OpenFermion Developers. This is not an official Google product.