█▀▀█ █▀▀█ █▀▀ █▀▀ █▀▀▄
 █ ▄▄ █▄▄▀ █▀▀ █▀▀ █  █
 █▄▄█ ▀ ▀▀ ▀▀▀ ▀▀▀ ▀  ▀

 █▀▄▀█ █▀▀█ █▀▀▄ █  █     █▀▀█ █▀▀█ █▀▀▄ █  █ 　 ▀▀█▀▀ █▀▀█ █▀▀█ █   █▀▀
 █ █ █ █▄▄█ █  █ █▄▄█ ▀▀  █▀▀▄ █  █ █  █ █▄▄█ 　   █   █  █ █  █ █   ▀▀█
 █   █ ▀  ▀ ▀  ▀ ▄▄▄█     █▄▄█ ▀▀▀▀ ▀▀▀  ▄▄▄█ 　   █   ▀▀▀▀ ▀▀▀▀ ▀▀▀ ▀▀▀

===================

Python Tool Suite for Green's-function-based many-body calculations using Green Software Package.

Package contains two main modules:

• mint (Mean-field INput generation Toolkit): generates input files for Green/WeakCoupling using PySCF, ASE and SPGLib
• pesto (Post-processing Evaluation Software TOols): provides access to various post-processing tools such as analytical continuation, and Mulliken analysis.

Installation

• To install the green-mbtools binary package simply execute:

pip install green-mbtools

• To build from sources download the source code either from github or from PyPI and run:

python -m build

This will automatically build the Nevanlinna and Caratheodory extensions, which are written in C++.

Dependencies:

1. Python packages: numpy, scipy, h5py, green-ac, pyscf, ase, spglib, irbasis, cvxpy, and baryrat.
2. C++ libraries: Eigen, GMP, MPFR
3. pytest for testing
4. Maxent external C++ library needs to be built separately to run analytic continuation tasks using the maxent method.

Features

The mbtools package comes with two sub-packages: mint and pesto. The mint sub-package contains utilities for the following tasks:

• Generate input for Green/WeakCoupling.
• Compute molecular/natural orbitals.
• Mulliken analyasis based on symmetrical atomic orbitals.

On the other hand, the pesto sub-package, formerly known as the mbanalysis package, caters to:

• Fourier transformation between real and reciprocal space.
• Fourier transformation between imaginary-time and Matsuabara frequency domain on intermediate representation (IR) grids (see Phys. Rev. B 101, 035144 (2020) for further details).
• Wannier interpolation
• Maxent analytical continuation (External C++ library required: https://github.com/CQMP/Maxent)
• Nevanlinna analytical continuation, based on Fei et.al. Phys. Rev. Lett. 126, 056402 (2021).
• PES analytical continuation, based on Phys. Rev. B 107, 075151 (2023).
• Caratheodory analytical continuation for complex valued matrices, implemented as a C++ library based on Fei et.al. Phys. Rev. B 104, 165111 (2021).

Contirbutions to the code

• Most of the pesto source code was written by @cnyeh
• Nevanlinna analytic continuation was implemented by @jianiOnly
• Clean up and packaging of the code and extension modules, including Nevanlinna and Caratheodory, was performed by by @gauravharsha
• ES analytic continuation implemented by @gauravharsha
• Example for spaghetti diagrams for occupation numbers added by @pavel-po
• C++ wrapper to GMP and MPFR float numbers and packaging @iskakoff
• Green/WeakCoupling input generation @cnyeh and @iskakoff