Python modules for high-throughput 2D Materials Characterization
Edit config.yaml with your system's settings, following the template:
username: your_hipergator_username
mp_api: your_materials_project_api_key
normal_binary: path_to_normal_vasp_executable
twod_binary: path_to_twod_vasp_executable
potentials: path_to_your_vasp_potentials
And then move it to your home directory mv config.yaml
This package is designed to characterize 2D materials with as little a priori knowledge as possible. The only input required are the structures of the materials, which should be stored as POSCAR files in uniquely named directories, e.g.:
- My_2D_Search
- WSe2
- POSCAR
- MoS2
- POSCAR
- Ti2CO2
- POSCAR
- WSe2
In almost all cases, before doing anything else, the user should use the relax() function to optimize the structures of the 2D materials using the framework of input parameters included here.
Certain modules in the analysis.py
files have been designed to be
sensitive to the directory structure, and will only really work if you've
used the corresponding modules in the startup.py
files to run the
calculations. get_hull_distance
is an example, since twod_materials
needs to know where to look for competing bulk species (they should be in
all_competitors/
, which should be at the same level as your 2D
material's directory)
See the examples folder for some sample usage and workflows.