Jacek Kobus Jacek Kobus

2 Dimensional Finite Difference
Hartree-Fock Program

User's Guide

version 2-2005





1  Description of the command structure

The input command file consists of separate lines each containing

Note that

The following labels can be used:

2  Examples of input command cards

  1. 2S ground state of the Th+89 one-electron system.

    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
    

  2. First excited 2S state of the Th+89 one-electron system.
    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
    

  3. Hartree-Fock ground state of the beryllium atom.

    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
    

  4. Hartree-Fock ground state energy of the hydrogen molecule.

    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
    

  5. Hartree-Fock ground state of the BF molecule.

    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
    

  6. HF calculations for the lowest 3P state of the carbon atom.

    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
    

  7. HF calculations for the lowest 2P state of the C+ ion.

    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
    

  8. HF calculations for the lowest state of the C2 molecule.

    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
    

  9. HF calculations for the lowest state of the N2 molecule.

    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
    

  10. HF calculations for the lowest state of the F2 molecule.

    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
    

3  Description of the data file structure of the program

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:

2dhf_output.orb containing molecular orbitals (in the order specified by the input data following config label) followed by their normalization factors, orbital energies, Lagrange multipliers and multipole moment expansion coefficients (see WTDISK for more details),

2dhf_output.coul containing corresponding Coulomb potentials and

2dhf_output.exch containing all exchange potentials if i2 parameter on initial card is 2 or 3 or

fort.31, fort.32, ... if i2 is 0 or 1 where each file contains the exchange potential for a particular pair of orbitals.

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.

4  How to run the program?

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:

xhf c1  [  c2   [  c3  ]  ]
where

If, for example, be.data file contains input data cards for the beryllium atom (see Example 3) then

xhf be be-1
starts and performs the first 300 scf iterations. Type
xhf be be-1 be-2
to continue calculations. In order to converge the scf process increase the maximum value of the scf iterations and use the following command
xhf be be-2 be-1

5  How to stop the program?

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.

6  Useful hints


Footnotes:

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.


File translated from TEX by TTH, version 2.00.
On 19 Feb 2005, 14:09.