Perovskite Dynamics Analysis (PDynA) is a Python package for analysis of perovskite structural dynamics.
-
The input to the code is molecular dynamics (MD) trajectories, currently readable formats are VASP-XDATCAR, XYZ, PDB (proteindatabank), ASE-Trajectory and LAMMPS dump files. The core class of PDynA is the
Trajectory
class. -
The structure recognition functions will automatically detect the constituent octahedral network and organic A-site molecules, and process the analysis.
-
The output is a selected set of the following properties: (pseudo-cubic) lattice parameter, octahedral distortion and tilting, time-averaged structure, A-site molecular orientation, A-site spatial displacement, radial distribution functions.
-
The octahedral distortion and tilting calculation is the core feature of this package, which can quantitatively examine the dynamic behaviour of perovskite in terms of how octahedra tilt and distort, as well as the spatial correlation of these properties (Glazer notation).
-
The octahedral distortion and tilting calculation can be accelerated with parallelization by joblib, this can be tuned with the input parameter
multi_thread
.
- pdyna library containing:
- core.py: Contains the dataclass Trajectory and Frame as well as their related functions.
- structural.py: Handles structure recognition and property calculations.
- analysis.py: A collection of tools for computing and visualizing the output.
- io.py: The IO to input data files.
The main language is Python 3 and has been tested using Python 3.8+, with the following dependencies:
- Numpy
- Matplotlib
- Pymatgen
- Scipy
- ASE
PDynA can be installed with the following commands:
Clone the repository (or download manually)
git clone https://github.com/WMD-group/PDynA.git
cd to PDynA directory with the setup.py
file
cd pdyna
Install the package with pip
pip install .
Two molecular dynamics trajectories are given in the examples
folder.
We encourage users to run orthogonal (the vectors connecting adjacent B-atoms are parallel to the principal axes) perovskite structures with corner-sharing connectivity to get the best performance of structure matching, when possible.
1. VASP-XDATCAR trajectory
The minimal example is based on a VASP-XDATCAR format trajectory, containing about 100 atoms.
Copy all the files under examples/minimal
to your working directory and run the script pdyna_example.py
.
2. LAMMPS trajectory
The second example is a larger LAMMPS trajectory (about 20,000 atoms), covering more functions in PDynA.
Copy all the files under examples/lammps
to your working directory, unzip lammps_example_mapbbr3.out.gz
and run the script example_lammps.py
.
For your own LAMMPS trajectory, please use a custom dump style with this command: dump dump_name all custom dump_frequency ./dump.out id element x y z
3. XYZ/PDB/ASE trajectory
Reading of these file types can be done similarly by running traj = Trajectory(filetype,(file_path, MDtup))
, where filetype
is one of "xyz", "pdb" or "ase-traj", the MD settings MDtup = (Ti, Tf, timestep, nblock)
(timestep
is MD time step in femtosecond, nblock
is the frequency of frame saving).
4. Parameters explained
A full list of all the parameters is shown in the examples/full.py
.
Python code and original data tables are licensed under the MIT License.
Please use the Issue Tracker to report bugs or request features in the first instance. For other queries about any aspect of the code, please contact Xia Liang by e-mail: xia.liang16[at]imperial.ac.uk.
- Xia Liang (Department of Materials, Imperial College London)