Sovereign 8s.is mirror of standardgalactic/ElePhAny.jl
  • Julia 91.9%
  • Python 6.8%
  • Shell 1.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Aleksandr bdc03d137a
Some checks failed
CI / Julia 1.9 - ubuntu-latest - x64 - push (push) Has been cancelled
CI / Julia 1 - ubuntu-latest - x64 - push (push) Has been cancelled
Documentation / build (push) Has been cancelled
fixed the EPW example of si for #8
2026-01-26 11:05:29 +01:00
.github/workflows moved from nightly to latest stable version of Julia 2026-01-21 18:42:56 +01:00
deps Enabled and improved CLI 2025-01-29 15:23:05 +01:00
docs updated documentation 2025-08-21 11:31:59 +02:00
epw fixed the EPW example of si for #8 2026-01-26 11:05:29 +01:00
example fixed the EPW example of si for #8 2026-01-26 11:05:29 +01:00
ext improved gpu implementation 2026-01-02 20:09:35 +01:00
src final cleanup for #8 2026-01-22 12:15:28 +01:00
test fixed tests for q_points read 2026-01-21 18:49:37 +01:00
.gitignore introduced "cd() do" blocks 2025-07-09 15:46:26 +02:00
Comonicon.toml created a simple cli and added capabilities to read scf.in and .json with parameters 2024-11-29 14:30:12 +01:00
CondaPkg.toml fixed phonopy and ase version for the CI 2025-08-06 14:45:44 +02:00
LICENSE Files generated by PkgTemplates 2023-11-01 13:43:20 +01:00
Project.toml added basic gpu support + improved overall performance 2026-01-02 19:04:08 +01:00
README.md Update README.md 2025-08-21 10:34:44 +02:00

ElePhAny Logo

⚛️ Electron–Phonon interactions with Any functional

Build Status Documentation ArXiv License: MIT

Overview

ElePhAny is a Julia package for calculating electron–phonon coupling matrix elements using a finite-difference approach. It enables first-principles e–ph calculations with any exchange–correlation functional or beyond-DFT method (e.g. hybrid functionals, Koopmans functionals, GW), overcoming the limitations of DFPT which only supports standard LDA/GGA functionals.

ElePhAny constructs the e–ph matrix elements from supercell calculations: it reads eigenvalues and eigenvectors of the pristine and displaced structures and computes the coupling by projecting the change in the Hamiltonian onto the displaced Bloch states.

The code interfaces with ab initio outputs from Quantum Espresso (and other codes using QE formats, such as Koopmans or Yambo) and can export the resulting e–ph matrices to EPW for further analysis of charge transport, band renormalization, and other properties.

Features

  • 🚀 General Finite-Difference Method: Uses finite atomic displacements to evaluate electron–phonon interactions, avoiding linear-response (DFPT). This works with any functional, including orbital-dependent methods beyond DFT.
  • 📐 Eigenvalue Projectability Formula: Employs an eigenvalue-based projection technique to evaluate electron-phonon coupling, using only the eigenvalues and eigenvectors of the unperturbed and displaced systems. This approach yields electron-phonon coupling for any commensurate k-point and q-point in the supercell.
  • ⚖️ Symmetry Reduction: Exploits crystal symmetries to minimize the number of displacements needed. Only inequivalent atoms (and directions) are displaced, and symmetry operations generate the rest, greatly reducing computational cost.
  • 📦 EPW Integration: The computed e–ph matrix elements can be written in EPW format, allowing you to leverage EPW to compute phonon-assisted transport, superconducting tempreature, etc., using the advanced functional data generated by ElePhAny.

Installation

  1. Install Julia: Download Julia (v1.6 or later).
  2. Add ElePhAny:
   julia> ]
   pkg> add https://github.com/Koulb/ElePhAny.jl
  1. (Alternative) Development mode:
git clone https://github.com/Koulb/ElePhAny.jl.git
cd ElePhAny.jl
julia

In Julia:

julia> ]
pkg> dev .
  1. For Python-like dictionaries support:
pkg> add PythonCall

Usage

  1. Run supercell DFT calculations: ground state + displaced structures.
  2. Process with ElePhAny: load outputs, compute electron-phonon matrix elements.
  3. Export or analyze: e.g. save in EPW format for further property calculations.

➡️ See the documentation for a full tutorial and API reference.

➡️ See the preprint for full derivation and details on theory.

References and Resources

License: MIT