2 Dimensional Finite Difference
Hartree-Fock Program
User's Guide
version 2-2005
The input command file consists of separate lines each containing
Note that
If |ZA-ZB| < 10-6 then the molecule is considered to be a homonuclear one (this threshold can be changed by redefining HOMOLEVL variable in blk_data.inc.raw).
The possible formats are:
Use this format for a homonuclear molecule unless break command is included.
Two possible formats are (the second one is retained for the backward compatibility):
nm is calculated so as to make the step size in m variable equal to the stepsize in n variable. nn and nm have to meet special conditions. If the conditions are not fulfilled the nearest (but smaller) appropriate values are used.
nn and nm have to meet special conditions. If the conditions are not fulfilled the nearest (but smaller) appropriate values are used.
Note that a semiempirical formula can be used to calculate a near-optimal value of wpot by specifying wpot(1) as a negative real number.
TITLE Th+89 point/finite nucleus R = 2.5 METHOD OED NUCLEI 90.0 0.0 2.0 CONFIG 89 1 sigma + end GRID 169 193 2.5 INITIAL 1 3 1 1.0 1 0 90.0 0.0 1 0 1.0 0 SCF 30 10 8 omega 1.80 1.80 ! fermi 232.0 0.0 STOP
TITLE Th+89 point/finite nucleus R = 2.5 METHOD OED NUCLEI 90.0 0.0 2.0 CONFIG 88 1 sigma + 1 sigma + end GRID 169 193 2.5 INITIAL 5 3 1 1.0 2 0 90.0 0.0 1 0 1.0 0 1.0 1 0 90.0 0.0 1 0 1.0 1 ! 1s orbital must be kept frozen SCF 30 10 8 omega 1.80 1.80 !fermi 232.0 0.0 STOP
TITLE Be R_inf=35.0 bohr R = 2.3860 bohr METHOD hf ! or METHOD HFS NUCLEI 4.0 0.0 2.386 CONFIG 0 2 sigma end GRID 91 35.0 grid 169 35.0 INITIAL 1 3 1 1.0 2 0 4.0 0.0 1 0 9.0 0 0 1.0 1 0 4.0 0.0 1 0 9.0 0 0 SCF 300 10 8 12 1 ! note that omega for potentials is set automatically omega 1.80 -1.87 stop
title H2: [169x193;35] R = 1.4au method hf !nuclei 1.0 1.0 1.4 nuclei 1.0 1.0 2.0 !homo !break config 0 1 sigma g end !grid 169 193 35.0 grid 169 40.0 initial 1 3 1 1.0 1 0 1.0 1.0 1 0 1.0 0 scf 1000 10 16 16 omega 1.95 -1.87 stop
TITLE BF: R = 2.386 bohr METHOD HF NUCLEI 5.0 9.0 2.386 CONFIG 0 1 pi 5 sigma end ! initial orbitals are taken from GAUSSIAN94 output (see bf.inp) ! bf_g94.out and bf_g94.pun files must be copied into a working ! directory as gauss94.out and gauss94.pun files, respectively INITIAL 2 3 GRID 169 35.0 SCF 200 20 8 omega 1.85 1.97 multipol -1 fix 1 0 2 ! orbitals are not relaxed STOP
TITLE 3P C R = 2.386 METHOD HF NUCLEI 6.0 0.0 2.386 CONFIG 0 1 pi + . + 1 sigma 1 sigma end GRID 169 30.0 INITIAL 1 3 1 1.0 2 1 5.0 0.0 1 0 9.0 0 1.0 2 0 6.0 0.0 1 0 9.0 0 1.0 1 0 6.0 0.0 1 0 9.0 0 SCF 400 20 12 12 omega 1.80 1.87 STOP
TITLE 1P C+ R = 2.386 METHOD HF NUCLEI 6.0 0.0 2.386 CONFIG 1 1 pi + 1 sigma 1 sigma end GRID 169 30.0 INITIAL 1 3 1 ! or INITIAL 5 3 1 and using 3P results 1.0 2 1 5.0 0.0 1 0 9.0 0 1.0 2 0 6.0 0.0 1 0 9.0 0 1.0 1 0 6.0 0.0 1 0 9.0 0 SCF 500 20 7 omega 1.82 1.87 STOP
TITLE C2 R = 2.358 METHOD HF NUCLEI 6.0 6.0 2.358 homo !break CONFIG 0 1 pi u 1 sigma u 1 sigma g 1 sigma u 1 sigma g end GRID 169 193 40.0 INITIAL 2 3 0 ! just a couple of dozen iterations to start with SCF 50 10 10 10 1 ! note the small value of overrelaxation parameter for orbitals ! often initial scf/sor iterations have to be require slower ! convergence rates omega 1.25 1.85 STOP
TITLE C2 R = 2.358 METHOD HF NUCLEI 6.0 6.0 2.358 homo !break CONFIG 0 1 pi u 1 sigma u 1 sigma g 1 sigma u 1 sigma g end GRID 169 193 40.0 INITIAL 5 3 0 SCF 500 10 10 10 1 ! the overrelaxation parameter for potentials is at its more or less ! optimal value omega 1.75 1.85 STOP
TITLE N2 R = 2.068 METHOD HF NUCLEI 7.0 7.0 2.068 homo CONFIG 0 1 pi u 1 sigma g 1 sigma u 2 sigma g 1 sigma u end GRID 169 193 40.0 INITIAL 1 3 1 0.5 2 1 5.0 0.5 2 1 5.0 0 1.5 2 1 5.0 0.0 2 1 5.0 0 0.5 2 0 7.0 -0.5 2 0 7.0 0 0.5 2 0 7.0 0.5 2 0 7.0 0 0.5 1 0 7.0 0.5 1 0 7.0 0 0.5 1 0 7.0 -0.5 1 0 7.0 0 SCF 2000 10 10 10 2 omega 1.65 1.85 STOP
TITLE F2 R = 2.668 (1.4118449A) METHOD HF NUCLEI 7.0 7.0 2.668 homo !break CONFIG 0 1 pi u 1 sigma g 1 sigma u 1 sigma g 1 sigma u 1 sigma g end GRID 169 193 40.0 INITIAL 2 3 SCF 100 10 10 10 omega 1.75 1.75 STOP
There are several standard names used by the program to keep track of its input and output disk files. Normally the program writes out the data in the course of computations and upon the completion into the following disk files:
If i1 parameter on initial card is 5 the orbitals are retrieved from 2dhf_input.orb file, Coulomb potentials from 2dhf_input.coul and exchange potentials from 2dhf_input.exch file (or fort.31, fort 32, ... files). Note that there is only one set of fort.i files.
In order to simplify the usage of the program, the xhf script is provided which facilitates handling of the disk files. The command xhf requires one, two or three parameters:
If, for example, be.data file contains input data cards for the beryllium atom (see Example 3) then
How to abort the program during a lengthy calculation without killing the process and interrupting the disk read/write operations which can well happen when separate files for the exchange potentials are being used? All you have to do is to create a (zero length) file named stop_x2dhf in a working directory (the Unix touch command will do the job). The program aborts gracefully whenever this file is detected upon the completion of a current orbital/potential relaxation.
If, however, a system contains more than 15-20 electrons the initial estimates of the orbitals have to be good enough to avoid divergences. Then, you have to choose the parameters of the hydrogenic orbitals carefully or perform the finite basis set calculations using the Gaussian94 to provide the initialization data for orbitals.
The dependence of the optimum value of the relaxation parameter wpot on the grid size is illustrated by the following table:
nn×nm | wpot |
50 × 50 | 1.89 |
100 × 100 | 1.94 |
159 × 100 | 1.96 |
300 × 300 | 1.98 |
Now it is possible to set wpot to its near-optimal value by using a semiempirical formula (B.Sobczak MSc Thesis, Torun 2002); see the description of the OMEGA label above.
Optimum values of the orbital relaxation parameter are somewhat smaller and are not directly related to the grid size. In most cases choosing 1.75 £ worb £ 1.85 should lead to fairly good convergence rates.
1 A note of warning for the users of the g77 compiler. You might encounter an I/O error when trying to run cases requiring more than 70 exchange potentials. By default g77 accepts file unit numbers in the range 0-99. If you need more files to be opened you have to edit f/runtime/libI77/fio.h in the g77 source tree, changing the line: #define MXUNIT 100. Change the line so that the value of MXUNIT is defined to be at least one greater than the maximum unit number needed.