virp 1.1.0

VIRtual cell generation by Permutation

virp: VIRtual cell generation by Permutation

virp is a code for the fast generation of a virtual cell from a crystal structure (in CIF format) containing site disorder. It is named after Singapore's first superhero, VR Man, whose superpower is "Virping". The show was a flop, but we are still proud of him.

This project is inspired by the Supercell code of Okhotnikov, Charpentier and Cadars (J. Cheminform. 8, 17), which formed the basis of our fast virtual cell generation algorithm, as well as the aflow++ framework (Comput. Mater. Sci. 217, 111889), for the statistical postprocessing of materials properties.

Theory

(To be updated!)

Requirements

pymatgen, chgnet, and matgl (matgl==1.0.0; dgl)
Optional: You can also use git for the fancy installation. Otherwise, downloading the .py file will do.

Installation

pip install git+https://github.com/andypaulchen/virp.git
Update to latest release: uninstall and re-install
NEW! Install with pip install virp

Building a database

The root directory has a folder (session) which holds the python scripts which build a library of virtual cells (generate.py) and postprocessing scripts (connectivity.py and properties.py). After each script is run, the results are saved as .csv files.

1. To prepare for a session, copy the session folder in your workspace and place the .cif files you want to process (make virtual cells + postprocessing) in the subfolder _disordered_cifs. Feel free to rename session folder to something more identifiable

2. Run generate.py to create a supercell and (by default) 400 virtual cells.

   • after this step, a structure subfolder (e.g. structure) is created in session for each structure.cif file in _disordered_cifs, with the same name. Inside this folder is a supercell CIF and folders for structure-optimized (stropt) and non-structure-optimized virtual cells (no_stropt). The details of this run is recorded in virp_session_summary.csv.

3. Run connectivity.py for atomic connectivity post-processing

   • after this step, the results are written to connectivity.csv and scatterplot.png under stropt and no_stropt.

4. Run properties.py to predict materials properties. This is performed on stropt subfolders only.

   • after this step, the results are written to virtual_properties.csv in the structure subfolder.

In summary, this is what a session looks like after all three routines have completed:

Versions and changelog

v0.1.1: first workable code, with function to generate a virtual cell.
v0.2.1: added enumeration function
v0.2.2: enumeration can be imported now (fix)
v0.3.0: you can now make a batch of virtual cells
v0.4.3: added tools to build a database v1.1.0: major user-friendliness updates, database compilation

Debugging and support

The virp code has been tested on a limited number of platforms, so far Windows and Linux. If you are running into any problems during operation, please hound me (Andy Paul Chen) at la.vache.qui.vit(at)gmail.com, and I will try my best to help.