Sovereign 8s.is mirror of standardgalactic/GEMDAT
  • Python 99.4%
  • Nix 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
AstyLavrinenko cefd3c04d1
Some checks failed
code style check / pre-commit (push) Has been cancelled
Tests for GEMDAT / Run Coverage and Tests (push) Has been cancelled
Tests for GEMDAT / Run Coverage and Tests-1 (push) Has been cancelled
Tests for GEMDAT / Run Coverage and Tests-2 (push) Has been cancelled
Bump version to: 1.7.1
2026-04-29 11:03:24 +00:00
.github/workflows Bug fix 2026-01-13 16:30:38 +01:00
docs Bump docs/tutorials submodule 2026-01-19 07:02:17 +00:00
scripts Fix all mypy issues (#341) 2024-11-18 10:52:05 +01:00
src/gemdat Bump version to: 1.7.1 2026-04-29 11:03:24 +00:00
tests adjust plotly rdf baseline images 2026-04-29 11:10:02 +02:00
tools Added some plotly plots and update notebooks (#278) 2024-02-22 15:19:08 +01:00
.gitignore Updating documentation and various fixes (#131) 2023-09-12 13:50:57 +02:00
.gitmodules Update .gitmodules 2026-01-19 06:48:26 +01:00
.pre-commit-config.yaml Update .pre-commit-config.yaml 2026-01-13 10:51:38 +01:00
.readthedocs.yaml Add tutorials to docs 2026-01-15 17:44:43 +01:00
CITATION.cff Bump version to: 1.7.1 2026-04-29 11:03:24 +00:00
CODE_OF_CONDUCT.md Set up documentation (#4) 2023-06-14 13:10:02 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md 2024-06-10 15:42:09 +02:00
LICENSE Create LICENSE (#107) 2023-08-14 17:05:14 +02:00
MANIFEST.in add the data of the package to the manifest (#152) 2023-10-10 15:25:15 +02:00
mkdocs.yml Update mkdocs.yml 2026-01-19 06:45:11 +01:00
pyproject.toml Bump version to: 1.7.1 2026-04-29 11:03:24 +00:00
README.md Bump version to: 1.7.1 2026-04-29 11:03:24 +00:00
requirements.txt Update requirements.txt 2026-04-29 12:17:10 +02:00
requirements_full.txt Updated requirements.txt files 2026-01-19 06:36:14 +00:00

Documentation Status Tests for GEMDAT Coverage PyPI - Python Version PyPI DOI

GEMDAT banner GEMDAT banner

GEMDAT

Gemdat is a Python library for the analysis of diffusion in solid-state electrolytes from Molecular Dynamics simulations. Gemdat is built on top of Pymatgen, making it straightforward to integrate it into your Pymatgen-based workflows.

With Gemdat, you can:

  • Explore your MD simulation via an easy-to-use Python API
  • Load and analyze trajectories from VASP, LAMMPS, GROMACS, and ASE simulation data
  • Find jumps and transitions between sites
  • Effortlessly calculate tracer and jump diffusivity
  • Easily perform kinisi diffusion analysis
  • Characterize and visualize diffusion pathways
  • Plot main structural and diffusion properties

To install:

pip install gemdat

The source code is available from Github.

Suggestions, improvements, and edits are most welcome.

Usage

The following snippet to analyze the diffusion trajectory from VASP data.

from gemdat import Trajectory

trajectory = Trajectory.from_vasprun('../example/vasprun.xml')

trajectory.plot_displacement_per_element()

diff_trajectory = trajectory.filter('Li')

diff_trajectory.plot_msd_per_element()
diff_trajectory.plot_displacement_per_atom()
diff_trajectory.plot_displacement_histogram()
diff_trajectory.plot_frequency_vs_occurence()
diff_trajectory.plot_vibrational_amplitudes()

Characterize transitions and jumps between sites:

from gemdat.io import load_known_material

sites = load_known_material('argyrodite', supercell=(2, 1, 1))

transitions = trajectory.transitions_between_sites(
    sites=sites,
    floating_specie='Li',
)

jumps = transitions.jumps()

jumps.plot_jumps_vs_distance()
jumps.plot_jumps_vs_time()
jumps.plot_collective_jumps()
jumps.plot_jumps_3d()

jumps.jump_diffusivity(dimensions=3)

To calculate different metrics, such as tracer diffusivity:

from gemdat import TrajectoryMetrics

metrics = TrajectoryMetrics(diff_trajectory)

metrics.tracer_diffusivity(dimensions=3)
metrics.haven_ratio(dimensions=3)
metrics.tracer_conductivity(dimensions=3)
metrics.particle_density()
metrics.vibration_amplitude()

Development

Check out our Contributing Guidelines to get started with development.

How to Cite

Dissemination

Credits

Some parts of the code in this repository are based on Matlab code to analyse Molecular Dynamics simulations.

For background information on how some of the properties are calculated, check out the accompanying paper:

  • Niek J.J. de Klerk, Eveline van der Maas and Marnix Wagemaker, ACS Applied Energy Materials, (2018), doi: 10.1021/acsaem.8b00457