# PyTorch-based Libcint Interface
<table>
<tr>
<td>Compatibility:</td>
<td>
<img src="https://img.shields.io/badge/Python-3.8%20|%203.9%20|%203.10%20|%203.11-blue.svg" alt="Python Versions"/>
<img src="https://img.shields.io/badge/PyTorch-%3E=1.11.0-blue.svg" alt="PyTorch Versions"/>
<img src="https://img.shields.io/badge/OS-Linux-blue.svg" alt="Operating Systems">
</td>
</tr>
<tr>
<td>Availability:</td>
<td>
<a href="https://github.com/tad-mctc/tad-libcint/releases/latest">
<img src="https://img.shields.io/github/v/release/tad-mctc/tad-libcint?color=orange" alt="Release"/>
</a>
<a href="https://pypi.org/project/tad-libcint/">
<img src="https://img.shields.io/pypi/v/tad-libcint?color=orange" alt="PyPI"/>
</a>
<a href="http://www.apache.org/licenses/LICENSE-2.0">
<img src="https://img.shields.io/badge/License-Apache%202.0-orange.svg" alt="Apache-2.0"/>
</a>
</td>
</tr>
<tr>
<td>Status:</td>
<td>
<a href="https://github.com/tad-mctc/tad-libcint/actions/workflows/python.yaml">
<img src="https://github.com/tad-mctc/tad-libcint/actions/workflows/python.yaml/badge.svg" alt="Test Status"/>
</a>
<a href="https://github.com/tad-mctc/tad-libcint/actions/workflows/release.yaml">
<img src="https://github.com/tad-mctc/tad-libcint/actions/workflows/release.yaml/badge.svg" alt="Build Status"/>
</a>
<a href="https://tad-libcint.readthedocs.io">
<img src="https://readthedocs.org/projects/tad-libcint/badge/?version=latest" alt="Documentation Status"/>
</a>
<a href="https://results.pre-commit.ci/latest/github/tad-mctc/tad-libcint/main">
<img src="https://results.pre-commit.ci/badge/github/tad-mctc/tad-libcint/main.svg" alt="pre-commit.ci Status"/>
</a>
<a href="https://codecov.io/gh/tad-mctc/tad-libcint">
<img src="https://codecov.io/gh/tad-mctc/tad-libcint/branch/main/graph/badge.svg?token=9faLOhisRx" alt="Coverage"/>
</a>
</td>
</tr>
</table>
## Content
This package contains a PyTorch-based interface to the *[libcint](https://github.com/sunqm/libcint)* high-performance integral library.
The interface facilitates automatic differentiation with custom backward functions that call *libcint*'s C backend for derivative calculation.
It is based on [PySCF's lib directory](https://github.com/pyscf/pyscf/tree/master/pyscf/lib). Modifications include
- removal of unnecessary code
- minor adaptation of build instructions (CMakeLists.txt)
The project was heavily inspired by *[diffqc/dqc](https://github.com/diffqc/dqc)* and *[diffqc/dqclibs](https://github.com/diffqc/dqclibs)*.
This interface was mainly written for the calculation of integrals within *[grimme-lab/dxtb](https://github.com/grimme-lab/dxtb)*.
## Installation
### pip
The `tad-libcint` package can be obtained from pip.
```console
pip install tad-libcint
```
### Build from source
You can also build the Python wheels from source.
1. Get the repository (including libcint submodule).
```console
git clone --recursive git@github.com:grimme-lab/tad-libcint.git
cd tad-libcint
```
The [libcint fork](https://github.com/tad-mctc/libcint/tree/dxtb) contains some additional integrals required for `dxtb`. Therefore, downloading from our fork is recommended.
If you already have the repository, you can update the submodule with
```console
git submodule update --remote
```
2. Create an environment (`conda`) for building the wheels. The example here uses Python 3.10, but we support 3.8-3.11.
```console
mamba create -n wheel-310 --yes python=3.10 auditwheel c-compiler cxx-compiler fortran-compiler cffi cmake git make meson ninja numpy patchelf pkgconfig pip python-build unzip wheel
mamba activate wheel-310
```
3. Build the wheel on your system.
```console
python -m build --wheel
```
4. Repair the wheels for cross-distribution packaging.
```console
auditwheel repair -w wheels --plat manylinux_2_12_x86_64 dist/*-cp310-cp310-linux_x86_64.whl
```
5. Or only install this project with `pip` in the environment.
```console
pip install .
```
## Development
For development, additionally install the following tools in your environment.
```console
mamba install black covdefaults coverage mypy pre-commit pylint tox
```
With pip, add the option `-e` for installing in development mode, and add `[dev]` for the development dependencies
```console
pip install -e .[dev]
```
The pre-commit hooks are initialized by running the following command in the root of the repository.
```console
pre-commit install
```
For testing all Python environments, simply run `tox`.
```console
tox
```
Note that this randomizes the order of tests but skips "large" tests. To modify this behavior, `tox` has to skip the optional *posargs*.
```console
tox -- test
```
Raw data
{
"_id": null,
"home_page": "https://github.com/tad-mctc/tad-libcint/",
"name": "tad-libcint",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "tight-binding, quantum-chemistry, integrals, library",
"author": "\"Marvin Friede\"",
"author_email": "friede@thch.uni-bonn.de",
"download_url": "https://files.pythonhosted.org/packages/0b/24/bb40fbad0fb7bc0f61ad1305e633221e1474b5ada67ce9aaf4a76c3e1b6b/tad_libcint-0.0.1.tar.gz",
"platform": null,
"description": "# PyTorch-based Libcint Interface\n\n<table>\n <tr>\n <td>Compatibility:</td>\n <td>\n <img src=\"https://img.shields.io/badge/Python-3.8%20|%203.9%20|%203.10%20|%203.11-blue.svg\" alt=\"Python Versions\"/>\n <img src=\"https://img.shields.io/badge/PyTorch-%3E=1.11.0-blue.svg\" alt=\"PyTorch Versions\"/>\n <img src=\"https://img.shields.io/badge/OS-Linux-blue.svg\" alt=\"Operating Systems\">\n </td>\n </tr>\n <tr>\n <td>Availability:</td>\n <td>\n <a href=\"https://github.com/tad-mctc/tad-libcint/releases/latest\">\n <img src=\"https://img.shields.io/github/v/release/tad-mctc/tad-libcint?color=orange\" alt=\"Release\"/>\n </a>\n <a href=\"https://pypi.org/project/tad-libcint/\">\n <img src=\"https://img.shields.io/pypi/v/tad-libcint?color=orange\" alt=\"PyPI\"/>\n </a>\n <a href=\"http://www.apache.org/licenses/LICENSE-2.0\">\n <img src=\"https://img.shields.io/badge/License-Apache%202.0-orange.svg\" alt=\"Apache-2.0\"/>\n </a>\n </td>\n </tr>\n <tr>\n <td>Status:</td>\n <td>\n <a href=\"https://github.com/tad-mctc/tad-libcint/actions/workflows/python.yaml\">\n <img src=\"https://github.com/tad-mctc/tad-libcint/actions/workflows/python.yaml/badge.svg\" alt=\"Test Status\"/>\n </a>\n <a href=\"https://github.com/tad-mctc/tad-libcint/actions/workflows/release.yaml\">\n <img src=\"https://github.com/tad-mctc/tad-libcint/actions/workflows/release.yaml/badge.svg\" alt=\"Build Status\"/>\n </a>\n <a href=\"https://tad-libcint.readthedocs.io\">\n <img src=\"https://readthedocs.org/projects/tad-libcint/badge/?version=latest\" alt=\"Documentation Status\"/>\n </a>\n <a href=\"https://results.pre-commit.ci/latest/github/tad-mctc/tad-libcint/main\">\n <img src=\"https://results.pre-commit.ci/badge/github/tad-mctc/tad-libcint/main.svg\" alt=\"pre-commit.ci Status\"/>\n </a>\n <a href=\"https://codecov.io/gh/tad-mctc/tad-libcint\">\n <img src=\"https://codecov.io/gh/tad-mctc/tad-libcint/branch/main/graph/badge.svg?token=9faLOhisRx\" alt=\"Coverage\"/>\n </a>\n </td>\n </tr>\n</table>\n\n\n## Content\n\nThis package contains a PyTorch-based interface to the *[libcint](https://github.com/sunqm/libcint)* high-performance integral library.\nThe interface facilitates automatic differentiation with custom backward functions that call *libcint*'s C backend for derivative calculation.\n\nIt is based on [PySCF's lib directory](https://github.com/pyscf/pyscf/tree/master/pyscf/lib). Modifications include\n\n- removal of unnecessary code\n- minor adaptation of build instructions (CMakeLists.txt)\n\nThe project was heavily inspired by *[diffqc/dqc](https://github.com/diffqc/dqc)* and *[diffqc/dqclibs](https://github.com/diffqc/dqclibs)*.\n\nThis interface was mainly written for the calculation of integrals within *[grimme-lab/dxtb](https://github.com/grimme-lab/dxtb)*.\n\n## Installation\n\n### pip\n\nThe `tad-libcint` package can be obtained from pip.\n\n```console\npip install tad-libcint\n```\n\n### Build from source\n\nYou can also build the Python wheels from source.\n\n1. Get the repository (including libcint submodule).\n\n```console\ngit clone --recursive git@github.com:grimme-lab/tad-libcint.git\ncd tad-libcint\n```\n\nThe [libcint fork](https://github.com/tad-mctc/libcint/tree/dxtb) contains some additional integrals required for `dxtb`. Therefore, downloading from our fork is recommended.\n\nIf you already have the repository, you can update the submodule with\n\n```console\ngit submodule update --remote\n```\n\n2. Create an environment (`conda`) for building the wheels. The example here uses Python 3.10, but we support 3.8-3.11.\n\n```console\nmamba create -n wheel-310 --yes python=3.10 auditwheel c-compiler cxx-compiler fortran-compiler cffi cmake git make meson ninja numpy patchelf pkgconfig pip python-build unzip wheel\nmamba activate wheel-310\n```\n\n3. Build the wheel on your system.\n\n```console\npython -m build --wheel\n```\n\n4. Repair the wheels for cross-distribution packaging.\n\n```console\nauditwheel repair -w wheels --plat manylinux_2_12_x86_64 dist/*-cp310-cp310-linux_x86_64.whl\n```\n\n5. Or only install this project with `pip` in the environment.\n\n```console\npip install .\n```\n\n\n## Development\n\nFor development, additionally install the following tools in your environment.\n\n```console\nmamba install black covdefaults coverage mypy pre-commit pylint tox\n```\n\nWith pip, add the option `-e` for installing in development mode, and add `[dev]` for the development dependencies\n\n```console\npip install -e .[dev]\n```\n\nThe pre-commit hooks are initialized by running the following command in the root of the repository.\n\n```console\npre-commit install\n```\n\nFor testing all Python environments, simply run `tox`.\n\n```console\ntox\n```\n\nNote that this randomizes the order of tests but skips \"large\" tests. To modify this behavior, `tox` has to skip the optional *posargs*.\n\n```console\ntox -- test\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "\"Torch Autodiff Libcint Interface\"",
"version": "0.0.1",
"project_urls": {
"Documentation": "https://github.com/tad-mctc/tad-libcint",
"Homepage": "https://github.com/tad-mctc/tad-libcint/",
"Source Code": "https://github.com/tad-mctc/tad-libcint",
"Tracker": "https://github.com/tad-mctc/tad-libcint/issues"
},
"split_keywords": [
"tight-binding",
" quantum-chemistry",
" integrals",
" library"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a3b68d22daf2a49055065ba4b44edb5f6ff4461db7a0d73f9e963d10e337a82b",
"md5": "9561b802dfed4ca14d9a36a76fd6de8e",
"sha256": "6d47f9aeeea99980696b97c954ef48c157deb8043baf11af042c1bc9bb6569e8"
},
"downloads": -1,
"filename": "tad_libcint-0.0.1-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"has_sig": false,
"md5_digest": "9561b802dfed4ca14d9a36a76fd6de8e",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.8",
"size": 19853847,
"upload_time": "2024-04-12T06:25:11",
"upload_time_iso_8601": "2024-04-12T06:25:11.635471Z",
"url": "https://files.pythonhosted.org/packages/a3/b6/8d22daf2a49055065ba4b44edb5f6ff4461db7a0d73f9e963d10e337a82b/tad_libcint-0.0.1-cp310-cp310-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2b933ecdbfcae41cece3904e16fdb9560faebd32367bbf8384033ed59a443a3c",
"md5": "ca3d3dc653857287c90adb69dfecca36",
"sha256": "3a8e5fd472e1b14967ba79ff8ea47a27a66b1a8d5c9f023fbcd70214e8eb621a"
},
"downloads": -1,
"filename": "tad_libcint-0.0.1-cp311-cp311-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"has_sig": false,
"md5_digest": "ca3d3dc653857287c90adb69dfecca36",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": ">=3.8",
"size": 19853846,
"upload_time": "2024-04-12T06:25:29",
"upload_time_iso_8601": "2024-04-12T06:25:29.401894Z",
"url": "https://files.pythonhosted.org/packages/2b/93/3ecdbfcae41cece3904e16fdb9560faebd32367bbf8384033ed59a443a3c/tad_libcint-0.0.1-cp311-cp311-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6e6bfd30725653aa3201b988e2e81ea9e4629e2480c89ffec69a7b26f3b05fac",
"md5": "10fcd3622082871ea7ca655a34f6e7eb",
"sha256": "5fdc7fc9de9769afb852a26774981068a60299dbc0720bbdcd0e15ad6f2eb3d5"
},
"downloads": -1,
"filename": "tad_libcint-0.0.1-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"has_sig": false,
"md5_digest": "10fcd3622082871ea7ca655a34f6e7eb",
"packagetype": "bdist_wheel",
"python_version": "cp38",
"requires_python": ">=3.8",
"size": 19853840,
"upload_time": "2024-04-12T06:24:34",
"upload_time_iso_8601": "2024-04-12T06:24:34.352286Z",
"url": "https://files.pythonhosted.org/packages/6e/6b/fd30725653aa3201b988e2e81ea9e4629e2480c89ffec69a7b26f3b05fac/tad_libcint-0.0.1-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2a0463cf6d2514af3ca8aab0a33176139ed10139cd5f94a94a9e17773e4f6f26",
"md5": "d0294188a2a0d8a09c2338ca984cb5e6",
"sha256": "7963c3996c805726c9a0397403b90647cf31e2d3bff21025186725bcb1d7e9ae"
},
"downloads": -1,
"filename": "tad_libcint-0.0.1-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"has_sig": false,
"md5_digest": "d0294188a2a0d8a09c2338ca984cb5e6",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.8",
"size": 19853835,
"upload_time": "2024-04-12T06:24:52",
"upload_time_iso_8601": "2024-04-12T06:24:52.738450Z",
"url": "https://files.pythonhosted.org/packages/2a/04/63cf6d2514af3ca8aab0a33176139ed10139cd5f94a94a9e17773e4f6f26/tad_libcint-0.0.1-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0b24bb40fbad0fb7bc0f61ad1305e633221e1474b5ada67ce9aaf4a76c3e1b6b",
"md5": "454cd18e240743018c432ca76df5292e",
"sha256": "0c60ee7136b17cb2dc42c552033e6596217bc02939695ec3679da554fbef4922"
},
"downloads": -1,
"filename": "tad_libcint-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "454cd18e240743018c432ca76df5292e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 43857383,
"upload_time": "2024-04-12T06:33:53",
"upload_time_iso_8601": "2024-04-12T06:33:53.184530Z",
"url": "https://files.pythonhosted.org/packages/0b/24/bb40fbad0fb7bc0f61ad1305e633221e1474b5ada67ce9aaf4a76c3e1b6b/tad_libcint-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-12 06:33:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tad-mctc",
"github_project": "tad-libcint",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "tad-libcint"
}