An integrated user-interface program for high-throughput first principles calculation through VASP code
Brief Introduction
VASPMATE is very user-friendly and powerful command line code for VASP pre and post processing to derive various properties of materials. The powerful pre-processing capabilities include various structures modeling and calculation parameters setting, while the post-processing analysis includes the derivation of electronic, energetic and other physical and chemical properties. In addition, VASPMATE provides simple and neat command mode, which can be readily used to build several robust HT workflows with lightweight script. It has also been implemented in SPaMD to facilitate the design of user-friendly graphical interfaces, which helps in customizing the complex workflow for automatic derivation of various properties by means of first-principles computations. The efficiency and functionalities of this program were critically validated by conducting several evaluations and tests, which provided guidance and confidence in its potential applications for targeted first principles calculations. VASPMATE is written in C/C++ that may be compiled and runs under linux, mac and win systems, which is small, portable and easy to operate.
Pre processing
The pre-processing provides the remarkable ability for the supercell construction, the redefinition of equivalent cell, the coordinate system conversion, the modification and fixation of atomic coordinates, the deformation of supercell, the setting for k-points, various necessary parameters, and the potentials.
Post processing
The post-processing focuses mainly on the basic electronic and thermodynamic properties, e.g. Kohn-Sham orbitals, band structure, density of states, charge density difference, Fermi surface, thermo energy correction, cohesive energy, formation enthalpy, elastic properties, SQL database etc.
Features
- Customize INCAR File by default template.
- Direct modification on the control parameters in INCAR file.
- Convert POSCAR File from cif (no fractional occupations), Gassian Cube formates and others.
- Redefine, rotation, affine, alias and other geometry operatios for structures.
- Primitive, conventional, ieee, recell and other symmetry operatios for structures.
- Generate KPOINTS File for normal SCF Calculation.
- Generate k-path for band structure calculation (PBE or HSE).
- Merge POTCAR according to POSCAR.
- Successive Procedure to Generate VASP Files and Check.
- Wavefunction analysis (e.g. Kohn-Sham orbitals).
- Basic Band structure analysis (PBE).
- Hybrid Band-Structure analysis (HSE).
- Density of states.
- Band Center analysis.
- Effective mass analysis.
- Fermi surface.
- Global 3d band structure.
- Charge density difference.
- Optical properties.
- Magnetic properties.
- Thermo energy correction (gas or adsorption).
- Formation enthalpy (Convex hull scheme).
- Elastic-Constants Using Stress-Strain Method.
- Elastic-Constants Using Energy-Strain Method.
- Automatic database construction using sdata, JSON, and SQLite3 formats.
- Automatic settings for high-throughput tasks.
- Automated consistency and convergence checks for computations.
Syntax
VASPMATE is written in C/C++ and designed for conducting first-principles calculations and executing ab initio molecular dynamics simulations.
It currently includes generating input files (INCAR, POSCAR, POTCAR, KPOINTS) required for VASP operation, performing various operations and analyses on input structures and parameters,
retrieving the required data from VASP output files (such as CONTCAR, OUTCAR, OSZICAR, XDATCAR, CHGCAR, WAVECAR, IBZKPT, EIGENVAL, PROCAR, DOSCAR, etc.),
and conducting analysis, reprocessing, and property derivation.
The general syntax format and rules of VASPMATE are as follows:
>>VASPMATE <--mode/--module> (inputfile) (outputfile) <-option/-parameter> [list/value]
In this command line format, --mode/--module represents the label for the operational mode/ functional module, prefixed with "--", such as --prim, --cif2pos, --band, --dos.
For different operational modes/ functional modules, VASPMATE provides corresponding default input filenames inputfile, such as INPOS and INCIF,
and default output filenames outputfile, such as NEWPOS and NEWCIF.
Note: When the user only provides one filename, and the operational mode/functional module requires both an input file and an output file,
the filename corresponds to inputfile, while outputfile adopts the default filename.
For example, VASPMATE --cif2pos INCIF is equivalent to VASPMATE --cif2pos INCIF NEWPOS.
-option/-parameter represents the options/parameters label required for the operational mode/functional module, prefixed with "-",
such as -opt (replace opt with the option label), -par (replace par with the parameter label), etc. List/Value represents the specific option list/parameter value.
Note: When the VASPMATE command line only requires one type of option/parameter label, and both input and output filenames are readily provided,
the label <-option/-parameter> can be omitted, and the option list/parameter value [list/value] can be listed directly after the filename.
For example, VASPMATE --super INPOS SUPERPOS -par 4 4 1 is equivalent to VASPMATE --super INPOS SUPERPOS 4 4 1.
If the default input and output filenames are used after the operational mode/functional module label <--mode/--module>, the option/variable label <-option/-parameter> cannot be omitted.
For example, VASPMATE --super INPOS SUPERPOS -par 4 4 1 is equivalent to VASPMATE --super -par 4 4 1, while VASPMATE --super 4 4 1 (XXX) is incorrect.
Suggestion: When being uncertain whether the option/parameter label can be omitted, it is recommended to use the option/parameter label to avoid command line matching and assignment errors.
Pasted below is the outline of the operational modes and functional modules implemented in VASPMATE for reference (it can be viewed via VASPMATE --help). To be noted that there would be more options/parameters required for each operational mode or functional module, which will be discussed in more detail in the attached manual.
Gallery
Updates
- Updated in Ver.2.0: This version of VASPMATE offers a comprehensive guidebook to clarify the general syntax format and rules. For a list of commands, users can simply refer to VASPMATE --h. The manual for VASPMATE 2.0 provides extensive details on usage and includes practical examples. In addition to the existing functionalities, both basic and advanced, new convenient commands is included for operating on POSCAR, INCAR, KPOINTS, and POTCAR files. Version 2.0 also boasts automatic settings for high-throughput tasks, automated consistency and convergence checks for calculations, and automatic database construction using sdata, JSON, and SQLite3 formats. Furthermore, two distinct methods are provided for deriving elastic constants, support for AIMD simulations, and capabilities for generating random and evolutionary structures, among other features.
- Updated in Ver.1.3: Add optical properties analysis and stress-strain elastic calculation.
- Updated in Ver.1.2: Add information extraction from OUTCAR.
- Updated in Ver.1.1: Add electronic pre-post analysis, including Fermi surface, 3dband structure, bader charge, wavefunction analysis, etc.
License
License statement: The VASPMATE is currently copyrighted and distributed free of charge for academic, scientific, and educational, and non-commercial users with our permission. Commercial users may also use this software with no cost until a license is established, or with a contract for payment for the relevant patent or technical support. This software is provided 'as it is' without any expressed or implied warranty. If you use VASPMATE, kindly register via Registration Link or send an email with the registration form to email: zrfcms@buaa.edu.cn
Notice: Please kindly use Registration Link for new users or Login Link for registered ones to get access code for VASPMATE-example.
Reference
Z. C. Pan, Z. R. Liu, T. F. Xu, D. Legut, and R. F. Zhang*. VASPMATE: an integrated user-interface program for high-throughput first principles calculation through VASP code, Computational Materials Science 233, 112707 (2024).