Upload
others
View
16
Download
0
Embed Size (px)
Citation preview
THE DL MULTI USER MANUAL
M. Leslie,
CCLRC, Daresbury Laboratory,
Daresbury,
Warrington WA4 4AD,
England
Version 2.00 Jan 2003
c©CCLRC 1
ABOUT DL MULTI
DL MULTI is an extension to the standard DL POLY package developed at DaresburyLaboratory by M. Leslie for the EPSRC’s Collaborative Computational Project for theComputer Simulation of Condensed Phases (CCP5). The package is the property of TheCouncil for the Central Laboratory of the Research Councils (CCLRC).
DL MULTI is issued free under licence to academic institutions pursuing scientificresearch of a non-commercial nature. Commercial organisations may be permitted a licenceto use the package after negotiation with the owners. Daresbury Laboratory is the solecentre for distribution of the package. Under no account is it to be redistributed to thirdparties without consent of the owners.
The purpose of the DL MULTI package is to provide software for academic research thatis inexpensive, accessible and free of commercial considerations. Users have direct accessto source code for modification and inspection. In the spirit of the enterprise, contributionsin the form of working code are welcome, provided the code is compatible with DL MULTIin regard to its interfaces and programming style and it is adequately documented.
c©CCLRC 2
DISCLAIMER
Neither the CCLRC, EPSRC, CCP5 nor any of the authors of the DL MULTI packageor its derivatives guarantee that the package is free from error. Neither do they acceptresponsibility for any loss or damage that results from its use. Use of the DL MULTIpackage without charge is confined to academic research only. Commercial use is onlypermissible following negotiation with Daresbury Laboratory. Users are not entitled toredistribute the program to third parties.
c©CCLRC 3
ACKNOWLEDGEMENTS
DL MULTI was developed under the auspices of the Council for the Central Laboratoryof the Research Councils and the Engineering and Physical Sciences Research Council Thepackage is the property of the Council for the Central Laboratory of the Research Councilsof the United Kingdom.
Advice, assistance and encouragement in the development of DL MULTI has been givenby many people. We gratefully acknowledge the following:
W. Smith, D. Willock, S.L. Price, A. Stone
c©CCLRC 4
Manual Notation
In the DL MULTI manual the same notation is used as in the DL POLY Manual.Specific fonts are used to convey specific meanings:
1. directories - indicates unix file directories
2. routines - indicates subroutines, functions and programs.
3. macros - indicates a macro (file of unix commands)
4. directive - indicates directives or keywords
5. variables - indicates named variables and parameters
6. FILE - indicates filenames.
Contents
1 Introduction 6
1.1 The DL MULTI Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.2 Extensions in DL MULTI compared with DL POLY . . . . . . . . . . . . . 7
1.2.1 Molecular Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.2.2 Force Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.2.3 Boundary Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . 81.2.4 Target Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.3 Obtaining the Source Code . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 DL MULTI Data Files 9
2.1 The INPUT files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1.1 The CONTROL File . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1.2 The CONFIG File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.1.3 The FIELD File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.2 The OUTPUT Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.2.1 The OUTPUT File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5
Chapter 1
Introduction
Scope of Chapter
This chapter describes the concept, design and directory structure of DL POLY and howto obtain a copy of the source code.
6
c©CCLRC 7
1.1 The DL MULTI Package
DL MULTI is an extension of DL POLY . It is designed to carry out simulations on rigidmolecules whose electrostatics are described using the distributed multipole analysis ofStone et al. [1]
In the next section we outline the differences of DL MULTI compared with DL POLYas briefly as possible.
1.2 Extensions in DL MULTI compared with DL POLY
The current version of DL MULTI is based on DL POLY 2.13. We describe below theextensions in DL MULTI compared with DL POLY and also the limitations.
1.2.1 Molecular Systems
DL MULTI will simulate the following molecular species:
1. Simple rigid molecules e.g. CCl4, SF6, Benzene, etc.
2. Rigid molecular ions with point charges e.g. KNO3, (NH4)2SO4, etc.
3. Systems which consist of mixtures of different types of molecule.
However, the following systems cannot be treated.
1. Molecules with flexible bonds
1.2.2 Force Field
The DL POLY force field is used and includes the following features:
1. All common forms of non-bonded atom-atom potential;
2. Atom-atom (site-site) Coulombic potentials;
3. Atom-atom (site-site) distributed multipole potentials;
The following DL POLY force field features should not be used in DL MULTI :
1. Valence angle potentials;
2. Dihedral angle potentials;
3. Inversion potentials;
4. Improper dihedral angle potentials;
5. 3-body valence angle and hydrogen bond potentials;
6. 4-body inversion potentials;
7. Sutton-Chen density dependent potentials (for metals)
c©CCLRC 8
1.2.3 Boundary Conditions
DL MULTI has only been tested in parallelepiped periodic boundary conditions. Theauthor of DL MULTI cannot guarantee that the other boundary conditions in DL POLYwill work.
1.2.3.1 Parallel Algorithms
DL MULTI exclusively employs the Replicated Data parallelisation strategy [2, 3]
1.2.4 Target Computers
DL MULTI is targeted towards distributed memory parallel computers. However, versionsof the program for serial computers are easily produced. To facilitate this all machinespecific calls are located in dedicated FORTRAN routines, to permit substitution by ap-propriate alternatives, or even deletion. Note that some of the communication routines inDL MULTI , which have routines in DL POLY with the same name, have been modifiedand have only been tested using MPI. If you are planning to use a different parallelisationmethod you should test these routines yourself.
DL MULTI has been tested on on the the following computers:
1. IBM SP/2
2. SUN SPARC and ULTRA SPARC.
3. Beowulf systems
Porting of DL MULTI to these and other machines requires MPI message passing tools.
1.3 Obtaining the Source Code
Holders of a licence for DL POLY can obtain a copy of DL MULTI as a separate standalone program.
Chapter 2
DL MULTI Data Files
Scope of Chapter
This chapter describes all the input and output files for DL POLY , examples of which areto be found in the data sub-directory.
9
c©CCLRC 10
2.1 The INPUT files
DL MULTI requires five input files named CONTROL, CONFIG, FIELD, TABLE andREVOLD. The first three files are mandatory, while TABLE is used only to input certainkinds of pair potential, and is not always required. REVOLD is required only if the job rep-resents a continuation of a previous job. TABLE and REVOLD are the same in DL MULTIas in DL POLY and are not described further here. In the following sections we describethe changes to the standard DL POLY files.
2.1.1 The CONTROL File
The CONTROL file is read by the subroutine simdef and defines the control variables forrunning a DL POLY or DL MULTI job.
The only difference in the CONTROL file between DL MULTI and DL POLY is in thedefinition of the Ewald sum precision. DL POLY uses the record
ewald precision f
whereas DL MULTI uses the following recordsmulp precisionfd0
fd1
fd2
fd3
fd4
fr0
fr1
fr2
fr3
fr4
fd0 is the Ewald precision in direct space for pole order 0, fd1 for pole order 1 and soon. fr0, fr1 are the corresponding terms for reciprocal space.
It is recommended that the user sets a high precision (smaller value of the f parameter)for pole orders greater than 0 in direct space. If this is not done there will be an energydrift due to energy changes when the higher order poles cross the cutoff boundary. Valuesof 0.001 can be used for pole order 0 and for all the reciprocal space terms, although smallervalues will give better energy stability. Values not less than 0.000001 should be used forthe higher order terms in direct space.
2.1.2 The CONFIG File
The format of the CONFIG file for DL MULTI is exactly the same as for DL POLY .Remember that all molecules of a particular molecule type must come together in the fileand all atoms of a molecule must come together in the same order for all molecules. If themolecule has enantiomers, these are treated as two different molecules and all configurationsof the first enantiomer must come before any of the second.
c©CCLRC 11
2.1.3 The FIELD File
The FIELD file contains the force field information defining the nature of the molecularforces. It is read by the subroutine sysdef. Excerpts from a force field file are shownbelow. The example is 5-azauracil.
DL_POLY TEST CASE azauracil
units ev
molecular types 2
azauracil+
multipole
nummols 96
atoms 11
NI 14.007 0.00 1
4
-0.495104
-0.001568 -0.158410 0.013091
-0.459413 0.018431 -0.035157 0.425186 -0.002068
0.032228 0.664233 -0.130477 -0.013206 0.245208 2.059576 0.109874
-0.287987 -0.054286 -0.290048 -0.887905 -0.346797 0.070680 -0.105214
0.418582 -2.343179
NI 14.007 0.00 1
4
-0.608897
0.018043 0.051003 -0.098955
-0.204276 -0.038276 0.039801 0.041331 0.096621
-0.035699 -0.202148 0.109761 -0.163215 -0.050993 2.800004 -0.016288
-1.130707 -0.159565 0.055705 0.353922 -0.056397 0.058125 -0.131937
-0.876265 2.423670
........ 9 more atoms
rigid units 1
11 1 2 3 4 5 6 7 8 9 10 11
mulaxes molaxes
1 3 6 2 3 6 2 3 1
finish
azauracil-
multipole
nummols 96
atoms 11
NI 14.007 0.00 1
4
-0.495104
-0.001568 -0.158410 0.013091
-0.459413 0.018431 -0.035157 0.425186 -0.002068
0.032228 0.664233 -0.130477 -0.013206 0.245208 2.059576 0.109874
c©CCLRC 12
-0.287987 -0.054286 -0.290048 -0.887905 -0.346797 0.070680 -0.105214
0.418582 -2.343179
........ 10 more atoms
rigid units 1
11 1 2 3 4 5 6 7 8 9 10 11
mulaxes molaxes
1 3 6 2 3 6 2 3 -1
finish
vdw 15
CA CA buck 3832.1 0.277778 25.287
CA HY buck 689.5 0.272480 5.979
CA HP buck 446.9 0.242131 2.374
CA NI buck 3179.5 0.271003 19.007
CA OX buck 3022.8 0.264550 17.160
HY HY buck 124.1 0.267380 1.414
HY HP buck 80.4 0.238095 0.561
HY NI buck 572.1 0.265957 4.494
HY OX buck 543.9 0.259740 4.057
HP HP buck 52.1 0.214592 0.223
HP NI buck 370.8 0.236967 1.784
OX HP buck 352.6 0.232019 1.611
NI NI buck 2638.0 0.264550 14.286
NI OX buck 2508.0 0.258398 12.898
OX OX buck 2384.5 0.252525 11.645
close
2.1.3.1 Format
The FIELD file is fixed-formatted. Integers are formatted as “i5”, reals are normally“f12.0”, although the multipole moments are “f11.0”, and characters are “a4”, “a8”, “a40”or “a80”, depending on context.
2.1.3.2 Definitions of Variables
The file divides into three sections: general information, molecular descriptions, and non-bonded interaction descriptions, appearing in that order in the file.
2.1.3.2.1 General information There are no changes from DL POLY .
record 4 (optional)mpdist a40 Distance units used to define the multipoles
The distance units on the mpdist directive are described by additional keywords:
angstrom , for A
c©CCLRC 13
au , for atomic units
The default if the mpdist directive is omitted is au.
2.1.3.2.2 Molecular details
As is the case for standard DL POLY , the FIELD file must give the molecular detailsfor the molecule types in the same order as they appear in the CONFIG file.
The entry of the molecular details begins with the mandatory directive:
molecules n or
molecular types n
where n is an integer specifying the number of different types of molecule appearing in theFIELD file. Note that enantiomers are counted as two different types of molecule. Once thisdirective has been encountered, DL MULTI enters the molecular description environmentin which only molecular decription keywords and data are valid.
Immediately following the molecular types directive, are the records defining individ-ual molecules. The first directive is the same as in DL POLY :
1. name-of-molecule
which can be any character string up to 80 characters in length. (Note: this is not adirective, just a simple character string.)
The next directive tells DL MULTI that there are multipoles in the FIELD file.
2. multipole
The next directive is the same as DL POLY
3. nummols n
where n is the number of times a molecule of this type appears in the simulatedsystem. The molecular data then follow in subsequent records:
4. atoms n
where n indicates the number of atoms in this type of molecule. A number of recordsfollow, each giving details of the atoms in the molecule i.e. site names, masses,multipole order and multipole components. Unlike the standard DL POLY , thereare several records for each atom. The first record carries the entries:
sitnam a8 atomic site nameweight real atomic site masschge real atomic site chargenrept integer repeat counter
c©CCLRC 14
ifrz integer ‘frozen’ atom (if ifrz> 0)igrp integer neutral/charge group number
This is the same as the standard DL POLY . Note however that the atomic site chargeread here is ignored as it will be read below in the multipole input. Also the repeatcounter will almost always be 1 as atoms in the molecule with the same atomic numberwill have different multipoles and will be treated by DL MULTI as different atomictypes. ifrz and igrp are not relevant for DL MULTI use and should be omitted.
The next record carries the entry (without a keyword)
jpoleo i8 multipole pole order for this atom
0 ≤ jpoleo < 4
jpoleo is the pole order for the multipoles for this atom.
There are then a number of records giving the magnitude of the multipoles dependingon jpoleo. The real numbers giving the magnitude of the multipoles are “f11.0” fixedformat.
In all cases there is a record format “f11.0” giving the multipole charge term (order0).
If jpoleo ≥ 1 there is a record format “3f11.0” giving the dipole components.
If jpoleo ≥ 2 there is a record format “5f11.0” giving the quadrupole components.
If jpoleo ≥ 3 there is a record format “7f11.0” giving the octopole components.
If jpoleo ≥ 4 there are 2 records format “7f11.0/2f11.0” giving the hexadecapolecomponents.
The order of the multipole components follow the usual order for spherical harmonics.[4] Table 1. These are given below.
Q00 =∑
i
ei
Q10 =∑
i
eizi
Q11c =∑
i
eixi
Q11s =∑
i
eiyi
Q20 =∑
i
ei
1
2(3z2
i − r2
i )
c©CCLRC 15
Q21c =∑
i
ei
√3xizi
Q21s =∑
i
ei
√3yizi
Q22c =∑
i
ei
1
2
√3(x2
i − y2
i )
Q22s =∑
i
ei
√3xiyi
Q30 =∑
i
ei
1
2(5z3
i − 3zir2
i )
Q31c =∑
i
ei
√
3
8xi(5z
2
i − r2
i )
Q31s =∑
i
ei
√
3
8yi(5z
2
i − r2
i )
Q32c =∑
i
ei
1
2
√15zi(x
2
i − y2
i )
Q32s =∑
i
ei
√15xiyizi
Q33c =∑
i
ei
√
5
8(x3
i − 3xiy2
i )
Q33s =∑
i
ei
√
5
8(3x2
i yi − y3
i )
Q40 =∑
i
ei
1
8(35z4
i − 30z2
i r2
i + 3r4
i )
Q41c =∑
i
ei
√
5
8(7xiz
3
i − 3xizir2
i )
Q41s =∑
i
ei
√
5
8(7yiz
3
i − 3yizir2
i )
Q42c =∑
i
ei
1
4
√5(x2
i − y2
i )(7z2
i − r2
i )
Q42s =∑
i
ei
1
2
√5xiyi(7z
2
i − r2
i )
Q43c =∑
i
ei
√
35
8zi(x
3
i − 3xiy2
i )
Q43s =∑
i
ei
√
35
8zi(3x
2
i yi − y3
i )
c©CCLRC 16
Q44c =∑
i
ei
1
8
√35(x4
i − 6x2
i y2
i + y4
i )
Q44s =∑
i
ei
1
2
√35(x3
i yi − xiy3
i )
DL MULTI does not use the following directives from DL POLY . bonds, con-
straints, pmf, angles, dihedrals, inversions teth. For DL MULTI the recordsrigid units and mulaxes are described below. Note that the atomic site indicesreferred to below are indices arising from numbering each atom in the molecule from1 to the number specified in the atoms directive for this molecule. This same num-bering scheme should be used for all descriptions of this molecule. DL MULTI willitself construct the global indices for all atoms in the systems, as for DL POLY .
5. rigid n or rigid units n
where n is the number of rigid units in the molecule. For DL MULTI n must be 1. Itis followed by one record, specifying the sites in a rigid unit:
m integer number of sites in rigid unitsite 1 integer first site atomic indexsite 2 integer second site atomic indexsite 3 integer third site atomic index.. .. etc.
site m integer m’th site atomic index
Up to 15 sites can be specified on the first record. Additional records are used ifnecessary. Up to 16 sites are specified per record thereafter. The format is 16i5.
6. mulaxes
mulaxes a40 Define the axis system used to define the multipoles
There is a second keyword on the mulaxes directive.
rotint , the multipole components are described with respect to the principle mo-ments of inertia axis system. As for DL POLY , the principal axes are assignedto molecular types with the components of the rotational inertia tensor I obey-ing: Ixx ≥ Iyy ≥ Izz (to insure all processors converge on the same axes system).There is an addition in DL MULTI from the standard DL POLY which ensuresthat the principal axes are always in the same direction with respect to multi-plication by -1. This ensures that the multipole components can be defined withrespect to this axis system unambiguously.
c©CCLRC 17
molaxes , the multipole components are described with respect to an axis systemdefined by atoms in the molecule. This will be the normal input method forDL MULTI , although internally the program will carry out a conversion usingWigner matrices to the rotint convention before carrying out any calculation.
The mulaxes record must be followed by one record with 9 integer values format9i5.
direction 1atom 1aatom 1bdirection 2atom 2aatom 2batom 2cdirection 3enantiomer flag
direction 1, 2 and 3 refer to the x, y and z directions in the local axis system.(Use the integer 1 for x, 2 for y and 3 for z, each of the values must be usedonce). Usually direction 1 will be 1, direction 2 will be 2 and direction 3 will be3, and this must be the order if the enantiomer flag is −1. The axis in direction1 (normally x axis) is defined along the bond from atom 1a to atom 1b. The axisin direction 2 (normally y axis) is defined in the plane containing atoms 2a, 2band 2c, and normal to the axis in direction 1. The axis in direction 3 ( normallyz axis) makes a right handed set with 1 and 2. The enantiomer flag can havevalues 1 or -1.
In many crystalline systems the crystal structure contains a mixture of twoenantiomers (at least experimentally). Often this will be the result of a slightdeparture from planarity in the experimental results which may or may not bephysically real. To permit the user the option of inputting a pair of enantiomers,they are treated by DL MULTI as two separate molecules. However, the settingup of the molecular axes using molaxes will set up two right handed axes systemswhich are not mirror images of each other. To allow for this the signs of theappropriate multipole components need to be changed. There are two ways theuser can do this. First, the user can change the sign of all the odd-z componentsin the multipole description of the second molecule. Secondly, the user can usethe enantiomer flag -1 and leave the components as they are. DL MULTI willthen change the sign of the odd-z components. Note that if a non-standard orderof the axes in molaxes is used, then the first method must be used. The userwill need to change the sign of the odd-x or odd-y components for the secondmolecule (according to which axis is defined third in the description).
7. finish
This directive is entered to signal to DL POLY that the entry of the details of a
c©CCLRC 18
molecule has been completed.
The entries for a second molecule may now be entered, beginning with the name-of-
molecule record and ending with the finish directive.
The cycle is repeated until all the types of molecules indicated by the molecules
directive have been entered.
The user is recommended to look at the example FIELD files in the data directory tosee how typical FIELD files are constructed.
2.1.3.3 Non-bonded Interactions
Non-bonded interactions are identified by atom types as opposed to specific atomic indices.The description in DL MULTI is the same as in DL POLY .
c©CCLRC 19
2.2 The OUTPUT Files
DL MULTI writes the same output files as DL POLY . The only differences are in theOUTPUT file.
2.2.1 The OUTPUT File
The job output consists of 7 sections: Header; Simulation control specifications; Forcefield specification; Summary of the initial configuration; Simulation progress; Summary ofstatistical data; Sample of the final configuration; and Radial distribution functions. Thesesections are written by different subroutines at various stages of a job. Creation of theOUTPUT file always results from running DL MULTI . It is meant to be a human readablefile, destined for hardcopy output.
2.2.1.1 Header
DL MULTI output is the same as DL POLY
2.2.1.2 Simulation Control Specifications
DL MULTI writes out the Ewald convergence parameter that DL POLY would use and thereciprocal space cutoffs. These values are not used by DL MULTI . The correct values areprinted when the force field and initial configuration have been read in.
2.2.1.3 Force Field Specification
In addition to the normal DL POLY output, DL MULTI writes out the input distributedmultipoles
2.2.1.4 Summary of the Initial Configuration
In addition to the normal DL POLY output, the cutoffs for the Ewald sum for each poleorder are written out. These are also recalculated every 100 time steps and written to theOUTPUT file, since for simulations in which the cell volume changes the cutoffs may needto be changed to obtain the same accuracy.
2.2.1.5 Simulation Progress
This is the same as DL POLY , apart from the cutoff recalculation.
2.2.1.6 Remaining subsections
These are all the same as for DL POLY .
Bibliography
[1] Price, S. L., Stone, A. J., and Alderton, M., 1984, Mol. Phys., 52, 987–1001.
[2] Smith, W., and Forester, T. R., 1994, Comput. Phys. Commun., 79, 52.
[3] Smith, W., and Forester, T. R., 1994, Comput. Phys. Commun., 79, 63.
[4] Stone, A. In Maksic, Z. B., editor, Theoretical Models of Chemical Bonding, Part 4.Springer-Verlag, 1991.
20