BDF development manual

 This manual is for developers. 

How to add a new module into BDF package

1. Prepare you source codes and store it in a directory named "newmodule" .
2. Copy the directory "newmodule" into BDF source code directory $BDFHOME/source and add it to svn version control by "svn add newmodule".
3. Copy a Makefile from any BDF module directory to "newmodule" to compile and link you program.
4. If you program is linked correctly, you will have a executable file name "newmodule.x" in the directory $BDFHOME/bin.
5. Append a line with the content "newmodule" into the file "$BDFHOME/database/program.dat". This file defines all available BDF modules which can be executed by BDF driver.
6. Edit the file "$BDFHOME/database/xianest.mh". Add your module name "newmodule "into variable PRGLIST.
   • PRGLIST = dpdmrpt2 compass xuanyuan mcscf ... newmode
7. Edit the file "$BDFHOME/configure.in", add you module name "newmodule" into variable "xianlistf"
   • xianlistf = "class module compass sys_util ... newmodule"
8. Goto directory "$BDFHOME" and run command "autoconf" to generate new configure file.

After add module and generate new configure file, you can configure BDF package and compile BDF to check if your module is compiled correctly.

Run all tests of BDF

In directory $BDFHOME/sbin, there is a shell script can be used to run all BDF tests. If you use vi edit this file, you will see lines like

## May. 26, 2011 -BSUO- run all tests to check program automatically

export BDFHOME=~/bdfsrc #Anot/0.5.dev
export BDF_TMPDIR=/tmp/$RANDOM
...

You need to modify "BDFHOME". Run this script will test all examples in "$BDFHOME/tests/input". The check files in "$BDFHOME/tests/check" will be used to compare test results.