ferrodispcalc

Utilities for preprocessing and postprocessing molecular simulations of ferroelectric materials.

Purpose

---

ferrodispcalc provides small, focused tools to compute ionic displacements, polarization and octahedral tilts for perovskite-like materials, and to visualize results efficiently.

Highlights

---

• Build neighbor list with easy-to-use API.
• Compute ionic displacements from trajectories / single structure.
• Compute polarization and octahedral-tilt descriptors for perovskite-type structures.
• On-demand visualization helpers for common plots.
• LAMMPS plugin for efficient, in-situ calculations during MD runs.

Gallery

---

The local polarization of (PbTiO₃)/(SrTiO₃) superlattice in real space.

Path: ./gallery/PTO-STO-superlattice/plot.py

Profile of Head-to-head charged 180-degree domain wall in PbTiO₃

Path: ./gallery/PTO-HH-DW/plot.py

SED for local Ti displacement in PbTiO₃

Documentation

---

More detailed information, example usage, and API docs: https://moseyqaq.github.io/ferrodispcalc/

Install

---

git clone https://github.com/MoseyQAQ/ferrodispcalc.git
cd ferrodispcalc
pip install -e .

We plan to publish this package to PyPI soon.

Credit

Please cite this repo if it helps your research. Thanks!

Papers used this package

1. MGE Advances, 4, e70074 (2026)
2. Disentangling the Discrepancy Between Theoretical and Experimental Curie Temperatures in Ferroelectric PbTiO (under review @ MRS Comm.), arXiv:2601.13125 (2026) (perovskite system)
3. Phys. Rev. Lett. 136, 016801 (2026) (organic-inorganic hybrid system)
4. J. Phys. Chem. C 129, 21538 (2025) (perovskite system)
5. Phys. Rev. X 16, 021022 (2026) (perovskite system)
6. Phys. Rev. X 15, 021042 (2025) (HfO2 system)