2.1. Install DP-GEN

There are various methods to install DP-GEN. Users can choose a suitable method depending on the machine environment. The following is a detailed description of two easy methods.

2.1.1. Install with pip

Users can use pip to install the DP-GEN if their machine can be connected to the internet. One can install DP-GEN directly by

pip install dpgen

2.1.2. Install with source code

Users can use the source code to install the DP-GEN if their machine cannot be connected to the internet. One can download the source code of DP-GEN by

git clone https://github.com/deepmodeling/dpgen.git

then you can install DP-GEN easily by:

cd dpgen
pip install --user .

With this command, the dpgen executable is install to $HOME/.local/bin/dpgen. You may want to export the PATH by

export PATH=$HOME/.local/bin:$PATH

2.1.3. Verify the installation

If the installation is successful, DP-GEN (dpgen) will be available to execute. To test the installation, you may execute

dpgen -h

the terminal will show the help information like

usage: dpgen [-h]
             {init_surf,init_bulk,auto_gen_param,init_reaction,run,run/report,collect,simplify,autotest,db} 
	     ...

dpgen is a convenient script that uses DeepGenerator to prepare initial data, drive DeepMDkit and analyze results. This script works based on several sub-commands with their own options. To see the options for the sub-commands, type "dpgen sub-command -h".