Skip to main content

Python modules for electron-phonon models

Project description

DOI

Python modules for electron-phonon models

elphmod logo

  • el - tight-binding models from Wannier90
  • ph - mass-spring models from Quantum ESPRESSO
  • elph - electron-phonon coupling from EPW
  • elel - Coulomb interaction from VASP
  • 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/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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elphmod-0.17.tar.gz (116.4 kB view hashes)

Uploaded Source

Built Distribution

elphmod-0.17-py3-none-any.whl (116.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page