Metadata-Version: 2.1
Name: elphmod
Version: 0.21
Summary: Python modules for electron-phonon models
Home-page: https://github.com/janberges/elphmod
Author: elphmod Developers
Author-email: 
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=2.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy

[![DOI](https://zenodo.org/badge/330427606.svg)](https://zenodo.org/badge/latestdoi/330427606)

# Python modules for electron-phonon models

![elphmod logo](https://raw.githubusercontent.com/janberges/elphmod/master/logo/logo.svg)

* `el` - tight-binding models from Wannier90
* `ph` - mass-spring models from Quantum ESPRESSO
* `elph` - electron-phonon coupling from EPW
* `elel` - Coulomb interaction from RESPACK
* `MPI` - work distribution and shared memory
* `bravais` - lattices, symmetries, and interpolation
* `dispersion` - diagonalization on paths and meshes
* `dos` - 2D tetrahedron methods
* `diagrams` - susceptibilities, self-energies, etc.
* `occupations` - step and delta smearing functions
* `md` - charge-density-wave dynamics using i-PI
* `eliashberg` - parameters for McMillan's formula
* `plot` - BZ plots, fatbands, etc.
* `misc` - constants, status bars, parsing, etc.

## Installation

To install the latest version of elphmod:

    python3 -m pip install elphmod

Alternatively, to install the latest development version:

    python3 -m pip install git+https://github.com/janberges/elphmod

elphmod can optionally be run in parallel via MPI (with shared-memory support).
Using APT and pip, you can install the corresponding dependencies as follows:

    sudo apt install libopenmpi-dev
    python3 -m pip install mpi4py --no-binary=mpi4py

If you plan to work on elphmod itself, we recommend to download the complete
repository and also install the requirements of examples and documentation:

    git clone https://github.com/janberges/elphmod
    python3 -m pip install -r elphmod/requirements.txt

Also consider adding the absolute paths to `elphmod` and `elphmod/bin` to the
environment variables `PYTHONPATH` and `PATH`, respectively.

## Documentation

The documentation can be found at <https://janberges.github.io/elphmod>. It has
been automatically generated from the NumPy-style docstrings in the source code
using Sphinx:

    cd doc
    make html

Please also have a look at the examples.

## Licence

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.

Copyright (C) 2017-2023 elphmod Developers
