next up previous contents
Next: 8. Effective Core Potentials Up: user Previous: 6. Geometries   Contents

Subsections

7. Basis sets

NWChem currently supports basis sets consisting of generally contracted7.1 Cartesian Gaussian functions up to a maximum angular momentum of seven ($i$ functions), and also $sp$ (or L) functions7.2 . The BASIS directive is used to define these, and also to specify use of an effective core potential (ECP) that is associated with a basis set; see Section 8.)

The basis functions to be used for a given calculation can be drawn from a standard set in the EMSL basis set library that is included in the release of NWChem (See Appendix A for a list of the standard basis sets currently supplied with the release of the code). Alternatively, the user can specify particular functions explicitly in the input, to define a particular basis set.

The general form of the BASIS directive is as follows:

  BASIS [<string name default "ao basis">] \
        [(spherical || cartesian) default cartesian] \
        [(segment || nosegment) default segment] \
        [(print || noprint) default print]
        [rel]

     <string tag> library [<string tag_in_lib>] \
                  <string standard_set> [file <filename>] [rel]

        ...

     <string tag> <string shell_type> [rel]
        <real exponent> <real list_of_coefficients>
        ...
     
  END

Examining the keywords on the first line of the BASIS directive:

Basis sets are associated with centers by using the tag of a center in a geometry that has either been input by the user (Section 6) or is available elsewhere. Each atom or center with the same tag will have the same basis set. All atoms must have basis functions assigned to them -- only dummy centers may have no basis functions. To facilitate the specification of the geometry and the basis set for any chemical system, the matching process of a basis set tag to a geometry tag first looks for an exact match. If no match is found, NWChem will attempt to match, ignoring case, the name or symbol of the element. E.g., all hydrogen atoms in asystem could be labeled ``H1'', ``H2'', ..., in the geometry but only one basis set specification for ``H'' or ``hydrogen'' is necessary. If desired, a special basis may be added to one or more centers (e.g., ``H1'') by providing a basis for that tag. If the matching mechanism fails then NWChem stops with an appropriate error message.

Examined next is how to reference standard basis sets in the basis set library, and finally, how to define a basis set using exponents and coefficients.

7.1 Basis set library

The keyword library associated with each specific tag entry specifies that the calculation will use the standard basis set in NWChem for that center. The variable <standard_set> is the name that identifies the functions in the library. The names of standard basis sets are not case sensitive. See Appendix A for a complete list of the basis sets in the NWChem library and their specifications.

For example, the NWChem basis set library contains the Dunning cc-pvdz basis set. These may be used as follows

  basis
    oxygen library cc-pvdz
    hydrogen library cc-pvdz
  end

A default path to the basis set library is provided on installation of the code, but a different path can be defined by specifying the keyword file and then explicitly naming the file to be accessed for the basis functions. For example,

  basis
    o  library 3-21g file /usr/d3g681/nwchem/library
    si library 3-21g file /usr/d3g681/nwchem/library
  end
This directive tells the code to use the basis sets 3-21g in the file /usr/d3g681/nwchem/library for atoms o and si, rather than look for them in the default library.

If standard basis sets are to be placed upon a dummy center, the variable <tag_in_lib> must also be entered on this line, to identify the correct atom type to use from the basis function library (see the ghost atom example in Section 5.7 and below). For example: To specify the cc-pvdz basis for a calculation on the water monomer in the dimer basis, where the dummy oxygen and dummy hydrogen centers have been identified as bqo and bqh respectively, the BASIS directive is as follows:

  basis
    o   library cc-pvdz
    h   library cc-pvdz
    bqo library o cc-pvdz
    bqh library h cc-pvdz
  end

The library basis sets can also be marked as relativistic by adding the rel keyword to the tag line. See Section 9.2 for more details. The correlation consistent basis sets have been contracted for relativistic effects and are included in the standard library.

There are also contractions in the standard library for both a point nucleus and a finite nucleus of Gaussian shape. These are usually distinguished by the suffixex _pt and _fi. It is the user's responsibility to ensure that the contraction matches the nuclear type specified in the geometry object. The specification of a finite nucleus basis set does NOT automagically set the nuclear type for that atom to be finite. See Section 6 for information.

7.2 Explicit basis set definition

If the basis sets in the library or available in other external files are not suitable for a given calculation, the basis set may be explicitly defined. A generally contracted Gaussian basis function is associated with a center using an input line of the following form:

     <string tag> <string shell_type> [rel]
        <real exponent> <real list_of_coefficients>
        ...

The variable <shell_type> identifies the angular momentum of the shell, $s$, $p$, $d$, .... NWChem is configured to handle up to $i$ shells. The keyword rel marks the shell as relativistic -- see Section 9.2 for more details. Subsequent lines define the primitive function exponents and contraction coefficients. General contractions are specified by including multiple columns of coefficients.

For example, the following BASIS directive augments the Dunning cc-pvdz basis set for the water molecule with a diffuse s-shell on oxygen:

  basis spherical nosegment
    oxygen library cc-pvdz
    hydrogen library cc-pvdz
    oxygen s
      0.01 1.0
  end

This is equivalent to the following explicit specification:

  basis spherical nosegment
    oxygen s
      11720.0000    0.000710  -0.000160
       1759.0000    0.005470  -0.001263
        400.8000    0.027837  -0.006267
        113.7000    0.104800  -0.025716
         37.0300    0.283062  -0.070924
         13.2700    0.448719  -0.165411
          5.0250    0.270952  -0.116955
          1.0130    0.015458   0.557368
          0.3023   -0.002585   0.572759
    oxygen s                
          0.3023    1.000000
    oxygen p                
         17.7000    0.043018
          3.8540    0.228913
          1.0460    0.508728
          0.2753    0.460531
    oxygen p                
          0.2753    1.000000
    oxygen d
          1.1850    1.000000
    hydrogen s
         13.0100    0.019685
          1.9620    0.137977
          0.4446    0.478148
          0.1220    0.501240
    hydrogen s  
          0.1220    1.000000
    hydrogen p  
          0.7270    1.000000
    oxygen s
          0.01      1.0
  end


next up previous contents
Next: 8. Effective Core Potentials Up: user Previous: 6. Geometries   Contents
Jorge Garza Olguin 2003-04-28