[](https://travis-ci.org/SpM-lab)
irbasis
======
Open-source database and software for intermediate-representation basis functions of imaginary-time Green's function and Python and C++ libraries
Detailed instructions are available [online](https://github.com/SpM-lab/irbasis/wiki).
Please also check [our citation policy](https://github.com/SpM-lab/irbasis/wiki/Citation-policy).
Below we will briefly describe this software.
# Table of Contents
- [License](#license)
- [Structure](#structure)
- [Installation](#installation)
- [Usage](#usage)
## License
This software is released under the MIT License, see LICENSE.txt.
## Structure
We briefly describe files constituting this software below.
* c++/irbasis.hpp<br>C++ library
* python/irbasis.py<br>Python library
* database/irbasis.h5<br>Database file (Lambda=10,10<sup>2</sup>, 10<sup>3</sup>, 10<sup>4</sup>, 10<sup>5</sup>, 10<sup>6</sup>, 10<sup>7</sup>).
* sample/<br> Directory including samples in C++ and Python
* test/<br>Unit tests in C++ and Python
## Installation
### Python
You need to install only a few standard scientific libraries (such as numpy, h5py) shown in [our PyPI project page](https://pypi.org/project/irbasis/).
If you install irbasis through pip, pip will take care of these dependencies properly.
We strongly recommend to install the irbasis library using the standard Python package system.
This package contains the data file (irbasis.h5) as well.
```
python -mpip install -U pip
python -mpip install -U irbasis
```
Alternatively, we can put [irbasis.py](https://github.com/SpM-lab/irbasis/blob/master/python/irbasis.py) and [irbasis.h5](https://github.com/SpM-lab/irbasis/blob/master/database/irbasis.h5) into your working directory.
You can load irbasis and use the full functionality.
If you want run [sample Python scripts](Samples),
please also install additional Python packages (scipy, matplotlib) using the following command.
```
pip install scipy matplotlib
```
### C++
You need a C++03-compatible compiler.
The use of the C++ irbasis library requires only the HDF5 C library (not C++).
The C++ library consists of a single header file.
All what you need to do is to include [irbasis.hpp](https://github.com/SpM-lab/irbasis/blob/master/c++/irbasis.hpp) in your C++ project.
The data file [irbasis.h5](https://github.com/SpM-lab/irbasis/blob/master/database/irbasis.h5) will be read at runtime.
Please do not forget to link your executable to the HDF5 C library.
## Usage
In the following, we demonstrate how to use irbasis database.
The irbasis database is available in Python and C++.
irbasis can calculate the IR basis functions, its Fourier transform, the derivatives and corresponding singular values.
**In the following, we assume that you have installed the irbasis Python library via pip.**
If not, please modify the sample script files appropriately to specify the location of a database file (see a comment in api.py).
**Some of sample Python scripts depend on scipy and matplotlib.**
For other examples, please refer to our online document.
### Python
You can download [api.py](https://github.com/SpM-lab/irbasis/blob/master/sample/api.py)
and save it to your working directory.
Then, please run the following command.
```python
python api.py
```
You can study also our step-by-step examples in [a jupyter notebook](https://github.com/SpM-lab/irbasis/blob/master/sample/step_by_step_examples.ipynb).
### C++
You can download [api.cpp](https://github.com/SpM-lab/irbasis/blob/master/sample/api.cpp) and [step\_by\_step\_examples.cpp](https://github.com/SpM-lab/irbasis/blob/master/sample/step_by_step_examples.cpp) to your working directory.
After copying irbasis.hpp into the same directory,
you can build the sample program as follows (see [compile.sh](https://github.com/SpM-lab/irbasis/blob/master/sample/compile.sh)).
```c++
g++ api.cpp -o api -I /usr/local/include -L /usr/local/lib -lhdf5 -DNDEBUG -O3
g++ step_by_step_examples.cpp -o step_by_step_examples -I /usr/local/include -L /usr/local/lib -lhdf5 -DNDEBUG -O3
```
Here, we assume that the header file and the library file of the HDF5 C library are installed into "/usr/local/include" and "/usr/local/lib", respectively.
When running the executable, irbasis.h5 must exist in your working directory.
Raw data
{
"_id": null,
"home_page": "https://github.com/SpM-lab/irbasis",
"name": "irbasis",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "quantum many-body theory",
"author": "Kazuyoshi Yoshimi, Hiroshi Shinaoka, Chikano Naoya, Junya Otsuki, Markus Wallerberger",
"author_email": "h.shinaoka@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0b/48/73aab255d7746557eefdb6481f26bf89713f53c529d71235a8ff267cd35f/irbasis-2.2.3.tar.gz",
"platform": "",
"description": "[](https://travis-ci.org/SpM-lab)\n\nirbasis\n======\nOpen-source database and software for intermediate-representation basis functions of imaginary-time Green's function and Python and C++ libraries\n\nDetailed instructions are available [online](https://github.com/SpM-lab/irbasis/wiki).\nPlease also check [our citation policy](https://github.com/SpM-lab/irbasis/wiki/Citation-policy).\n\nBelow we will briefly describe this software.\n\n# Table of Contents\n- [License](#license)\n- [Structure](#structure)\n- [Installation](#installation)\n- [Usage](#usage)\n\n## License\nThis software is released under the MIT License, see LICENSE.txt. \n\n## Structure\nWe briefly describe files constituting this software below.\n\n* c++/irbasis.hpp<br>C++ library\n* python/irbasis.py<br>Python library\n* database/irbasis.h5<br>Database file (Lambda=10,10<sup>2</sup>, 10<sup>3</sup>, 10<sup>4</sup>, 10<sup>5</sup>, 10<sup>6</sup>, 10<sup>7</sup>).\n* sample/<br> Directory including samples in C++ and Python\n* test/<br>Unit tests in C++ and Python\n\n## Installation\n### Python\n\nYou need to install only a few standard scientific libraries (such as numpy, h5py) shown in [our PyPI project page](https://pypi.org/project/irbasis/).\nIf you install irbasis through pip, pip will take care of these dependencies properly.\n\nWe strongly recommend to install the irbasis library using the standard Python package system.\nThis package contains the data file (irbasis.h5) as well.\n```\npython -mpip install -U pip\npython -mpip install -U irbasis\n```\n\nAlternatively, we can put [irbasis.py](https://github.com/SpM-lab/irbasis/blob/master/python/irbasis.py) and [irbasis.h5](https://github.com/SpM-lab/irbasis/blob/master/database/irbasis.h5) into your working directory.\nYou can load irbasis and use the full functionality.\n\nIf you want run [sample Python scripts](Samples),\nplease also install additional Python packages (scipy, matplotlib) using the following command.\n\n```\npip install scipy matplotlib\n```\n\n\n### C++\n\nYou need a C++03-compatible compiler.\nThe use of the C++ irbasis library requires only the HDF5 C library (not C++).\n\nThe C++ library consists of a single header file.\nAll what you need to do is to include [irbasis.hpp](https://github.com/SpM-lab/irbasis/blob/master/c++/irbasis.hpp) in your C++ project.\nThe data file [irbasis.h5](https://github.com/SpM-lab/irbasis/blob/master/database/irbasis.h5) will be read at runtime.\nPlease do not forget to link your executable to the HDF5 C library.\n\n\n## Usage\nIn the following, we demonstrate how to use irbasis database.\nThe irbasis database is available in Python and C++.\nirbasis can calculate the IR basis functions, its Fourier transform, the derivatives and corresponding singular values.\n\n**In the following, we assume that you have installed the irbasis Python library via pip.**\nIf not, please modify the sample script files appropriately to specify the location of a database file (see a comment in api.py).\n\n**Some of sample Python scripts depend on scipy and matplotlib.**\n\nFor other examples, please refer to our online document.\n\n### Python\nYou can download [api.py](https://github.com/SpM-lab/irbasis/blob/master/sample/api.py)\nand save it to your working directory.\nThen, please run the following command.\n\n```python\npython api.py\n```\n\nYou can study also our step-by-step examples in [a jupyter notebook](https://github.com/SpM-lab/irbasis/blob/master/sample/step_by_step_examples.ipynb).\n\n### C++\nYou can download [api.cpp](https://github.com/SpM-lab/irbasis/blob/master/sample/api.cpp) and [step\\_by\\_step\\_examples.cpp](https://github.com/SpM-lab/irbasis/blob/master/sample/step_by_step_examples.cpp) to your working directory.\nAfter copying irbasis.hpp into the same directory,\nyou can build the sample program as follows (see [compile.sh](https://github.com/SpM-lab/irbasis/blob/master/sample/compile.sh)).\n\n```c++\ng++ api.cpp -o api -I /usr/local/include -L /usr/local/lib -lhdf5 -DNDEBUG -O3\ng++ step_by_step_examples.cpp -o step_by_step_examples -I /usr/local/include -L /usr/local/lib -lhdf5 -DNDEBUG -O3\n```\n\nHere, we assume that the header file and the library file of the HDF5 C library are installed into \"/usr/local/include\" and \"/usr/local/lib\", respectively.\nWhen running the executable, irbasis.h5 must exist in your working directory.\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Python libraries for irbasis",
"version": "2.2.3",
"project_urls": {
"Homepage": "https://github.com/SpM-lab/irbasis"
},
"split_keywords": [
"quantum",
"many-body",
"theory"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c8681d8c360e6412aa33e97011a8399efd47b0f52d73694ccdce134f0f3b204e",
"md5": "c14293405294874af252ea2aa79de3c0",
"sha256": "51d96e8853d34185e1eed2d21b2839f984257a3579a3f2c4722cd2339c79da59"
},
"downloads": -1,
"filename": "irbasis-2.2.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "c14293405294874af252ea2aa79de3c0",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 22569853,
"upload_time": "2020-09-03T05:52:04",
"upload_time_iso_8601": "2020-09-03T05:52:04.924795Z",
"url": "https://files.pythonhosted.org/packages/c8/68/1d8c360e6412aa33e97011a8399efd47b0f52d73694ccdce134f0f3b204e/irbasis-2.2.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0b4873aab255d7746557eefdb6481f26bf89713f53c529d71235a8ff267cd35f",
"md5": "bbf27f09621632dddb88c42c35e224f5",
"sha256": "d3782a9d595621bb73e70d0ce5eb38c186631e9e3418e26f4db9608d9b3ee339"
},
"downloads": -1,
"filename": "irbasis-2.2.3.tar.gz",
"has_sig": false,
"md5_digest": "bbf27f09621632dddb88c42c35e224f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 22570209,
"upload_time": "2020-09-04T00:55:10",
"upload_time_iso_8601": "2020-09-04T00:55:10.069835Z",
"url": "https://files.pythonhosted.org/packages/0b/48/73aab255d7746557eefdb6481f26bf89713f53c529d71235a8ff267cd35f/irbasis-2.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2020-09-04 00:55:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SpM-lab",
"github_project": "irbasis",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "irbasis"
}
JSON
