Home

THE DL-POLY-4 USER MANUAL

Contents

1. The effect of this algorithm is thermostat the system on a local scale Particles that are too cold are given more energy by the noise term and particles that are too hot are slowed down by the friction Numerical instabilities which usually arise from inaccurate calculation of a local collision like process are thus efficiently kept under control and cannot propagate The generation of random forces is implemented in the routine LANGEVIN_FORCES The VV implementation of the algorithm is tailored in a Langevin Impulse LI manner 75 1 VVI AA A 3 36 m 1 exp x At VIxmkgT gt r t At e r t 4 e AA Zz X xm u t 4 A e exp x At u t e x At where Z x At and Za x At are joint Gaussian random variables of zero mean sampling from a bivariate Gaussian distribution 75 1 2 Z _ da ere 0 E Mi 3 37 Z 0 02 05 At a Ry with 1 kx A ok e a XA 4 12 3 38 and R vectors of independent standard Gaussian random numbers of zero mean and unit variance Gauss 0 1 easily related to the Langevin random forces as defined in equation 3 35 2 RATTLE_VV1 3 FF f t At f t 3 39 4 VV2 1 u t At v t 4 At y 3 40 5 RATTLE VV2 The algorithm is self consistent and requires no iterations The LFV implementation of the Langevin thermostat is straightforward 1 FF f t f t At Rit R t
2. warning o error o scan_control_io o numeric_container o spme_container o quaternions_container o scan_field o scan_control_pre o read_config_parallel o scan_config o scan_control o read_config o set_bounds o read_control o bonds_table_read o angles_table_read o dihedrals_table_read o inversions_table_read o vdw_generate o vdw_table_read o vdw_direct_fs_generate o metal_generate o metal_table_read o metal_table_derivatives o tersoff_generate o dihedrals_14_check o read_field o check_config o origin_config o scale_config o write_config o trajectory_write o system_expand o rigid_bodies_tags o rigid_bodies_coms o rigid_bodies_widths o rigid_bodies_setup o init_intra o tag_legend o report_topology o pass_shared_units o build_book_intra o build_excl_intra o scale_temperature o update_shared_units o core_shell_quench o constraints_tags o constraints_quench o pmf_coms o pmf_tags o pmf_vcoms o pmf_quench o rigid_bodies_quench o set_temperature o vdw_lrc o metal_lrc o system_init o vnl_check o export_atomic_data o set_halo_particles o export_atomic_positions o refresh_halo_positions o rigid_bodies_stress o read_history o defects_reference_read o defects_reference_read_parallel o defects_reference_write o defects_reference_export o defects_reference_set_halo o defects_link_cells o defectsi_write o defects_write o msd_write o rsd_write o vaf_write o impact o core_shell_on_to
3. 81 STFC Section 3 5 and the velocity updates for VV and LFV algorithms as Wi r t At e nOr At olt ZA IS O ENT AN 3 136 LFV r t At 5 IS This ensemble is optionally extending to constant normal pressure and constant surface area NP AT 72 by semi isotropic constraining of the barostat equation of motion to 1 E Port oz2 t V a 6 2 Mas t 4 1 a d a y 3 137 0 gt ao 2 Similarly this ensemble is optionally extending to constant normal pressure and constant surface tension NP yT 72 by semi isotropic constraining of the barostat equation of motion to 1 ER Post Yext V t Ae t caalt V d 2 y Toa 4 _ Bat Po 02 t V 8 Te e Te 0 a 6 where Yext is the user defined external surface tension and h t V t Azy t is the instantaneous hight of the MD box or MD box volume over area One defines the instantaneous surface tension as given in equation 3 120 The case Yext 0 generates the NPT anisotropic ensemble for the orthorhombic cell imcon 2 in CONFIG see Appendix A This can be considered as an orthorhombic constraint on the NoT ensemble The constraint can be strengthened further to a semi orthorhombic one by imposing that the MD cell change isotropically in the x y plane which leads to the following change in the equations above BAt Poo V t Oxplt Oyylt Tp ext h t 2 Vit a d 2 y 3 139 Naalt
4. Action Look at the preceding warning message in OUTPUT and find out which entry of what intra molecular like interaction is at fault Correct the bonding description and try running again Message 625 error only one rigid directive per molecule is allowed DL_POLY_4 has found more than one rigids entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 630 error too many rigid body units specified This should never happen This indicates an erroneous FIELD file or corrupted DL_POLY_4 executable Unlike DL_POLY_Classic DL_POLY_4 does not have a set limit on the number of rigid body types it can handle in any simulation this is not the same as the total number of RBs in the system or per domain Action Examine FIELD for erroneous directives correct and resubmit Message 632 error rigid body unit MUST have at least 2 sites This is likely to be a corrupted FIELD file Action Examine FIELD for erroneous directives correct and resubmit Message 634 error rigid body unit MUST have at least one non massless site No RB dynamics is possible if all sites of a body are massless as no rotational inertia can be defined Action Examine FIELD for erroneous directives correct and resubmit Message 638 error coincidence of particles in rigid body unit This indicates a corrupted FIELD file as all members of a RB unit must be destinguishable from one another Action Exa
5. All of these can be used in conjunction with the shell model technique used to account for ions polarisation The SPME technique is restricted to periodic systems only Users must exercise care when using pseudo periodic boundary conditions The other techniques can be used with either periodic or non periodic systems safely although in the case of the direct Coulomb sum there are likely to be problems with conver gence DL_POLY_4 will correctly handle the electrostatics of both molecular and atomic species However it is assumed that the system is electrically neutral A warning message is printed if the system is found to be charged but otherwise the simulation proceeds as normal Note that DL_POLY_4 does not use the basic Ewald method which is an option in DL_POLY_Classic on account of it being too slow for large scale systems The SPME method is the standard Ewald method in DL POLY 4 2 4 1 Direct Coulomb Sum Use of the direct Coulomb sum is sometimes necessary for accurate simulation of isolated non periodic systems It is not recommended for periodic systems The interaction potential for two charged ions is 1 3 95 Ul r rij TEQE Tij 2 189 2Unlike the other elements of the force field the electrostatic forces are NOT specified in the input FIELD file but by setting appropriate directives in the CONTROL file See Section 6 1 1 45 STFC Section 2 4 with q the charge on an a
6. FC ftn c FCFLAGS 03 en EX EX BINROOT BINROOT TYPE 230 Appendix C archer cray debug MAKE LD ftn o LDFLAGS 03 en G2 FC ftn c FCFLAGS 03 en G2 EX EX BINROOT BINROOT TYPE archer pathscale MAKE LD ftn o LDFLAGS byteswapio 03 FC ftn c FCFLAGS byteswapio 03 EX EX BINROOT BINROOT TYPE CRAY XT3 6 pathscale compilers DEBUG archer pathscale debug MAKE LD ftn o LDFLAGS byteswapio 00 g ffortran bounds check FC ftn c FCFLAGS byteswapio 00 g ffortran bounds check A EX EX BINROOT BINROOT TYPE archer X2 MAKE LD ftn o LDFLAGS 03 Ofp3 Ocache2 rm FC ftn c FCFLAGS 03 Ofp3 Ocache2 rm EX EX BINROOT BINROOT TYPE CRAY X2 DEBUG archer X2 debug MAKE LD ftn o LDFLAGS GO 00 rm FC ftn c FCFLAGS GO 00 rm EX EX BINROOT BINROOT TYPE Default code master message check OBJ_MOD OBJ_ALL LD EXE LDFLAGS OBJ_MOD OBJ_ALL Message message echo DL_POLY_4 compilation in MPI mode echo echo Use mpi_module must change to Use mpi in comms_module f90 231 STFC Appendix C echo Check that a platform has been specified check if test FC undefined the
7. While the statistics are always collected and stored for the future use in the binary REVIVE file for all targeted PDF s see Section 6 2 8 using the print analysis directive will instruct DL_POLY_4 to addition ally print the data in the OUTPUT and DAT files the latter containing each type of PDF s separately the asterisk stands for one of the following BND ANG DIH or INV As a result apart from OUTPUT three data files will be created for each of the targeted distribution types BNDDAT BNDPMF amp BNDTAB for bonds ANGDAT ANGPMF amp ANGTAB for angles DIHDAT DIHPMF DIHTAB for dihedrals and INVDAT INVPMF amp INVTAB for inversions the PMF and TAB files containing tabulated data for the respective potential of mean force and force virial TAB files bearing the data from PMF files but resampled onto a finer grid see the last paragraph in this section Partial examples of the DAT files for bonds and angles are given below userChost more BNDDAT TITLE Hexane FA OPLSAA gt CG mapped with 3 beads A B A BONDS Probability Density Functions PDF histogram bin hist_sum bins dr_bin bins cutoff frames types 250 5 000 2285 1 r Angstroms PDF_norm r PDF_norm r dVol r dr_bin 0 02000 type index instances A B 1 2000 0 01000 0 000000E 00 0 000000E 00 0 03000 0 000000E 00 0 000000E 00 0 05000 0 000000E 00 0 000000E 00 4 95000 0 Q00000E 00 0 000000E 00 4 97000 0 000
8. o ft Tapa Erersott 53 5 3 gt 2 163 Tg ee e with atomic label 4 being one of i j k and a indicating the x y z component The derivative after the summation is worked out as OU o 0 o Ore ore fo rig fr rig a Ge tora Faria folris Faris q 2 164 with the contributions from the first two terms being 0 o gra e Cu Faris OS fotra gr rkris frla gp Sera x foni sy 2 165 Til Tej o o o Vi Gators falas Vj ae aonn i fa gE S 4 2 i 2 166 Tig Tej and from the third angular term 41 STFC Section 2 3 e ters felis falris a a Vis folrij falrij Xij X 1 Ae E Ni pm m Mm pmi 5 1 Ai c3 Bm LE aha gt 2 167 where 0 gat E29 Wik fo Tik g 0 ijk 2 168 ve ne k ij The angular term can have three different contributions depending on the index of the particle par ticipating in the interaction a o L i wat ie Wik a 0551 r gra oa folrix 579 a HO Ai e O f j Ta D9 Wik fo rik Bra Piar 2 169 are i Or Ai ae o 0 o LAI Sr are nid Wil tuna tte ao so e kihs O Sotris falri Fai folris falriz x xy 01 o 6 q 1 LF LL 2 170 5 org where 0 ore iG gt a gt Wik Tij Tik fo rik g Oijk 2 171 C kid It is worth noting that the derivative of wig 9 Bi 1 rij Tk grg 0 Pi rij Ti Wik 3 de ot der ba f 2 172 now has three different contributions depending on the index of the part
9. y 19 2 39 2 40 2 41 2 42 2 43 2 44 STFC Section 2 2 7 OPLS torsion potential opls U Ao A 1 cos Ag 1 cos 2 Az 1 cos 3 2 45 8 Tabulated potential tab The potential is defined numerically in TABDIH see Section 4 3 and Section 6 1 8 In these formulae ijkn is the dihedral angle defined by Pijkn cos THB rij Lik kn 2 46 with 2 47 fij x Tip Tae x a Lij x Tito e X Pia With this definition the sign of the dihedral angle is positive if the vector product Ca a X Tjk X Tkn is in the same direction as the bond vector r and negative if in the opposite irection B rij Tiks Lkn The force on an atom arising from the dihedral potential is given by o a _ wee ey 2 48 fE gpg Orin 2 48 with being one of i j k n and a one of x y z This may be expanded into 0 1 o o U ijkn lt ijkn a B Tij Lik Ten 2 49 aa jkn E OPijkn U ign are Liz Lt Pen 12449 The derivative of the function B r j tjk kn iS o 1 o Bre Bt Tiks Tkn E x Tik Tjk X Tkn tij X LjrllEjr X Lun Ore COS Pijkn 1 r 1 9 EG Pik XT 2 50 2 rig X Likl are i Tjk je X Tink are tak Tn 2 50 with 0 Q apa tay X Pje Ejk X Lande ro lEjktjklal ek den Cjktknl al ek 005 2 ree llLijLjrlal tn Sek EjrLanla 2 Sei
10. 3 2 Bond Constraints The SHAKE algorithm for bond constraints was devised by Ryckaert et al 73 and is widely used in molecular simulation It is a two stage algorithm based on the leapfrog Verlet integration scheme 22 In the first stage the LFV algorithm calculates the motion of the atoms in the system assuming a complete absence of the rigid bond forces The positions of the atoms at the end of this stage do not conserve the distance constraint required by the rigid bond and a correction is necessary In the second stage the deviation in the length of a given rigid bond is used retrospectively to compute the constraint force needed to conserve the bondlength It is relatively simple to show that the constraint force has the form 2 2 GER 1 pig di dis de a 3 16 where pij is the reduced mass of the two atoms connected by the bond dp and di are the original and intermediate bond vectors d is the constrained bondlength and At is the Verlet integration time step It should be noted that this formula is an approximation only 60 STFC Section 3 2 Figure 3 1 The SHAKE RATTLE_VV1 schematics and associated vectors The algorithm calculates the constraint force G G that conserves the bondlength dj between atoms 1 and j following the initial movement to positions 7 and j under the unconstrained forces F and F and velocities v and v The RATTLE algorithm was devised by Andersen 23 and it fits w
11. Cell size and shape variations The isotropic algorithms VV and LFV may be extended to allowing the cell shape to vary by defining 7 as a tensor 7 and extending the Langevin pressure variable R to a stochastic Langevin tensor Rp Rpa t Rpg t 2 xp Pmass kBT dij tt 3 113 which is drawn from Gaussian distribution of zero mean and unit variance Gauss 0 1 scaled by y A AEE kg is the Boltzmann constant T the target temperature and pmass the barostat mass Note that Rp has to be symmetric and only 6 independent components must be generated each timestep The equations of motion are written in the same fashion as is in the isotropic algorithm with slight modifi cations as now the equations with 7 are extended to matrix forms d Hot vt mit r t d f t R t Tr n t ui 2S aly i sat qt a x 1 n t F 1 v t d a t Pes V t 1 2Erin t 1 Rp nt D 3 114 gin Pmass f Pmass pnl Pmass f 3 kp Text Pmass 3 27 xp d H t t H t CHE a t HO d ay Tela VE where g is the stress tensor equation 3 96 and 1 is the identity matrix The conserved quantity these generate is Pmass Trin nT Hnot Hyve 4 PoV t 3 115 2 the VV and LFV algorithmic equations are therefore written in the same fashion as in the isotropic case with slight modifications For the VV couched algorithm these are of the following sort Jo 7 0 m Pmass f
12. STFC Section 2 2 Following through the extremely tedious differentiation gives the result 1 0 w U d x 2 68 fi E Odijkn dijkn cos dijkn 1 me ae do di Er dej Sei ij gt Ugo Ur Liz Ben kn Tij TijWkn Ti bp oe i i yo 02 dei y fir tiz en rij Tik T rij then Tik ren E UknTik Tik Ti Op m P ro Sek Oe Z ap Cip e Cir Ven E UknTik Tik Ti ty ro 5en dei fij ti Bin On Lij Lin iy kn Tin kn 7 UknTin Tin Ti Op O i ro den 045 a os Lij Diy Ue rij Lin T i ire Lin WEJ Ukntin in This general formula applies to all atoms i j k n It must be remembered however that these formulae apply to just one of the three contributing terms i e one angle of the full inversion potential specifically the inversion angle pertaining to the out of plane vector r The contributions arising from the other vectors Tik and Tip are obtained by the cyclic permutation of the indices in the manner described above All these force contributions must be added to the final atomic forces Formally the contribution to be added to the atomic virial is given by 4 W Son f 2 69 i 1 However it is possible to show by thermodynamic arguments cf 42 or simply from the fact that the sum of forces on atoms j k and n is equal and opposite to the force on atom
13. The DEFECTS file is the dump file of atomic coordinates of defects see Section 6 1 4 Its principal use is for off line analysis The file is written by the subroutine DEFECTS_WRITE The control variables for this file are ldef nsdef isdef and rdef which are created internally based on information read from the defects directive in the CONTROL file see Section 6 1 1 The DEFECTS file will be created only if the directive defects appears in the CONTROL file The DEFECTS file may become very large especially if it is formatted For serious simulation work it is recommended that the file be written to a scratch disk capable of accommodating a large data file The DEFECTS has the following structure record 1 header a72 file header record 2 rdef real site interstitial cutoff A in last frame frame integer number configuration frames in file records integer number of records in file For timesteps greater than nsdef the DEFECTS file is appended at intervals specified by the defects directive in the CONTROL file with the following information for each configuration record i timestep a8 the character string timestep nstep integer the current time step tstep real integration timestep ps time real elapsed simulation time ps imcon integer periodic boundary key see Table 6 6 rdef real site interstitial cutoff A record ii defects aT the character string defects ndefs integer the total number of defects interstitials a
14. are obtained by the READ_FIELD routine which reads the FIELD file The SYSTEM_INIT routine is called next to initialise various simu lation arrays and variables with the data available so far and detects if the job is a restart of previous simulation run If so it reads the REVOLD Section 6 1 5 to supply some arrays and variables with the necessary values as saved from the previous job The domain halo is constructed immediately afterwards by the routine SET_HALO_PARTICLES After gathering all these data bookkeeping and exclusion arrays are created for the intramolecular and site related interactions core shell constraint and tether units by the BUILD_BOOK_INTRA and BUILD_EXCL_INTRA routines Lastly the thermodynamic properties of the system are checked and set by the SET_TEMPERATURE routine which also generates the initial velocities if required to do so The calculation of the pair like forces is carried out in the TWO_BODY_FORCES routine and represents the main part of any simulation For calculation of the two body contributions to the atomic forces the Verlet neighbour list is constructed by the LINK_CELL_PAIRS routine using link cell lists Special measures are taken so that the list excludes i pairs of atoms that are both in a frozen state as well as ii pairs in 104 STFC Section 5 2 which one of the atoms has the other in its exclusion list The last is built by BUILD EXCL_INTRA where the specifications of bond like in
15. config_module o development_module o dihedrals_module o greenkubo_module o inversions_module o kinds_f90 o rdf_module o setup_module o statistics_module o z_density_module o tag_legend o setup_module o tersoff_forces o comms_module o config_module o domains_module o kinds_f90 o0 setup_module o tersoff_module o tersoff_generate o kinds_f90 o setup_module o tersoff_module o tersoff_module o kinds_f90 o setup_module o tethers_forces o comms_module o config_module o kinds_f90 o setup_module o statistics_module o tethers_module o tethers_module o kinds_f90 o setup_module o three_body_forces o comms_module o config_module o domains_module o 222 STFC Appendix C kinds_f90 o setup_module o three_body_module o three_body_module o kinds_f90 o setup_module o trajectory_write o comms_module o config_module o io_module o kinds_f90 0 parse_module o setup_module o statistics_module o two_body_forces o comms_module o config_module o ewald_module o kim_modul o kinds_f90 o metal_module o rdf_module o setup_module o vdw_module o vnl_module o update_shared_units o comms_module o domains_module o kinds_f90 o0 setup_module o vaf_collect o comms_module o config_module o greenkubo_module o kinds_f90 0 setup_module o vaf_compute o comms_module o greenkubo_module o kinds_f90 o setup_module o site_module o vaf_write o comms_module o config_module o greenkubo_module o kinds_f90 0 A setup_module o site_module o
16. where x and xp are the user defined constants positive in units of ps specifying the thermostat and barostat friction parameters R t is the Langevin stochastic force see equation 3 35 P the instantaneous pressure equation 3 95 and Rp is the stochastic Langevin pressure variable Rp t R t 2 Xp Pmass kgT t gt t 3 98 which is drawn from Gaussian distribution of zero mean and unit variance Gauss 0 1 scaled by 4 Z kpg is the Boltzmann constant T the target temperature and Pmass the barostat mass H is the cell matrix whose columns are the three cell vectors a b c The conserved quantity these generate is Mass t a Hyper HNveE Pass m0 PexiV t 3 99 The VV implementation of the Langevin algorithm only requires iterations if bond or PMF constraints are present 4 until satisfactory convergence of the constraint forces is achieved These are with re spect to the pressure i e n t in the first part VV1 RATTLE_VV1 The second part is conventional VV2 RATTLE_VV2 as at the end the velocities are scaled by a factor of x 1 Thermostat Note 2E in t changes inside u t exp x u t 3 100 2 Barostat Note Exin t and P t have changed and change inside nt ep x 7 100 At net A e net Bve otg 3 2Ekin t 1 so f Pmass Pmass nl At exp Xp n t 4 Tat ul e exp 1 3 n t 4 TAi pi v t 3 101 A nt As exp Xp x n t 4 TAi
17. 03 q64 qmaxmem 1 FC mpx1f90_r qsuffix f f90 c FCFLAGS 03 q64 qmaxmem 1 qarch pwr5 qtune pwr5 qnosave EX EX BINROOT BINROOT TYPE hpcx debug MAKE LD mpxlf90_r o LDFLAGS g C q64 00 lessl lhmd 210 STFC Appendix C FC mpx1f90_r qsuffix f f90 c FCFLAGS g C q64 00 qarch pwr5 qtune pwr5 qnosave EX EX BINROOT BINROOT TYPE BGL MAKE LD bgl1 BlueLight ppcfloor bglsys bin mpixlf95 o LDFLAGS 03 qhot qarch 440d qtune 440 FC bgl1 BlueLight ppcfloor bglsys bin mpixlf95 c FCFLAGS 03 qhot qarch 440d qtune 440 EX EX BINROOT BINROOT TYPE BGP MAKE LD bgsys drivers ppcfloor comm bin mpixlf2003_r o LDFLAGS 03 qhot qarch 450d qtune 450 qmaxmem 128000 FC bgsys drivers ppcfloor comm bin mpixlf2003_r c FCFLAGS 03 qhot qarch 450d qtune 450 qmaxmem 128000 EX EX BINROOT BINROOT TYPE archer MAKE LD ftn o LDFLAGS 03 FC ftn c FCFLAGS 03 EX EX BINROOT BINROOT TYPE archer pgi debug MAKE LD ftn o LDFLAGS 00 W Wall pedantic std f2003 g fbounds check fbacktrace finit real nan finit integer 999999 FC ftn c FCFLAGS 00 W Wall pedantic std f2003 g fbounds check fbacktrace finit real nan finit integer 999999 EX EX BINROOT BINROOT TYPE archer gnu MAKE LD ftn o LDFLAGS 03 Wall pedanti
18. 1 The VV and LFV flavours of the non isotropic Berendsen barostat and thermostat are implemented in the DL_POLY_4 routines NST_B0O_VV and NST_BO_LFV respectively The routines NST_B1_VV and NST_B1_LFV implement the same but also incorporate RB dynamics 3 5 4 Nos Hoover Barostat DL_POLY 4 uses the Melchionna modification of the Nos Hoover algorithm 77 in which the equations of motion involve a Nos Hoover thermostat and a barostat in the same spirit Additionally as shown in 78 a modification allowing for coupling between the thermostat and barostat is also introduced Cell size variation For isotropic fluctuations the equations of motion are TO u t n t r t Ro t fy ke tnol d _ 2Exin t Pmass ny 20 kg Toxt ge E dmass alo ES E 72 3 140 82 STFC Section 3 5 Sit avo E ee _ ong Pmass f 3 kp Text Tp SH nl HO SVO BuO VO where is the barostat friction coefficient Ry t the system centre of mass at time t dmass the ther mostat mass Tr a specified time constant for temperature fluctuations o the target thermostat energy equation 3 57 Pmass the barostat mass Tp a specified time constant for pressure fluctuations P the instantaneous pressure equation 3 95 and V the system volume H is the cell matrix whose columns are the three cell vectors a b c The conserved quantity is to within a constant the Gibbs free energy of the system Mass t 2
19. 1 for r gt ryaw DL POLY_4 sometimes makes the additional assumption that the repulsive part of the short ranged potential is negligible beyond fyaw The correction for the system virial is we 2n 2 f iho TAP a 2 102 corr V bus Or where the same approximations are applied Note that these formulae are based on the assumption that the system is reasonably isotropic beyond the cutoff DL_POLY_4 allows a short cut for mixing some of the explicitly specified pair interactions for single species of the same type so that cross species interactions are generated if unspecified This is only possible for the 12 6 lj dpd amoeba amp wea types The mixing is derived from the Lennard Jones style characteristic paramteres for energy e and distance or rg terms The available types of mixing within DL_POLY 4 are borrowed from 51 The rules names and formulae are as follows 1 Lorentz Berthelot oi 0 Ej eG A A 2 103 2 Fender Halsey 2 104 3 Hogervorst good hope Eij Si Ej 5 Fig y0 OF 2 105 4 Halgren HHG 0 oj o 48 6 tj Vago y fij 9 2 106 5 Tang Toennies 12113 12 P E 2 50 eo EijOi OZ Ejoj 5 TG 5 2 107 6 Functional _ a a 03403 2 ME y L 0 3 0 07 12 3 03 Ej 0 0 i TO ye Ej Ti Oj _ y 2 108 4 0 0 It is woth noting that the and j symbols in the equations for mixing denote atom types
20. 2com t O constrain t E At ZPMF t E At 3 204 are augmented to include the RBs COM virial and stress contributions Note that the kinetic energy and stress in the above also include the contributions of the RB s COM kinetic energy and stress It is straightforward to couple the rigid body equations of motion to a thermostat and or barostat The thermostat is coupled to both the translational and rotational degrees of freedom and so both the transla tional and rotational velocities are thermostated in the same manner as the purely atomic velocities The barostat however is coupled only to the translational degrees of freedom and does not contribute to the rotational motion Therefore if we notion the change of the system s degrees of freedom as f gt F f4 pees p ane ae 3 205 then all equations of motion defining the ensembles as described in this chapter are subject to the following notional changes in order to include the RB contributions df gt o F o f altea fPB rot HAD gt H F H f fRB tra y fRBGrot Pmass f gt Pmass F f pmass f JEAN 3 206 nif gt n F fRB ot nlf FEPER a gt nF JEPTE n f pra 94 STFC Section 3 6 where f refers to the degrees of freedom in the system see equation 3 11 o is the system target energy see equation 3 57 H is the conserved quantity of the ensemble if there is such defined Exin includes RB COM kine
21. DL_POLY_4 requires seven input files named CONTROL CONFIG FIELD TABLE TABEAM REFER ENCE and REVOLD The first three files are mandatory whereas TABLE and TABEAM are only used to input certain kinds of pair or metal potentials and may not always be required REFERENCE is required only if defect detection is switched on in CONTROL REVOLD is required only if the job represents a continuation of a previous job In the following sections we describe the form and content of these files 6 1 1 The CONTROL File The CONTROL file is read by the subroutine READ_CONTROL and defines the control variables for running a DL_POLY_4 job It is also read by the subroutine SCAN_CONTROL in the SET_BOUNDS routine It makes extensive use of directives and keywords Directives are character strings that appear as the first entry on a data record or line and which invoke a particular operation or provide numerical parameters Also associated with each directive may be one or more keywords which may qualify a particular directive by for example adding extra options Directives can appear in any order in the CONTROL file except for the finish directive which marks the end of the file Some of the directives are mandatory for example the timestep directive that defines the timestep others are optional This way of constructing the file is very convenient but it has inherent dangers It is for example quite easy to specify contradictory directives or invoke
22. STFC Section 3 4 3 4 6 Gentle Stochastic Thermostat The Gentle Stochastic Thermostat 71 76 is an extension of the Nos Hoover algorithm 30 dr t an 7 vt 20 ow 880 in which the thermostat friction x has its own Brownian dynamics dx t _ 2EKin t 20 x t 4 V2 7 Be Text qmass dw t l 3 81 dt dmass dmass dt governed by the Langevin friction y positive in units of ps where w t is the standard Brownian motion Wiener process Gauss 0 1 is the target thermostat energy as in equation 3 57 mass 2 0 T 3 82 is the thermostat mass which depends on a specified time constant Ty for temperature fluctuations normally in the range 0 5 2 ps It is worth noting that equation 3 81 similar to the Ornstein Uhlenbeck equation dx ao dw 3 83 dt 2 a eee which for a given realization of the Wiener process w t has an exact solution e2 et 1 Xn 1 e Xn 04 Aw 3 84 where e ao 2 and Aw N 0 1 The VV implementation of the Gentle Stochastic Thermostat algorithm takes place in a symplectic manner as follows 1 Thermostat Note Exin t changes inside and R t drown from Gauss 0 1 is carried over from the previous half timestep x t TAi lt y t exp y ra i Text 1 exp y FT R t dmass l At 2Ekin t 20 4 Amass LA v t e v t exp x t At 3 85 1 1 At kp Text At pe 1 i t x t 340 x t
23. Ten Cig Tjkla Oew 025 njrLjrla lO 025 2rik Pi enla lg Sen gt 2 51 gallu X taal rth Lr jar ype ey du rigtjulal r Sex 2rie lragPigla Sen dej righ jrla Sei de 2 52 2 Q E X Tin rin IEjiTjrla lO See rj Pknla Se 2x 25 ULT imla OL Sej 25k Pkenla Sexr 2n 2 53 20 STFC Section 2 2 Where we have used the following definition a dla Y 1 8agjadv 2 54 B Formally the contribution to be added to the atomic virial is given by 4 i l However it is possible to show by tedious algebra using the above formulae or more elegantly by thermo dynamic arguments 42 that the dihedral makes no contribution to the atomic virial The contribution to be added to the atomic stress tensor is given by P ripe TS TED 2 56 cos Pijkn en ros righ rane rent l 2 with pe ik Likt knla Pipl rel rela UE x Talli ax X Trl Pr ik LijLjrla a rar jkla reg x 1 Pie X kn Pik ee Likt knla Erin rijtjkla z 25h rigPenla rag x Tall jk X Tr G Arillirlinlo Pill ijLjnlo Lig X riel 2 57 Ik 2 rjelPagPigle ri lijt jkla lCij x rial h Ur lenPenla RnlLjrL enla lEjr X Lan h Unreal te heal The sum of the diagonal elements of the stress tensor is zero since the virial is zero and the matrix is symmetric Lastly it should be noted that the above
24. archer pathscale debug echo archer X2 archer X2 debug echo echo Please examine this Makefile s targets for details echo If no target suits your system then create your own echo using the advice in generic target template provided echo in this Makefile under the entry uknown_platform 208 STFC Appendix C echo Fetch the Velocity Verlet subroutines FILES_VV MAKE links_vv links_vv for file in FILES_VV do echo linking to file rm f file ln s VV file file A done Fetch the LeapFrog Verlet subroutines FILES_LFV MAKE links_lfv links_lfv for file in FILES_LFV do echo linking to file rm f file ln s LFV file file done Clean up the source directory clean rm f 0BJ_MOD OBJ_ALL FILES_VV FILES_LFV mod Generic target template uknown_platform MAKE LD path to FORTRAN9O Linker loaDer LDFLAGS appropriate flags for LD MPI libraries FC path to FORTRAN9O compiler FCFLAGS appropriate flags for FC MPI include EX EX BINROOT BINROOT TYPE System specific targets follow P Cambridge HPC darwin Woodcrest hpc MAKE LD mpif90 o LDFLAGS 03 FC mpif90 c FCFLAGS 03 EX EX BINROOT BINROOT TYPE 209 STFC Appendix C hpcd MAKE LD mpif90 o LDFLAGS 00 g C FC mpif90
25. defects_link_cells o defectsi_write o defects_write o msd_write o rsd_write o vaf_write o impact o core_shell_on_top o deport_atomic_data o pmf_units_set o compress_book_intra o relocate_particles o link_cell_pairs o metal_1d_collect_eam o metal_1d_collect_fst o metal_ld_export o metal_ld_set_halo o metal_ld_compute o ewald_spme_forc s o metal_forces o vdw_forces o ewald_real_forces o coul_dddp_forces o coul_cp_forces o coul_fscp_forces o coul_rfp_forces o rdf_collect o rdf_excl_collect o rdf_frzn_collect o ewald_excl_forces o ewald_frzn_forces o two_body_forces o tersoff_forces o three_body_forces o four_body_forces o core_shell_forces o tethers_forces o intra_coul o bonds_forces o angles_forces o dihedrals_14_vdw o dihedrals_forces o inversions_forces o external_field_apply o external_field_correct o langevin_forces o constraints_pseudo_bonds o pmf_pseudo_bonds o rigid_bodies_split_torque o rigid_bodies_move o minimise_relax o core_shell_relax o zero_k_optimise o vaf_collect o nvt_e0_scl o nvt_el_scl o nvt_b0_scl o nvt_b1_scl o pseudo_vv o 234 STFC Appendix C constraints_shake_vv o pmf_shake_vv o constraints_rattle o pmf_rattle o nvt_h0_scl o nvt_gO_scl o npt_h0_scl o nst_h0_scl o A nve_0_vv o nvt_e0_vv o nvt_10_vv o nvt_a0_vv o nvt_b0_vv o nvt_h0_vv o nvt_g0_vv o npt_10_vv o npt_b0_vv o npt_h0_vv o npt_m0_vv o nst_10_vv o nst_b0_vv o nst_h0_vv o ns
26. in in angles_module gt allocate_angles_arrays bonds_module gt allocate_bonds_arrays core_shell_module gt statistics_module gt allocate_statitics_arrays tethers_module gt allocate_tethers_arrays constraints_module gt external_field_module gt dihedrals_module gt allocate_dihedrals_arrays inversions_module gt allocate_inversion_arrays 286 STFC Appendix D Message 1022 error allocation failure in vdw_module gt allocate_vdw_arrays Action See Message 1001 Message 1023 error allocation failure in metal_module gt allocate_metal_arrays Action See Message 1001 Message 1024 error allocation failure in three_body_module gt allocate_three_body_arrays Action See Message 1001 Message 1025 error Action See Message 1001 Message 1026 error Action See Message 1001 Message 1027 error Action See Message 1001 Message 1028 error Action See Message 1002 allocation failure in config_module gt allocate_config_arrays allocation failure in site_module gt allocate_site_arrays allocation failure in tersoff module gt alocate_tersoff_arrays deallocation failure in angles_module gt deallocate_angles_arrays Message 1029 error deallocation failure in bonds_module gt deallocate_bonds_arrays Action See Message 1002 Message 1030 erro
27. key potential type Variables 1 3 6 7 functional formt cos Cosine A S m U A 1 cos m 6 harm Harmonic k o U 5 doy hcos Harmonic cosine k o U d k cos cos 0 cos3 Triple cosine A Ag A3 U 3 4A 1 cos Az 1 cos 2 Ag 1 cos 3 ryck Ryckaert Bellemans 43 A U A a b cos c cos d cos e cos f cos rbf Fluorinated Ryckaert A U A a b cos c cos Bellemans 44 d cos e cos f cos g exp h opls OPLS torsion Ao A Ap U Ao 5 Ai 1 cos o Az do Az 1 cos 2 6 0 Az 1 cos 3 0 to is the i j k l dihedral angle Table 6 11 Inversion Angle Potentials key potential type Variables 1 3 functional formt harm Harmonic k do U E 6 bo hcos Harmonic cosine k o Ue E cos cos g plan Planar A U A 1 cos xpln Extended planar k m do U o E 1 cos m o calc Calcite A B U u Au Buf t is the i j k l inversion angle 150 STFC Section 6 1 13 This directive and associated data records need not be specified if the molecule contains no inversion angle terms See the note on the atomic indices appearing under the shell directive above Note that the calcite potential is not dep
28. print any opted for analysis inter amp and intra molecular PDF s 127 STFC Section 6 1 in OUTPUT as well as their corresponding files DAT PMF TAB print rdf print radial distribution functions print vaf print velocity autocorrelation functions print zden pseudo string fi fo quaternion tolerance f rdf sampling every f reaction field reaction field damp a reaction field precision f regauss every n replay history replay history force restart restart noscale print Z density profile attach a pseudo thermal bath with a thermostat of type string where string can only be langevin gauss or direct if none is specified then langevin gt direct are applied successively f is the thickness of the thermostat layers attached on the inside of the MD cell boundaries in units of A default f1 2 A fo is the thermostat temperature in Kelvin f2 gt 1 which when unspecified defaults to the system target temperature set quaternion tolerance to f default 1078 calculate and collect radial distribution functions every f timesteps default f 1 calculate electrostatic forces using reaction field electrostatics calculate electrostatic forces using reaction field electrostatics with Fennell 63 damping Ewald like convergence parameter amp in A calculate electrostatic forces using reaction field electrostatics with Fennell 63 damping Ewald like convergence derived by
29. zrs HR Zone pull out eee k ta Cae Le Nee eae ema Fem glob glob A z zmz z gt z zrs HR Zone pull in suet re k Sin me ES eis ne H osel Osc Electric Field Ez Ey E wina F q E sin 2rwt Thus to apply a magnetic field of 1 Tesla along the y axis one could specify in FIELD the following UNITS internal external magnetic 0 1 1 037837512e04 0 when working in DL_POLY internal units If we worked in unit units then Energy DL_POLY H DL_POLY H unit H x Energy Energy unit kunit DL_POLY H M KS 1 037837512 x 104 6 10 1 037837512 x 104 H MKS with the following conversion factors values keV gt DL_POLY 158 Kunit gt DL_POLY 9648 530821 OSTFC Section 6 1 Excal mol gt DL POLY 418 4 kkJ mol DL_POLyY 100 0 6 11 kk BoltzDL POLY 0 831451115 kpL POLY gt DL_POLY 1 0 Obviously for eV units 1 037837512 x 104 kunit gt DL_POLY kev DL_POLY 9648 530821 6 12 H eV H MKS 1 07564305 H unit H MKS the FIELD file should be amended to read UNITS eV external magnetic 0 1 1 07564305 0 6 1 3 4 Closing the FIELD File The FIELD file must be closed with the directive close which signals the end of the force field data Without this directive DL_POLY_4 will abort 6 1 4 The REFERENCE File The REFERENCE has the same format and structure as CONFIG see Section 6 1 2 file with the exception
30. 004 183 Tel DOTEE OOS oe e a ee e ee ee Se oe ee SE 184 T21 Modularisation Principles 2 2 40 s a s 460 42G 4 doe ee hee bane caw dae a 184 22 Wile Structure soc s ani oa 46 eae RB Ge ee ee Ee eee EE A 186 ea Module Piles ia 27s 00814 faa bee EE a eae a RS a pe 189 G24 General Files oi a aoe ge a eee ee ee Ae ee eee ee ee Oe 189 2 0 VV and LFV Specific Piles ca 44 2 6044 228 48 24g eS eR ae BG eR 189 7 2 6 SERIAL Specific Files gt gt s coac ee 189 2 7 Comments on MPI Handling s ss s 4 4 24 eos oak aie Ge Ba Se Pe ee ee Se 189 7 2 8 Comments on SETUP_MODULE 2 rob 0c eee ee 190 8 Examples 193 8 1 Test Cases 2 2 4 0 bd aa Gah ER ee REDE EE ERG DEE Eee ASS 194 8 1 1 Test Case 1 and 2 Sodium Chloride lt cos a s kia goddag aa a ate 0000008 194 212 Test Case 3 and 4 DPMC im Water u esus e Doei a aa a a a 194 31 3 Test Case Dand 6 KNabirOs 2 6 4655 2 2445 a Ge Pa ee 194 8 1 4 Test Case 7 and 8 Gramicidin A molecules in Water 02 195 8 1 5 Test Case 9 and 10 SiC with Tersoff Potentials 195 8 1 6 Test Case 11 and 12 CuzAu alloy with Sutton Chen metal Potentials 195 8 1 7 Test Case 13 and 14 lipid bilayer in water o 195 8 1 8 Test Case 15 and 16 relaxed and adiabatic shell model MgO 195 8 1 9 Test Case 17 and 18 Potential of mean force on K in water MgO 195 8 1 10 Test Case 19 and 20 CuzAu alloy with G
31. 02 000002 eee 110 5 3 A Guidetto Preparing Input Piles ev se ee ae ee ee PR Pe ed 111 Soul Morgane Materials ros dee Rd ORG hE wae a Chee BEE AG A 112 Doe Macromolecules ss a0 4 ca bu a be dod oe ESE a Bb kee dS 112 539 Adding Solvent toa Structure s s ek ey eA ee A A as 113 Dod Analysing Results cocidos Bee bee a E SRG SOSA REE ES 114 5 3 5 Choosing Ewald Sum Variables o o lt s a cera e aeaiaioe a aaa aa ee 114 oA Waring and Error Processing s s acs a a ge ny ek SO i ie ee Ge Pe ea 116 5 4 1 The DL POLY 4 Internal Warning Facility s s sa e aos s i minete ere Wa me 116 5 4 2 The DL POLY 4 Internal Error Facility o o 116 6 Data Files 117 Gal The INPUT PIES a a a A a Bek a ada lt A ae 118 GLI The CONTROL Pile css ata e E A eS 118 6 1 2 The CONFIG Pile sos s eiii aaa ride ee AAA ay ees 139 61 3 The FIELD File cis a cs pa p aiaa 4 588d a eRe Ee a a 141 GLA The REFERENCE Fil ec sac ede a eo a RES Bee de a AS 159 6o The REVOLD Pile 28 4 a a eee a Rae bb ale A ew ek ee es 159 6 6 The TABLE Fille cocos haa OR we a eRe a a RA ee 160 6 1 7 The TABEAM File ee ee 161 6 18 The TABBND TABANG TABDIH amp TABINV Files o 163 6 2 The OUTPUT Files lt sa 244 22h4 54 2208543 hee aa a A 164 G2 Whe HISTORY File ue E ee we a ok BE EE Bak tee a 165 62 2 The MSD TMP Pile y sigidi 4 6050 Sew hee ae ee Be See oe eee ey 166 623 The DEFECTS Pile ocios ee Gd ee eee be eee ES 1
32. 740 exp 1 az 1 exp 7 F Ryle At 2F pin t 2 de kinlt 20 4 dmass 2 VVI 1 At f t u t At u t T m 1 r t At e r t Atult 5At 3 86 72 STFC Section 3 4 3 RATTLE_VV1 4 FF f t At fit 3 87 5 VV2 Ap te 1 as ult At u t 5 At 4 gt a 3 88 6 RATTLE_VV2 7 Thermostat Note Exin t At changes inside and Ry t At is drown anew from Gauss 0 1 and is to be carried over the next half timestep 3 1 At kp Text y 1 x t At lt x t At exp yY ae At 2E pin t 20 4 dmass HERA E BELO exp x t FA gt 3 At kp Tex x t At x t At exp a a 1 i At 2E pin t 20 4 dmass The algorithm is self consistent and requires no iterations The LFV implementation of the Gentle Stochastic Thermostat algorithm is iterative as an initi exp y 1 Rg t At 3 89 exp y FI Ry t At al estimate of x t at full step is calculated using an unconstrained estimate of the velocity at full step v t 1 FF f t f t At 2 LFV The iterative part is as follows 1 ult 5AM v t At At fE XD 70 1 r t At E r t Atv 548 3 SHAKE 4 Full step velocity 1 2 u t Lut At pags 5A8 5 Thermostat Note R t is drown from Gauss 0 1 just once per timestep 1 1 A Tex At x t 5 At lt y t 5 At exp y 2 Je
33. At mass Nt At 20 kg Tox X E At E x t 40 5 rin t At P E FAUTE a E v t At e u t At Vot At where Vo t At is the c o m velocity at timestep t At and H is the cell matrix whose columns are the three cell vectors a b c The LFV implementation of the Nos Hoover algorithm is iterative until self consistency in the full step velocity v t is obtained Initial estimates of x t and n t at full step are calculated using an unconstrained estimate of the velocity at full step v t Also calculated is an unconstrained estimate of the half step position r t 5At 1 FF f t f t At 3 151 2 LFV The iterative part is as follows u t 5 At u t At At r t At r t At u t At n t 4 At rte 50 Ro t H t At exp n 5 At At H t 3 152 V t At exp fant ZAt At V t 3 SHAKE 4 Full step velocity and half step position 1 1 1 o e 7 Ec 5At ult 5 At EL AS r t r t At 3 153 2 2 5 Thermostat and Barostat 2_ EL x t At e x t 5At At 2Exin t Pmass n t 20 kB Text mass 1 1 t Pox t n t At exp yx t At n t At At Ja JV 1 1 1 VORS xe AD x t 541 3 154 1 1 1 n 5 nlt 3A0 ente 30 STFC Section 3 5 Several iterations are required to obtain self consistency In DL POLY_4 the number of iterations is set to 7 8 if bond constraints are present Note also that the cha
34. B 48 22 31 Johnson R A 1989 Phys Rev B 39 12556 39 Kumagai T Izumi S Hara S and Sakai S 2007 Comput Mat Sci 39 457 40 Eastwood J W Hockney R W and Lawrence D N 1980 Comput Phys Commun 19 215 43 44 45 Fennell C J and Gezelter D J 2006 J Chem Phys 124 234104 46 47 48 49 128 129 Neumann M 1985 J Chem Phys 82 5663 48 Fuchs K 1935 Proc R Soc A 151 585 50 51 Essmann U Perera L Berkowitz M L Darden T Lee H and Pedersen L G 1995 J Chem Phys 103 8577 50 182 Fincham D and Mitchell P J 1993 J Phys Condens Matter 5 1031 52 Lindan P J D and Gillan M J 1993 J Phys Condens Matter 5 1019 53 Shewchuk J R August 4 1994 An Introduction to the Conjugate Gradient Method Without the Agonizing Pain Edition 1 1 4 School of Computer Science Carnegie Mellon University Pittsburgh PA 15213 53 109 Schroder U 1966 Solid State Commun 4 347 349 53 Leimkuhler B Noorizadeh E and Theil F 2009 J Stat Phys 135 261 277 60 63 72 Ikeguchi M 2004 J Comp Chemi 25 529 541 60 79 82 87 89 Ryckaert J P Ciccotti G and Berendsen H J C 1977 J Comput Phys 23 327 60 179 McCammon J A and Harvey S C 1987 Dynamics of Proteins and Nucleic Acids Cambridge University Press 63 Izaguirre J A Langevin stabilisation of multiscale mollified dynamics In Brandt
35. C1ri car cari car UN i 1 j i rig O c1 2eariz 30377 Acgrigi ies 2 129 N 1 A 1 1 Wo gt 5 y 2 rij d 4B rij dy Tija 2 ja 2 AVPR Pi l 7 Sutton Chen virial ee a Y gt D eL i 1 Ai J N N m 1 mce OF pi aen a P 4 2 130 2 2 2 2 Op Op Tij STFC Section 2 3 8 Gupta virial Yi So P exp p ae ay i ll Bi 1 Ty r n DD t o 2 i 1 At ro ro 2 Tij 2 131 9 Many body perturbation component virial Y Si N N 2 me OF pi OF pj a UV 2 2 5 ie o T 2 132 The contribution to be added to the atomic stress tensor is given by got rope 2 133 where a and indicate the x y z components The atomic stress tensor is symmetric The long ranged correction for the DL_POLY_4 metal potential is in two parts Firstly by analogy with the short ranged potentials the correction to the local density is CO pi DE pyle j 1 j i Tij lt Tmet Tij2Tmet pm Dd pulu Dd pig riz pi pi 2 134 j 1 j i j 1 j i CO bo Amp f piglrdar Tmet where p is the uncorrected local density and J is the mean particle density Evaluating the integral part of the above equation yields 1 EAM density correction No long ranged corrections apply beyond ret 2 EEAM density correction No long ranged corrections apply beyond ret 3 2BEAM density correction No long ranged corrections apply beyond ry
36. Shin S and Rice S A 1996 J Chem Phys 104 2101 19 150 Rohl A L Wright K and Gale J D 2003 Amer Mineralogist 88 921 24 Raiteri P and Gale J D 2010 J Am Chem Soc 132 17623 17634 24 Mie G 1903 Annalen der Physik 11 657 697 27 152 Clarke J H R Smith W and Woodcock L V 1986 J Chem Phys 84 2290 27 152 Weeks J D Chandler D and Anderson H C 1971 J Chem Phys 54 5237 27 152 Groot R D and Warren P B 1971 J Chem Phys 107 11 44234435 28 152 Al Matar A K and Rockstraw D A 2004 J Comput Chem 25 660 668 29 Hepburn D J and Ackland G J 2008 Phys Rev B 78 16 165115 30 39 300 STFC Bibliography 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 79 Lau T T F rst C J Lin X Gale J D Yip S and Vliet K J V 2007 Phys Rev Lett 98 21 215501 30 39 Cooper M W D Rushton M J D and Grimes R W 2014 J Phys Condens Matter 26 105401 30 32 J F 1952 Philos Mag 43 153 30 Ackland G J and Reed S K 2003 Phys Rev B 67 1741081 1741089 30 Olsson P Wallenius J Domain C Nordlund K and Malerba L 2005 Phys Rev B 72 2141191 2141196 30 Dai X D Kong Y Li J H and Liu B X 2006 J Phys Condens Matter 18 4527 4542 31 Cleri F and Rosato F 1993 Phys Rev
37. The header record is followed by predefined number of data records as a maximum of four data per record are read in allowing for incompletion of the very last record header record keyword ad type of EAM function pair embed or density with 2B extension alternatives for the s band sembed and sdensity and d band dembed embed and ddensity density atom 1 a8 first atom type atom 2 a8 second atom type only specified for pair potential functions and for the i density functions in the EEAM potential case or ii sdensity functions in the 2BEAM potential case or iii sden and dden functions in the 2BEEAM potential case 162 STFC Section 6 1 ngrid integer number of function data points to read in limit 1 real lower interpolation limit in A for dens sden dden and pair or in density units for embe semb demb limit 2 real upper interpolation limit in A for dens sden dden and pair or in density units for embe semb demb function data records number of data records Int ngrid 3 4 data 1 real data item 1 data 2 real data item 2 data 3 real data item 3 data 4 real data item 4 6 1 7 3 Further Comments The tabled data are used to fill the internal arrays vmet dmet and fmet and optionally dmes and fmes for the 2B extensions of EAM and EEAM see Section 2 3 2 The force arrays are generated from these by the METAL_TABLE_DERIVATIVES routine using a five point interpolation procedure During simulation inter
38. V t Azy t is the instantaneous hight of the MD box or MD box volume over area The instnatneous surface tension is defined as Yalt hz t Taa t Pext 3 120 The case Yext 0 generates the NPT anisotropic ensemble for the orthorhombic cell imcon 2 in CONFIG see Appendix A This can be considered as an orthorhombic constraint on the NoT ensemble The constraint can be strengthened further to a semi orthorhombic one by imposing that the MD cell change isotropically in the x y plane which leads to the following modification in the NP yT set of equatons A palt Walt tml 2 Pos ree VE 2 Bont saa t Pmass f Pmass Rp za t Rpyy t 2 Pmass Xptiaalt a B a y The VV and LFV flavours of the non isotropic Langevin barostat and Nos Hoover thermostat are im plemented in the DL_POLY_4 routines NST_LO_VV and NST_LO_LFV respectively Both make use of the DL_POLY 4 module LANGEVIN_MODULE The routines NST_L1_VV and NST_L1_LFV implement the same but also incorporate RB dynamics 79 STFC Section 3 5 3 5 3 Berendsen Barostat With the Berendsen barostat the system is made to obey the equation of motion at the beginning of each step dt TP i l where P is the instantaneous pressure equation 3 95 and Tp is the barostat relaxation time constant Cell size variations In the isotropic implementation at each step the MD cell volume is scaled by a factor 7 and the coordinates
39. and cell vectors by ql a n t 1 Fae P t 3 123 where 8 is the isothermal compressibility of the system In practice P is a specified constant which DL POLY 4 takes to be the isothermal compressibility of liquid water The exact value is not critical to the algorithm as it relies on the ratio Tp 8 Tp is a specified time constant for pressure fluctuations supplied by the user It is worth noting that the barostat and the thermostat are independent and fully separable The VV implementation of the Berendsen algorithm only requires iterations if bond or PMF constraints are present 13 until satisfactory convergence of the constraint forces is achieved These are with re spect to the pressure i e n t in the first part VV1 RATTLE VV1 The second part is conventional VV2 RATTLE_VV2 as at the end the velocities are scaled by a factor of x 1 VVI 1 At f t u t 54 v t aa HERAN e es At 3 124 H t At nt Hi V t At e x t V t 2 RATTLE_VV1 3 Barostat BAt n t 1 Po P t 3 125 TP 4 FF f t At f t 3 126 5 VV2 At f AN 1 t t At 6 RATTLE_VV2 7 Thermostat At o 1 2 1 a e i ij TT aE v t At E v t At y 3 128 80 STFC Section 3 5 where H is the cell matrix whose columns are the three cell vectors a b c The LFV implementation of the Berendsen algorithm is iterative until self consistency in the full step velocity u t is obtained
40. c FCFLAGS 00 g C EX EX BINROOT BINROOT TYPE lake MAKE LD opt intel compiler70 ia32 bin ifc v o LDFLAGS 03 xW prec_div L opt mpich intel lib lmpich L opt intel compiler70 ia32 lib 1PEPCF90 FC opt intel compiler70 ia32 bin ifc c FCFLAGS 03 xW prec_div I opt mpich intel include EX EX BINROOT BINROOT TYPE Linux efc SGI ALTIX parallel FFT newton MAKE LD ifort o LDFLAGS tpp2 ip 03 lmpi lguide FC ifort c FCFLAGS 03 tpp2 ip w EX EX BINROOT BINROOT TYPE dirac MAKE LD usr local mpich gm pgroup121 7b bin mpif90 v o LDFLAGS 03 L usr local mpich gm pgroup121 7b lib lmpich lfmpich lmpichf90 L usr local gm binary lib lgm L usr local lib FC usr local mpich gm pgroup121 7b bin mpif90 c FCFLAGS fast Knoieee Mdalign 03 EX EX BINROOT BINROOT TYPE Franklin SUNfire cluster setenv HPCF_MPI yes franklin MAKE LD opt SUNWhpc bin mpf90 o LDFLAGS stackvar fsimple 1 x03 xarch v9b DHPCF_MPI lmpi A xlic_lib sunperf FC opt SUNWhpc bin mpf90 c FCFLAGS stackvar fsimple 1 x03 xarch v9b xchip ultra xlic_lib sunperf xalias actual fpover ftrap none fnonstd libmil dalign I opt SUNWhpc HPC5 0 include v9 EX EX BINROOT BINROOT TYPE hpcx MAKE LD mpx1f90_r o LDFLAGS
41. ensemble in which the total energy kinetic plus potential is conserved If this property drifts or fluctuates excessively in the course of a simulation it indicates that the timestep is too large or the potential cutoffs too small relative r m s fluctuations in the total energy of 107 are typical with this algorithm The VV algorithm has two stages VV1 and VV2 At the first stage it requires values of position r velocity v and force f at time t The first stage is to advance the velocities to t 1 2 At by integration of the force and then to advance the positions to a full step t At using the new half step velocities 1 VV1 o 1 At f t t A 1 net 0 a T E 3 1 where m is the mass of a site and At is the timestep 1 r t At e r t At v t At 3 2 2 FF Between the first and the second stage a recalculation of the force at time t At is required since the positions have changed FE Al F t 3 3 3 VV2 In the second stage the half step velocities are advanced to to a full step using the new force u t At v t 4 AN _ At f t At 3 4 2 m DL_POLY 4 also offers integration algorithms based on the leapfrog Verlet LFV scheme 22 Although LFV scheme is somewhat simpler and numerically faster than the VV scheme it is not time reversible and does not offer the numerical stability the VV scheme does Furthermore all kinetic related properties have approximate estimators due to the hal
42. export in BASH shell 5 2 1 1 Keywords in the Makefiles 1 TARGET The TARGET keyword indicates which kind of computer the code is to be compiled for This must be specified there is no default value Valid targets can be listed by the makefile if the command make is typed without arguments The list frequently changes as more targets are added and redundant ones removed Users are encouraged to extend the makefile for themselves using existing targets as examples 2 EX The EX keyword specifies the executable name The default name for the executable is DLPOLY Z 3 BINROOT The BINROOT keyword specifies the directory in which the executable is to be stored The default setting is execute 5 2 1 2 Modifying the Makefiles 1 Changing the FORTRAN90 compiler and MPI implementation To specify the FORTRAN90 compiler in a target platform the user must type the full path to the executable in FC and all appropriate options as defined in the relevant FORTRAN90 man ual and the path to the MPI implementation in FCFLAGS The same must be done for the linker the path to the executable in LD and the appropriate options and the path to the MPI implementation in LDFLAGS 2 Adding new functionality To include a new subroutine in the code simply add subroutine o to the list of object names in the makefile OBJ_ALL Note that there is a hierarchal order of adding file names in the O
43. forming a chemical molecule Action Correct the erroneous entries in FIELD Message 501 error coincidence of particles in PMF unit A PMF unit must be constituted of non repeating particles Action Correct the erroneous entries in FIELD Message 502 error PMF unit member found to be present more than once A PMF unit is a group of unique distingushed atoms sites No repetition of a site is allowed in a PMF unit Action Correct the erroneous entries in FIELD 276 STFC Appendix D Message 504 error cutoff too large for TABLE TABBND file The requested cutoff exceeds the information in the TABLE file or the TABBND cutoff is larger than half the system cutoff rcut Action In the case when this is received while reading TABLE reduce the value of the vdw cutoff rvdw in the CONTROL file or reconstruct the TABLE file In the case when this is received while reading TABBND then specify a larger rcut in CONTROL Message 505 error EAM metal densities or pair crossfunctions out of range The resulting densities or pair crossfunctions are not defined in the TABEAM file Action Recreate a TABEAM file with wider interval of defined densities and pair cross functions Message 506 error EAM metal densities out of range The resulting densities are not defined in the TABEAM file Action Recreate a TABEAM file with wider range of densities Message 507 error metal density embedding out of ran
44. however is little better It is only recommended for very crude structure optimizations The force shifted potential is thus 4545 1 1 1 1 dj 1 Tij 2 U r Toz r 3 2 194 ris 4TEgE i te Tee 4 Fa Foe eut 4reoe rij Toe Teak with the force on an atom j given by qiqj 1 1 E Tis 2 195 J rege 3 q with the force on atom 7 the negative of this The force shifted Coulomb potential can be elegantly extended to emulate long range ordering by including distance depending damping function erfc a rij identical to that seen in the real space portion of the Ewald sum and thus mirror the effective charge screening 63 as shown below U rij Uidj i erfela rij ses Tot 2a exp a La ra _ rege Tij ca JT Tout er fela Teut eras Teut 2a exp a ret T 2 196 Tout Teut vT out 46 STFC Section 2 4 with the force on an atom 7 given by _ tg erfelarij 2a exp a r j Arepe r2 yr Tij 2 er fc Teut 2a exp a ru Tij 2 197 rout yT Tout N O S with the force on atom 7 the negative of this It is worth noting that as discussed in 63 and references therein this is only an approximation of the Ewald sum and its accuracy and effectiveness become better when the cutoff is large gt 10 preferably 12 A The contribution to the atomic virial is W fya 2 198 which is not the negative of the potential term in this case The contributi
45. real real real record 2 real real real real real real record 3 real real real real real record 2n 1 record 2n atom type potential key see Table 6 14 potential parameter potential parameter potential parameter potential parameter see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 cutoff range for this potential A potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter potential parameter see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 see Table 6 14 The variables pertaining to each potential are described in Table 6 14 Note that the fifth variable is the range at which the particular tersoff potential is truncated The distance is in 5 tbp n where n is the number of three body potentials to be entered specifying a particular three body potential in the following manner atmnam 1 i atmnam 2 j atmnam 3 k key variable 1 variable 2 variable 3 as as as ad real real real first atom type second central atom type third atom type potential key see Table 6 15 potential parameter see Table 6 15 potential parameter see Table 6 15 potential parameter see Table 6 15 155
46. record ii cell 1 real x component of a cell vector cell 2 real y component of a cell vector cell 3 real z component of a cell vector record iii cell 4 real x component of b cell vector cell 5 real y component of b cell vector cell 6 real z component of b cell vector record iv cell 7 real x component of c cell vector cell 8 real y component of c cell vector cell 9 real z component of c cell vector This is followed by the configuration for the current timestep i e for each atom in the system the following data are included record a atmnam as atomic label iatm integer atom index 165 STFC Section 6 2 weight real atomic mass a m u charge real atomic charge e rsd real displacement from position at t 0 A record b XXX real x coordinate yyy real y coordinate ZZZ real z coordinate record c only for keytrj gt 0 VXX real x component of velocity vyy real y component of velocity VZZ real z component of velocity record d only for keytrj gt 1 fxx real x component of force fyy real y component of force fzz real z component of force Thus the data for each atom is a minimum of two records and a maximum of 4 6 2 2 The MSDTMP File The MSDTMP file is the dump file of individual atomic mean square displacements square roots in A and mean square temperature square roots in Kelvin Its principal use is for off line analysis The file is written by the subroutine MSD_WRITE The control variables for this
47. riz rig e co exrig car Ni lt e ag a 0 Taj ee rr tiie p pary q Mi DBZ SA 2 113 0 Ty ad F p Aypi with parameters Cp C1 C2 c A d 8 both c and d are cutoffs Since first being proposed a number of alternative analytical forms have been proposed some of which are described below The rules for combining different metal potentials to model alloys are different from the EAM potentials see below 6 Extended Finnis Sinclair potential 58 exfs It has the following form Vis riz ri z c co Cifij car cari cary gt iG SC ae 0 Tij gt C 2 114 aie Zifs E a Ls Pis rij a d BY rig d rig lt d 0 rj gt d F p Ay with parameters co C1 C2 C3 C4 C A d B both c and d are cutoffs 7 Sutton Chen potential 14 15 16 stch The Sutton Chen potential is an analytical potential in the FS class It has the form n a Vro ij rij 2 pislrij 2 2 115 Tij F p ceypi with parameters a n m c Note that the parameter c for the mixed potential in multi component allys is irrelevant as outlined in 15 8 Gupta potential 59 gupt The Gupta potential is another analytical potential in the FS class It has the form Vis rij 2Aexp p 2 ro rij r pij rij exp 20 A 2 2 116 F pi ByYpi gt with parameters A ro p B qij 31 STFC Section 2 3 9 Many body perturbation component potential
48. species and the indices for the same species interaction parameters are contracted to a single species index for simplicity In DL_POLY_4 the short ranged forces are calculated by the subroutine VDW_FORCES The long ranged corrections are calculated by routine VDW_LRC The calculation makes use of the Verlet neighbour list see above 29 STFC Section 2 3 2 3 2 Metal Potentials The metal potentials in DL_POLY_4 follow two similar but distinct formalisms The first of these is the embedded atom model EAM 11 12 and the second is the Finnis Sinclair model FS 13 Both are density dependent potentials derived from density functional theory DFT and describe the bonding of a metal atom ultimately in terms of the local electronic density They are suitable for calculating the properties of metals and metal alloys The extended EAM EEAM 52 53 is a generalisation of the EAM formalism which can include both EAM and FS type of mixing rules see below It is worth noting that the same formalism applies to the many body perturbation component of the actinide oxide potentials as in 54 Thus their many body component description is included in this Section For single component metals the two main approaches FS and EAM are the same However they are subtly different in the way they are extended to handle alloys see below It follows that EAM and FS class potentials cannot be mixed in a single simulation Furthermore even for FS
49. vdw_direct_fs_generate o kinds_f90 o setup_module o vdw_module o vdw_forces o config_module o kinds_f90 o setup_module o vdw_module o vdw_generate o kinds_f90 o setup_module o vdw_module o vdw_lrc o comms_module o config_module o kinds_f90 o setup_module o site_module o vdw_module o vdw_module o kinds_f90 o setup_module o vdw_table_read o comms_module o kinds_f90 o parse_module o setup_module o site_module o vdw_module o vnl_check o comms_module o config_module o domains_module o kinds_f90 0 setup_module o vnl_module o vnl_module o kinds_f90 0 warning o comms_module o kinds_f90 o setup_module o write_config o comms_module o config_module o io_module o kinds_f90 o0 setup_module o xscale o comms_module o config_module o kinds_f90 o kinetic_module o rigid_bodies_module o setup_module o statistics_module o vnl_module o z_density_collect o config_module o kinds_f90 o setup_module o z_density_module o z_density_compute o comms_module o config_module o kinds_f90 0 setup_module o site_module o z_density_module o z_density_module o kinds_f90 o setup_module o zero_k_optimise o comms_module o config_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o 223 OSTFC Appendix C Makefile MPI Master makefile for DL_POLY_4 06 parallel version Author I T Todorov June 2014 Define default settings SHELL bin sh SUFFIXES SUFFIXES f90 o BINROOT exe
50. 1 4 5 The execute Sub directory In the supplied version of DL_POLY 4 this sub directory contains only a few macros for copying and storing data from and to the data sub directory and for submitting programs for execution see Appendix B However when a DL _POLY_4 program is assembled by using the appropriate makefile it will be placed in this sub directory and will subsequently be executed from here The output from the job will also appear here so users will find it convenient to use this sub directory if they wish to use DL POLY_4 as intended The experienced user is not at all required to use DL_POLY_4 this way however 1 4 6 The build Sub directory This sub directory contains the standard makefiles for the creation i e compilation and linking of the DL_POLY_4 simulation program The makefiles supplied select the appropriate subroutines from the source sub directory and deposit the executable program in the execute directory The user is advised to copy the appropriate makefile into the source directory in case any modifications are required The copy in the build sub directory will then serve as a backup 1 4 7 The public Sub directory This sub directory contains assorted routines donated by DL_POLY users Potential users should note that these routines are unsupported and come without any guarantee or liability whatsoever They should be regarded as potentially useful resources to be hacked into shape as needed by the user This dir
51. 11 AMOEBA force field 14 7 pair potential 36 amoe 1 07 7 1 12 PS a Jro sax Jro 0 12 2 eee 12 Tabulation tab The potential is defined numerically only The parameters defining these potentials are supplied to DL_POLY_4 at run time see the description of the FIELD file in Section 6 1 3 Each atom type in the system is specified by a unique eight character label defined by the user The pair potential is then defined internally by the combination of two atom labels As well as the numerical parameters defining the potentials DL POLY_4 should also be provided with a cutoff radius ryay which sets a range limit on the computation of the interactions It is worth noting that some interaction come with a hard wired cutoff in their parameter sets Thus any provided cutoff radius Tydw Will be reset if it is not equal or larger that the largest of these all Together with the parameters the cutoff is used by the subroutine VDW_GENERATE to construct an interpolation array vvdw for the potential function over the range 0 to ryqy A second array gvdw is also calculated which is related to the potential via the formula si U rij 5 2 97 Glrij ru ij and is used in the calculation of the forces Both arrays are tabulated in units of energy The use of interpolation arrays rather than the explicit formulae makes the routines for calculating the potential energy and atomic forces very general and enables the us
52. 4 van der Waals interaction scale factor variable 6 real fourth potential parameter see Table 6 10 variable 7 real fifth potential parameter see Table 6 10 The meaning of the variables 1 3 6 7 is given in Table 6 10 The variables 4 and 5 specify the scaling factor for the 1 4 electrostatic and van der Waals non bonded interactions respectively This directive and associated data records need not be specified if the molecule contains no dihedral angle terms See the note on the atomic indices appearing under the shell directive above inversions n where nis the number of inversion interactions present in the molecule Each of the following n records contains inversion key ad potential key see Table 6 11 index 1 i integer first atomic site index central site index 2 j integer second atomic site index index 3 k integer third atomic site index index 4 1 integer fourth atomic site index variable 1 real potential parameter see Table 6 11 variable 2 real potential parameter see Table 6 11 variable 3 real potential parameter see Table 6 11 The meaning of the variables 1 2 is given in Table 6 11 148 STFC Section 6 1 Table 6 9 Valence Angle Potentials key potential type Variables 1 4 functional formt harm Harmonic k o U 6 E 0 60 hrm quar Quartic k 0 ki k U 0 8 0 6 4 E 0 bo E g bo f qur thrm Truncated harmonic k 00 p U 0 E 9 00 exp r 7
53. 67 STFC Section 3 4 3 FF f t At f t 3 49 4 VV2 A At t At u t At v t At E 3 50 2 m 5 RATTLE_VV2 6 Thermostat Note that the MD cell centre of mass momentum must not change At If lt 1 exp Then TT E se E Casal 0 1 3 51 vu t 4 At E au t At V1 a u t At End If The algorithm is self consistent and requires no iterations The LFV implementation of the Andersen algorithm is as follows 1 FF f t f t At 3 52 2 LFV 1 1 f t At t At At u t At v t At a 1 r t At r t Atu t At 3 53 3 Full step velocity 1 1 1 v t 5 Ec 544 u t 340 3 54 4 Thermostat Note that the MD cell centre of mass momentum must not change _ At If una i lt 1 exp Then TT 1 kgT alt At lt an Gauss 0 1 1 1 1 vi t 341 au t 5At Vi o w t A 3 55 1 u t lt u t At End Tf 5 SHAKE The algorithm is self consistent and requires no iterations The VV and LFV flavours of the Andersen thermostat are implemented in the DL_POLY_4 routines NVT_AO_vv and NVT_AO_LFV respectively The routines NVT_Al_vv and NVT_A1l_LFV implement the same but also incorporate RB dynamics 68 STFC Section 3 4 3 4 4 Berendsen Thermostat In the Berendsen algorithm the instantaneous temperature is pushed towards the desired temperature Text by scaling the velocities at each step by At o 1 2 eN 359
54. A Binder K B J editor Multiscale Computational Methods in Chemistry and Physics volume 117 of NATO Science Series Series III Computer and System Sciences pages 34 47 IOS Press Amsterdam 2001 63 66 76 Samoletov A Chaplain M A J and Dettmann C P 2007 J Stat Phys 128 1321 1336 63 72 77 Melchionna S Ciccotti G and Holian B L 1993 Molec Phys 78 533 82 78 Martyna G M Tobias D J and Klein M L 1994 J Chem Phys 101 4177 82 90 301 STFC Bibliography 79 80 81 82 83 84 85 86 87 88 Todorov I T Bush I J and Porter A R 2009 Parallel Scientific Computing and Optimization Springer Optimization and Its Applications ISSN 1931 6828 27 108 Todorov I T Bush I J and Smith W 2008 Cray User Group 2008 108 Bush I J Todorov I T and Smith W 2010 Cray User Group 2010 108 Hockney R W and Eastwood J W 1981 Computer Simulation Using Particles McGraw Hill International 179 181 182 Smith W 1992 Comput Phys Commun 67 392 179 Smith W and Fincham D 1993 Molecular Simulation 10 67 179 Bush I J Todorov I T and Smith W 2006 Computer Physics Communication 175 323 182 Bush I J 2000 Daresbury Laboratory 182 Reith D Piitz M and Mu ller Plathe F 2003 J Comp Chem 24 1624 197 R hle V Junghans C Lukyanov A Kremer K and Andrienko D 2009 J Chem
55. Appendix E Note that suitable entry may need to be created within the Makefile so that it matches the particular combination of architecture OS compiler MPI library amp netCDF library Contacts at STFC Daresbury Laboratory Dr I T Todorov ilian todorov stfc ac uk 297 STFC Appendix E 298 Bibliography 10 11 12 13 14 15 16 17 18 19 20 21 22 23 Smith W and Forester T R 1996 J Molec Graphics 14 136 3 Todorov I T and Smith W 2004 Phil Trans R Soc Lond A 362 1835 3 179 Todorov I T Smith W Trachenko K and Dove M T 2006 J Mater Chem 16 1611 1618 3 179 Smith W 1987 Molecular Graphics 5 71 3 Smith W 1991 Comput Phys Commun 62 229 3 5 179 Smith W 1993 Theoretica Chim Acta 84 385 3 5 179 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 3 5 62 Pinches M R S Tildesley D and Smith W 1991 Molecular Simulation 6 51 3 5 179 Rapaport D C 1991 Comput Phys Commun 62 217 3 5 179 Daw M S and Baskes M I 1984 Phys Rev B 29 6443 4 30 Foiles S M Baskes M I and Daw M S 1986 Chem Phys Lett 33 7983 4 30 Finnis M W and Sinclair J E 1984 Philos Mag A 50 45 4 30 31 Sutton A P and Chen J 1990 Philos Mag Lett 61 139 4 31 Rafii Tabar
56. At 3 41 3 42 2 LFV and Thermostat At 2 At scale l y scalev 1 scale_f 2 scale scale 1 1 t R t u t At scale v u t At scale f PO RO 3 43 m 1 r t At r t At ut At where R t are the Langevin random forces as defined in equation 3 35 66 STFC Section 3 4 3 SHAKE 4 Full step velocity de luis ZAt bal At 3 44 2 v Note that by the nature of the ensemble the centre of mass will not be stationary although the ensemble average warrants its proximity to the its original position i e the COM momentum accumulation ensemble average will tend towards zero By default this accumulation is removed and thus the correct application of stochastic dynamics the user is advised to use in the no vom option in the CONTROL file see Section 6 1 1 If the option is not applied then the dynamics will lead to peculiar thermalisation of different atomic species to mass and system size dependent temperatures The VV and LFV flavours of the Langevin thermostat are implemented in the DL_POLY_4 routines NVT_LO_VV and NVT_LO_LFV respectively The routines NVT_L1_vv and NVT_L1_LFV implement the same but also incorporate RB dynamics 3 4 3 Andersen Thermostat This thermostat assumes the idea that the system or some subset of the system has an instantaneous inter action with some fictional particles and exchanges energy Practically this interaction amounts to replacing the momentum of s
57. C undefined EX EX BINROOT BINROOT TYPE Default code master message check 0BJ_MOD OBJ_ALL LD EXE LDFLAGS OBJ_MOD OBJ_ALL Message message echo DL_POLY_4 compilation in SRL1 mode echo echo Use mpi must change to Use mpi_module in comms_module f90 echo Check that a platform has been specified check if test FC undefined then echo echo FORTRAN9O compiler unspecified echo echo Please edit your Makefile entries echo exit 99 LEON A if test LD undefined then echo echo FORTRAN9O Linker loaDer unspecified echo echo Please edit your Makefile entries echo exit 99 fi mkdir p BINROOT touch dl_poly f90 Declare rules f90 0 FC FCFLAGS 90 Declare dependencies OBJ_ALL OBJ_MOD 238 STFC Appendix C Makefile SRL2 Master makefile for DL_POLY_4 06 serial version 2 Author 1 T Todorov June 2014 Define default settings SHELL bin sh SUFFIXES SUFFIXES 90 o BINROOT execute EX DLPOLY Z EXE BINROOT EX TYPE master FC undefined LD undef ined Define object files OBJ_MOD kinds_f90 o mpi_module o comms_module o setup_module o parse_module o development_module o netcdf_modul o io_module o domains_module o site_module o config_module o vnl_module o defects_module o
58. H and Sutton A P 1991 Philos Mag Lett 63 217 4 31 39 Todd B D and Lynden Bell R M 1993 Surf Science 281 191 4 31 Tersoff J 1989 Phys Rev B 39 5566 4 40 180 van Gunsteren W F and Berendsen H J C 1987 Groningen Molecular Simulation GROMOS Library Manual BIOMOS Nijenborgh 9747 Ag Groningen The Netherlands Standard GROMOS reference 4 12 Mayo S L Olafson B D and Goddard W A 1990 J Phys Chem 94 8897 4 12 43 44 156 Weiner S J Kollman P A Nguyen D T and Case D A 1986 J Comp Chem 7 230 4 12 Smith W 2003 Daresbury Laboratory 4 10 103 112 113 114 141 201 Allen M P and Tildesley D J 1989 Computer Simulation of Liquids Oxford Clarendon Press 5 49 58 60 63 179 181 Andersen H C 1983 J Comput Phys 52 24 5 61 179 299 STFC Bibliography 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 Fincham D 1992 Molecular Simulation 8 165 5 93 Miller T F Eleftheriou M Pattnaik P Ndirango A Newns D and Martyna G M 2002 J Chem Phys 116 8649 5 93 Evans D J and Morriss G P 1984 Computer Physics Reports 1 297 5 60 63 Adelman S A and Doll J D 1976 J Chem Phys 64 2375 5 60 63 Andersen H C 1979 J Chem Phys 72 2384 5 60 63 Berendsen H J C Pos
59. In DL_POLY_4 these forces are handled by the routine COUL_DDDP_FORCES 47 STFC Section 2 4 2 4 4 Reaction Field In the reaction field method it is assumed that any given molecule is surrounded by a spherical cavity of finite radius within which the electrostatic interactions are calculated explicitly Outside the cavity the system is treated as a dielectric continuum The occurrence of any net dipole within the cavity induces a polarisation in the dielectric which in turn interacts with the given molecule The model allows the replacement of the infinite Coulomb sum by a finite sum plus the reaction field The reaction field model coded into DL_POLY_4 is the implementation of Neumann based on charge charge interactions 64 In this model the total coulombic potential is given by 1 Bor an E j lt n Taj 2R3 1 U C Amege 2 205 where the second term on the right is the reaction field correction to the explicit sum with Re the radius of the cavity The constant Bo is defined as 2 1 1 Zea 2 206 Cai ee with e the dielectric constant outside the cavity The effective pair potential is therefore 1 i Byers U r Uh I 2 207 rig gree Y E 2 3 This expression unfortunately leads to large fluctuations in the system coulombic energy due to the large step in the function at the cavity boundary In DL POLY 4 this is countered by subtracting the value of the potential at the cavity bou
60. Initial estimates of x t and n t at full step are calculated using an unconstrained estimate of the velocity at full step v t 1 FF f t f t At 3 129 2 LFV The iterative part is as follows 1 1 t u t At v t At At qn x t I r t At e n t 3 r t At v t 5AM 3 130 H t At nt H t V t At n7 t V t 3 SHAKE 4 Full step velocity dge et AD u t zA 3 131 2 2 2 5 Thermostat At o 1 2 poa n 3 132 xl Tr Exin t l 6 Barostat t mt 1 Pext P t 3 133 Several iterations are required to obtain self consistency In DL POLY_4 the number of iterations is set to 7 8 if bond constraints are present Note also that the change in box size requires the SHAKE algorithm to be called each iteration The Berendsen algorithms conserve total momentum but not energy The VV and LFV flavours of the Berendsen barostat and thermostat are implemented in the DL _POLY_4 routines NPT_B0_VV and NPT_BO_LFV respectively The routines NPT_B1_VV and NPT_B1_LFV implement the same but also incorporate RB dynamics Cell size and shape variations The extension of the isotropic algorithm to anisotropic cell variations is straightforward A tensor 7 is defined as 0 1 Poe 1 2 0 V00 3 134 Is where where is the stress tensor equation 3 96 and 1 is the identity matrix Then new cell vectors and volume are given by H 1 4t n t H V t At E Tene V 3 135
61. It is followed by n records each OSTFC Section 6 1 Table 6 14 Tersoff Potential key potential type Variables 1 5 6 11 a c 12 16 functional form ters Tersoff Ala B b R Potential forms single S B nleld h cross x wo as shown in kihs KIHS Ala B bd R S ini c ca C3 Section 2 3 3 ca ce h a B variable 4 real potential parameter see Table 6 15 variable 5 real cutoff range for this potential A The variables pertaining to each potential are described in Table 6 15 Note that the fifth variable is the range at which the three body potential is truncated The distance is in A measured from the central atom Table 6 15 Three body Potentials key potential type Variables 1 4 functional form harm Harmonic k 0 U 0 0 00 thrm Truncated harmonic k O p U 0 E 9 00 exp r ro p shrm Screened harmonic k 0 pi p2 U 0 E 8 00 exp ri p1 rix p2 bvs1 Screened Vessal 37 k 0 pr p2 U 0 s0 y my 0 my x exp rij p1 Tik p2 bvs2 Truncated Vessal 38 k a p U 0 k 0 00 0 0 00 0 bo 27 x 1 69 m 5 exp r3 r8 0 hbnd H bond 19 Dro Rnp U 0 Di cos 0 x 5 Ras rjx 6 Rav rjx 9 10 is the 7 j k angle 6 fbp n where n is the number of four body potentials to be entered It is follow
62. Mass t a e Hep F x a2 no PsV t f 1 kp Tort f ds 3 141 where f is the system s degrees of freedom equation 3 11 The VV implementation of the Nos Hoover algorithm only requires iterations if bond or PMF constraints are present 5 until satisfactory convergence of the constraint forces is achieved These are with re spect to the pressure i e n t in the first part VV1 RATTLE_VV1 The second part is conventional VV2 RATTLE_VV2 as at the end the velocities are scaled by a factor of x 1 Thermostat Note 2E in t changes inside At 2 Ein E Pmass n t 20 kp Text xlt At x t 8 dmass 1 At e exp x t 40 7 se 3 142 1 1 At 2E pin t mass Nt 20 ke Tex x t ZA e xr za kin t p a ee 2 Barostat Note Ex t and P t have changed and change inside nt exp x t 340 E aft At 3 P t Pat V t 4 Pmass n t Tat lt exp x t At n t TAi nt At lt 1 dd e ee n t At gt v t 3 143 n t At lt exp x t TAi n t At n t At e qe 7 At STE Fe AO Pmass n t sat lt exp x t At n t sat 3 Thermostat Note Exin t has changed and changes inside y Al 2Ekin t Pmass mt 3At 20 kg Toxt dmass 3 1 x t At E x t At 83 STFC Section 3 5 Ome exp ee A0 v t 3 144 2Erin t Pmass M t 5At 20 kp Tex TEIE ttar A k
63. O module 10 MODULE The I O module contains all important global variables that define the I O methods and types used in the package and contains basic routines essential for the I O in DL POLY_4 It is dependent on KINDS_F90 e domains module DOMAINS_MODULE The domains module defines DD parameters and maps the available computer resources on a DD grid The module does not depend on previous modules but its mapping subroutine is dependent on KINDS_F90 and COMMS_MODULE e site module SITE_MODULE The site module defines all site related arrays FIELD and is dependent on KINDS_F90 only However it also develops an allocation method that is dependent on SETUP_MODULE e configuration module CONFIG_MODULE The configuration module defines all configuration related arrays CONFIG and is dependent on KINDS_F90 only However it also develops an allocation method that is dependent on SETUP_MODULE e vnl module VNL_MODULE The Verlet neighbour list VNL module defines all VNL related control variables and arrays needed for the VNL conditional update functionality and is dependent on KINDS_F90 only However it is assisted by a VNL_CHECK routine that is dependent on more modules e defects module DEFECTS_MODULE The defects module defines all defects and configuration related arrays REFERENCE and is de pendent on KINDS_F90 only However it also develops an allocation method that is dependent on SETUP_MODULE e inter molecular inter
64. Preselect the value of reut choose a working a value of a of about 3 2 reut and a large value for the kmax say 20 20 20 or more Then do a series of ten or so single step simulations with your initial configuration and with a ranging over the value you have chosen plus and minus 20 Plot the Coulombic energy W versus a If the Ewald sum is correctly converged you will see a plateau in the plot Divergence from the plateau at small is due to non convergence in the real space sum Divergence from the plateau at large a is due to non convergence of the reciprocal space sum Redo the series of calculations using smaller kmax values The optimum values for kmax are the smallest values that reproduce the correct Coulombic energy the plateau value and virial at the value of a to be used in the simulation Note that one needs to specify the three integers kmaxa kmaxb kmaxc referring to the three spatial directions to ensure the reciprocal space sum is equally accurate in all directions The values of kmaxa kmaxb and kmaxc must be commensurate with the cell geometry to ensure the same minimum wavelength is used in all directions For a cubic cell set kmaxa kmaxb kmaxc However for example in a cell with dimensions 2A 2B C ie a tetragonal cell longer in the c direction than the a and b directions use 2kmaxa 2kmaxb kmaxc If the values for the kmax used are too small the Ewald sum will produce spurious results If values that are t
65. STFC Section 3 5 1 1 At P t Pex n t 54 tf n t 7 ae hvo 3 2Ekin t 1 Rp t Pmass Pmass 1 At 1 n t At lt exp xo n t At 3 Thermostat Note Exin t has changed and changes inside u t exp x v t 3 102 4 VVI At f t R t 2 m HEAD exp ht 340 At H t VEL eh ane 40 At V t 3 103 Mihir SS es nt At At r t At v t At 5 RATTLE_VV1 6 FF R t 3 104 R 7 VV2 3 105 8 RATTLE_VV2 9 Thermostat Note Exin t At has changed and changes inside At O ee x v t At 3 106 10 Barostat Note Exin t At and P t At have changed and change inside 1 At 1 n t At lt exp xo n t 544 nl A E nt SAt A ave geese Fest y Pmass 2Enin t At 1 Rolt f Pmass Pmass 3 3 At n t 42 lt exp xo n t qo 3 ORIN dp 1 gt cee At gt u t At 3 107 76 STFC Section 3 5 me At a Xp 5 n t 4 3At P t At Px n t At e ntt 3 Ar 3V t At Ct Pot 2Erin t t At 1 _ Roll f Pmass Pmass At n t At exp Xp n t At 3 11 Thermostat Note Exin t At has changed and changes inside u t At lt exp x v t At 3 108 The LFV implementation of the Langevin algorithm is iterative until self consistency in the full step velocity v t is obtained Initial estimate of n t at full step are calculate
66. These systems consist of 7 263 and 58 104 TIP4P rigid body water molecules totaling 29 052 and 232 416 particles respectively Simulation at 295 K using NPT Berendsen ensemble with CGM energy minimisation and SPME electrostatics 8 1 20 Test Case 39 and 40 Ionic liquid dimethylimidazolium chloride These systems consist of 44 352 and 354 816 ions respectively Simulation at 400 K using NPT Berendsen ensemble using both particle and rigid body dynamics with SPME electrostatics 8 1 21 Test Case 41 and 42 Calcite nano particles in TIP3P water In this case 600 and 4 800 molecules of calcium carbonate in the calcite structure form 8 and 64 nano particles which are suspended in 6 904 and 55 232 water molecules represented by a flexible 3 centre TIP3P model Simulation with SPME electrostatics at 310 K and 1 atmosphere maintained in a Hoover NPT ensemble These systems consist of 23 712 and 189 696 ions respectively 196 STFC Appendix 8 1 22 Test Case 43 and 44 Iron Carbon alloy with EEAM In this case a steel alloy of iron and carbon in ratio 35132 to 1651 is modelled using an EEAM potential forcefield Simulation at 1000 K and 0 atmosphere is maintained in a Berendsen NPT ensemble These systems consist of 36 803 and 294 424 particles respectively 8 1 23 Test Case 45 and 46 Iron Cromium alloy with 2BEAM In this case a steel alloy of iron and chromium in ratio 27635 to 4365 is modelled using an 2BEAM potential forcefield Simulat
67. Your I O buffer and possibly batch size is too big Action Decrease the value of the I O buffer and possibly batch size in CONTROL and restart your job Message 1056 error unkown write option given to sorted I O This should never happen Action Contact authors if the problem persists Message 1059 error unknown write level given to sorted I O This should never happen Action Contact authors if the problem persists Message 1060 error allocation failure in statistics_module allocate_statitics_connect Action See Message 1001 Message 1061 error allocation failure in statistics_module deallocate_statitics_connect Action See Message 1001 290 STFC Appendix D Message 1063 error Action See Message 1001 Message 1066 error Action See Message 1001 Message 1069 error Action See Message 1001 Message 1070 error Action See Message 1001 Message 1072 error Action See Message 1001 Message 1073 error Action See Message 1001 Message 1074 error Action See Message 1001 Message 1075 error Action See Message 1001 Message 1076 error Action See Message 1001 allocation failure allocation failure allocation failure allocation failure allocation failure allocation failure allocation failure allocation failure allocation failure in vdw_module gt alloc
68. _ or x Opa rij Orij rk al 2 Opi r Orij Ork 2 120 o y OF Opix Tik Orik N OF Opxj rj Orr A Opi Orik Ork Op Orkj Ork i 1 4k j LjAk X OF OF OPK rki Tkj dp a on Fe gat gee OPK Pj Tkj Tkj 1 EAM force The same as shown above However it is worth noting that the generation of the force arrays from tabulated data implemented in the METAL_TABLE_DERIVATIVES routine is done using a five point interpolation procedure 2 EEAM force Information the same as that for EAM 32 STFC Section 2 3 3 2BEAM force Information the same as that for EAM However as there is a second embedding contribution from the extra band complexity Uz U Ug 4 2BEEAM force Information the same as that for EAM However as there is a second embedding contribution from the extra band complexity Uz U Ug 5 Finnis Sinclair force _ wi Ork _ Ws Ork 6 Extended Finnis Sinclair E Orr 20 Or 7 Sutton Chen force 8 Gupta force Os Or _ U2 Ork z 2 2 Tkj y Ari c co C1rrj CaTj Ma c1 2carp 4 Tkj j 1 j k N 2 A 1 1 Th d Tk y feu 5908 pu ae AVE e a kj force N 2 2 4 Ar c co Cir xj Car jj 4 Car E CAT j l jek A y Te oa al gee NER ye Tki rr a yc 2carpj 3c3rz Acar 2u J J Tkj Ari d 4B rp ay Tkj Tkj OU N a Tkj a T a u ty j l j k IS KI OU a y mece
69. about upcoming workshops subscribe to our mail list by following instructions in Section 1 7 If you need one to one training wish to collaborate scientifically and or would like to become a contribu tor developer then get in touch with me Dr I T Todorov by email to ilian todorov stfc ac uk Best of luck Chapter 1 Introduction Scope of Chapter This chapter describes the concept design and directory structure of DL_POLY_4 and how to obtain a copy of the source code STFC Section 1 2 1 1 The DL_POLY Package DL_POLY 1 is a package of subroutines programs and data files designed to facilitate molecular dy namics simulations of macromolecules polymers ionic systems and solutions on a distributed memory parallel computer It is available in two forms DL POLY Classic written by Bill Smith Tim Forester http www ccp5 ac uk DL POLY_CLASSIC and DL POLY_4 written by Ilian Todorov amp Bill Smith 2 3 Both versions were originally written on behalf of CCP5 the UK s Collaborative Computational Project on Molecular Simulation which has been in existence since 1980 4 http www ccp5 ac uk DL_POLY The two forms of DL_POLY differ primarily in their method of exploiting parallelism DL POLY Classic uses a Replicated Data RD strategy 5 6 7 8 which works well simulations of up to 30 000 atoms on up to 100 processors DL_POLY 4 is based on the Domain Decomposition DD strategy 2 3 9 10 5 6 a
70. accommodate the following boundary conditions 1 None e g isolated molecules in vacuo 2 Cubic periodic boundaries 3 Orthorhombic periodic boundaries 4 Parallelepiped periodic boundaries 5 Slab x y periodic z non periodic These are described in detail in Appendix A Note that periodic boundary conditions PBC 1 and 5 above require careful consideration to enable efficient load balancing on a parallel computer 1 2 4 Java Graphical User Interface The DL POLY 4 Graphical User Interface GUI is the same one that also comes with DL POLY Classic which is written in the Java programming language from Sun Microsystems A major advantage of this is the free availability of the Java programming environment from Sun and also its portability across platforms The compiled GUI may be run without recompiling on any Java B supported machine The GUI is an integral component of the DL_POLY suites and is available on the same terms see the GUI manual 21 STFC Section 1 2 1 2 5 Algorithms 1 2 5 1 Parallel Algorithms DL_POLY_4 exclusively employs the Domain Decomposition parallelisation strategy 9 10 5 6 see Sec tion 7 1 1 1 2 5 2 Molecular Dynamics Algorithms DL_POLY_4 offers a selection of MD integration algorithms couched in both Velocity Verlet VV and Leapfrog Verlet LFV manner 22 These generate NVE NVEkin NVT NPT and NaT ensembles with a selection of thermostats and barostats Parallel versions o
71. actual dynamics 5 The variable timestep or also timestep variable option requires the user to specify an initial guess for a reasonable timestep for the system in picoseconds The simulation is unlikely to retain this as the operational timestep however as the latter may change in response to the dynamics of the system The option is used in conjunction with the default values of maxdis 0 10 and mindis 0 03 which can also be optionally altered if used as directives note the rule that maxdis gt 2 5 mindis applies Also an additional mxstep in ps control can be applied These serve as control values in the variable timestep algorithm which calculates the greatest distance a particle has travelled in any timestep during the simulation If the maximum distance is exceeded the timestep variable is halved and the step repeated If the greatest move is less than the minimum allowed the timestep variable is doubled and the step repeated provided it does not exceed the user specified mxstep If it does then it scales to mxstep and the step is repeated In this way the integration timestep self adjusts in response to the dynamics of the system 6 The job time and close time directives are required to ensure a controlled close down procedure when a job runs out of time The time specified by the job time directive indicates the total time allowed for the job This must obviously be set equal to the time specified to the operating syst
72. addition to using this macro 201 STFC Appendix B gopoly gopoly is used to submit a DL_POLY_4 job to the HPCz which operates a LOAD LEVELER job queuing system It invokes the following script shell usr bin tcsh job_type parallel job_name gopoly cpus 32 node_usage not_shared network MPI csss shared US wall_clock_limit 00 30 00 account_no my_account output job_name schedd_host jobid out error job_name schedd_host jobid err notification never bulkxfer yes data_limit 850000000 stack_limit 10000000 queue ENVIRONMENT SETTINGS setenv MP_EAGER_LIMIT 65536 setenv MP_SHARED_MEMORY yes setenv MEMORY_AFFINITY MCM setenv MP_TASK_AFFINITY MCM setenv MP_SINGLE_THREAD yes poe DLPOLY Z Using LOADLEVELLER the job is submitted by the UNIX command submit gopoly where Ilsubmit is a local command for submission to the IBM SP4 cluster The number of required nodes and the job time are indicated in the above script gui gui is a macro that starts up the DL POLY_4 Java GUI It invokes the following UNIX commands java jar java GUl jar 1 amp 202 STFC Appendix B In other words the macro invokes the Java Virtual Machine which executes the instructions in the Java archive file GUL jar which is stored in the java subdirectory of DL POLY_4 Note Java 1 3 0 or a highe
73. algorithms that do not work together By large DL_POLY_4 118 STFC Section 6 1 tries to sort out these difficulties and print helpful error messages but it does not claim to be fully foolproof Another common mistake is to specify more than once a directive that has no contradictory disabling altering or antagonistic directives then the one specified last will be used as a control directive for example densvar equil steps press mxshak shake Fortunately in most cases the CONTROL file will be small and easy to check visually It is important to think carefully about a simulation beforehand and ensure that DL_POLY_4 is being asked to do something that is physically reasonable It should also be remembered that the present capabilities the package may not allow the simulation required and it may be necessary for you yourself to add new features An example CONTROL file appears below The directives and keywords appearing are described in the following section The example lists all possible and not mutually excluding directives in a particular order Although this order is not mandatory it is highly recommended TITLE RECORD DL_POLY_4 SAFE ORDER OF CONTROL DIRECTIVES SYSTEM REPLICATION amp IMPACT OPTION nfold 10 10 10 impact 1 2000 7 5 1 0 2 0 3 0 DENSITY VARIATION ARRAY BOOST densvar 10 INDEX AND VERIFICATION BYPASS AND NO TOPOLOGY REPORTING no index no strict no topology INTERACTIONS BYPASS no el
74. automatic parameter optimisation for precision f as for Ewald summation 107 lt f lt 0 5 default f 1072 resample the instantaneous system momenta distribution every n steps during equilibration with respect to the last equilibration step abort simulation and replay HISTORY to recalculate structural properties such as RDF z density profiles defects and displacements trajectories execution halts if no property is specified abort simulation and replay the HISTORF file a HISTORY copy with full force evaluation driven by FIELD different from the one used for the HISTORF generation restart job from end point of previous run i e continue current simulation REVOLD required restart job from previous run without scaling system temperature i e begin a new simulation from older run without temperature reset REVOLD is not used 128 STFC Section 6 1 restart scale recut f cutoff f rlxtol f rpad f padding f rvdw cutoff f scale temperature every n seed nj Na ng shake tolerance f shift shift damp a shift precision f slab spme evaluate every n spme precision f spme sum a ky ka k3 stack size n stats every n steps n restart job from previous run with scaling system temperature i e begin a new simulation from older run with temperature reset REVOLD is not used act exactly the same as the cutoff f option above set tolerance for relaxed shell mod
75. be supplied specifying 0 or a negative numbers indicates that DL_POLY_4 will resort to the default value The possible options are e io write mpiio direct netcdf rp sort unsort j k l e j specifies the number of processors that shall access the disk k specifies the maximum number of particles that the writing processors shall deal with at any one time Large values give good performance but may results in an unacceptable memory overhead l specifies the maximum number of particles that the writing processors shall write to the disk in one I O transaction Large values give good performance but may results in an unacceptable memory overhead e accepts Yes only to switch global error checking performed by the I O subsystem the default is No io write master sort unsort I l specifies the maximum number of particles that the writing process shall write to the disk in one I O transaction Large values give good performance but may results in an unacceptable memory overhead The no vom option will trigger a default bypass of the GETVOM routine which will return zero and thus no COM removal will happen Note that this will lead to COM momentum accumulation for many though not all ensembles Such accumulation will propagate to the generation of flow in the MD cell and ultimately suppress the thermal motion of the particles in the system leading to the so called frozen ice cube effect It is worth nothing that this option must be tu
76. beyond rmet 2 EEAM virial correction No long ranged corrections apply beyond rmet 3 2BEAM virial correction No long ranged corrections apply beyond Fmet 4 2BEEAM virial correction No long ranged corrections apply beyond rymet 37 2 142 STFC Section 2 3 5 Finnis Sinclair virial correction No long ranged corrections apply beyond cutoffs c and d 6 Extended Finnis Sinclair virial correction No long ranged corrections apply beyond cutoffs c and d 7 Sutton Chen virial correction on ND 3 n 3 i e e TN pea a n 3 rmet Arp 3 m 3 N l me E a 2 143 m 3 Tmet 2 p 8 Gupta virial correction 4r NpAr r ro 2 ro ow a pa o Poet 3rZet 6 met 6 x TO P p P P Tmet TO exp phe 2 3 Ti r T Thet a Irae 2 6rmet 2 6 2 x 2 144 1 1 ij Tmet TO NB exp 295 r gt Pi 9 Many body perturbation component virial correction 2 7 t Qij AT PTO Tro qij bw 0 Amp a Ne Y m E 2 145 m gt 3 nu 24 p In the energy and virial corrections we have used the approximation N 1 2 N D Pi me a 2 2 146 i lt p gt where lt 0 2 gt is regarded as a constant of the system In DL POLY _4 the metal forces are handled by the routine METAL_FORCES The local density is calculated by the routines METAL_LD_COLLECT_EAM METAL_LD_COLLECT_FST METAL_LD_COMPUTE METAL_LD_SET_HALO and METAL_LD_EXP
77. class potentials possessing different analytical forms there is no agreed procedure for mixing the parameters Mixing EAM and EEAM potentials is only possible if the EAM ones are generalised to EEAM form see below The user is therefore strongly advised to be consistent in the choice of potential when modelling alloys The general form of the EAM and FS types of potentials is 55 N N N U metal 53 Vij rij a 5 F pi gt 2 109 i l j i i 1 where F p is a functional describing the energy of embedding an atom in the bulk density p which is defined as N ja iri It should be noted that the density is determined by the coordination number of the atom defined by pairs of atoms This makes the metal potential dependent on the local density environmental Vj rij is a pair potential incorporating repulsive electrostatic and overlap interactions N is the number of interacting particles in the MD box In DL_POLY_4 EAM and thus EEAM can be further generalised to include two band 2B densities 56 57 for s and d bands F pi F of FU 2 111 where N BS gt A 1 2 112 j Lj i instead of just the one s as in equations 2 109 and 2 110 These will be referred in the following text as 2BEAM and 2BEEAM Mixing 2BEAM and EAM and alternatively 2BEEAM and EEAM potentials is only possible if the single band ones are generalised to 2B forms The user is again reminded to be consistent in the choice of potential wh
78. data files into it store requires one argument 203 STFC Appendix B store n where n is a unique string or number to label the output data in the data TESTn sub directory Note that store sets the file access to read only This is to prevent the store macro overwriting existing data without your knowledge 204 Appendix C DL_POLY 4 Makefiles Makefile DEV Master makefile for DL_POLY_4 06 parallel version Author I T Todorov June 2014 Define default settings SHELL bin sh SUFFIXES SUFFIXES 90 o BINROOT execute EX DLPOLY Z EXE BINROOT EX TYPE master FC undefined LD undef ined Define object files OBJ_MOD kinds_f90 o comms_module o setup_module o parse_module o development_module o netcdf_modul o io_module o domains_module o site_module o config_module o vnl_module o defects_module o defectsi_module o vdw_module o metal_module o tersoff_module o three_body_module o four_body_module o kim_modul o rdf_module o z_density_module o core_shell_module o constraints_module o pmf_module o 205 STFC Appendix C rigid_bodies_module o tethers_module o bonds_module o angles_module o dihedrals_module o inversions_module o external_field_module o langevin_module o minimise_module o ewald_module o msd_module o statistics_module o greenkubo_module o kinetic_module o gpfa_module o parallel_fft o OBJ_ALL
79. defects1_module o vdw_module o metal_module o tersoff_module o three_body_module o four_body_module o kim_modul o A rdf_module o z_density_module o core_shell_module o constraints_module o pmf_module o rigid_bodies_module o tethers_module o bonds_module o angles_module o dihedrals_module o inversions_module o external_field_module o langevin_module o minimise_module o ewald_module o msd_module o statistics_module o greenkubo_module o kinetic_module o gpfa_module o parallel_fft o OBJ_ALL warning o error o scan_control_io o numeric_container o spme_container o quaternions_container o scan_field o scan_control_pre o read_config_parallel o scan_config o scan_control o read_config o 239 STFC Appendix C set_bounds o read_control o bonds_table_read o angles_table_read o dihedrals_table_read o inversions_table_read o vdw_generate o vdw_table_read o vdw_direct_fs_generate o metal_generate o metal_table_read o metal_table_derivatives o tersoff_generate o dihedrals_14_check o read_field o check_config o origin_config o scale_config o write_config o trajectory_write o system_expand o rigid_bodies_tags o rigid_bodies_coms o rigid_bodies_widths o rigid_bodies_setup o init_intra o tag_legend o report_topology o pass_shared_units o build_book_intra o build_excl_intra o scale_temperature o update_shared_units o core_shell_quench o constraints_tags o constraints
80. defined system of linear RBs is in fact generated from a system of CBs 3 per RB which has not been 283 STFC Appendix D run in a high enough SHAKE RATTLE tolerance accuracy 1028 and higher may be needed Check the definition of the rigid unit in the CONFIG file if sensible report the error to the authors Message 655 error FENE bond breaking failure A FENE type bond was broken Action Examine FIELD for erroneous directives if any correct and resubmit Message 660 error TABBND or PDF bond breaking failure A bond with potential defined in TABBND or for which intramolecular potential distribution is collected has exceeded its bondleghth limit Action If there is a TABBND present reconstruct TABBND with potentials defined over larger cutoff and try again If bonds PDF are collected increase their cutoff value in CONTROL Message 1000 error working precision mismatch between FORTRAN90 and MPI imple mentation DL_POLY_4 has failed to match the available modes of MPI precision for real numbers to the defined in sc kinds_f90 FORTRAN90 working precision wp for real numbers wp is a precompile parameter Action This simply mean that wp must have been changed from its original value to something else and the new value is not matched by the mpi_wp variable in COMMS_MODULE It is the user s responsibility to ensure that wp and mpi_wp are compliant Make the necessary corrections to sc kinds_f90 and or COMMS_M
81. directive and associated data records need not be specified if the molecule contains no core shell units 5 constraints n where n is the number of constraint bonds in the molecule Each of the following n records contains index 1 integer first atomic site index index 2 integer second atomic site index bondlength real constraint bond length This directive and associated data records need not be specified if the molecule contains no constraint bonds See the note on the atomic indices appearing under the shell directive above 6 pmf b where b is the potential of mean force bondlength A There follows the definitions of two PMF units a pmf unit n1 where ni is the number of sites in the first unit The subsequent ni records provide the site indices and weighting Each record contains index integer atomic site index weight real site weighting b pmf unit n2 where n2 is the number of sites in the second unit The subsequent n2 records provide the site indices and weighting Each record contains index integer atomic site index weight real site weighting This directive and associated data records need not be specified if no PMF constraints are present See the note on the atomic indices appearing under the shell directive Note that if a site weighting is not supplied DL_POLY_4 will assume it is zero However DL_POLY 4 detects that all sites in a PMF unit have zero weighting then the PMF unit sites will be assigned the m
82. eS 52 2 5 1 Dynamical Adiabatic Shells Shell Model o o 52 vi vil STFC Contents 2 5 2 Relaxed Massless Shells Model o oo ee eee eee eee 53 2 5 3 Breathing Shell Model Extension o cos apa abosa e mc 53 Zod Further Notes sis ic a e ee ee ie oe eta oe a 54 26 External Fields s mss sc 25 2 2a eee be Re ee Pe Oe wee ee 54 2 7 Treatment of Frozen Atoms Rigid Body and Core Shell Units 55 2 8 Tabulation and interpolation in the treatment of intermolecular interactions 56 3 Integration Algorithms 57 Gok IMroduchom s 20 satu we ee ae ek ee ee Sie ee ek ek ae ER 58 3 2 Bond Gomstraimts s se ss peu a eae hae eee be Ra ee ae ee ee ee ee ole 60 3 3 Potential of Mean Force PMF Constraints and the Evaluation of Free Energy 63 3A Thermostats 22 4 6 ayi a oe eRe RE eee eee ae ee ee a ee 63 3 4 1 Evans Thermostat Gaussian Constraints ocios PES MS EES 64 SAD Langevin Thermostat pas sars a de E ED a e a al ae ee Se ea 65 34 3 Andersen Thermostat a 4664 08 Ho 0444 apaa a eb ea ee we ee ols 67 SAA Berendsen Thermostat c e 6 204040 646464 a ed eee Peed oe ee eA ee 69 3 4 5 Nos Hoover Thermostat esac eaa mace w ee Re ee ee ee 70 3 4 6 Gentle Stochastic Thermostat 2 0 2 ee ee 72 a A 74 3 5 1 Instantaneous pressure and stress a e 74 002 Mban evirn Barostate nos lt P toe ose ee Soe ea ae Ee 74 3 0 3 Berendsen Barosta
83. encountered DL_POLY_4 enters the molecular description environment in which only molecular description keywords and data are valid Immediately following the molecules directive are the records defining individual molecules 1 name of molecule which can be any character string up to 100 characters in length Note this is not a directive just a simple character string 2 nummols n where n is the number of times a molecule of this type appears in the simulated system The molecular data then follow in subsequent records 3 atoms n where n indicates the number of atoms in this type of molecule A number of records follow each giving details of the atoms in the molecule i e site names masses and charges Each record carries the entries sitnam a8 atomic site name weight real atomic site mass chge real atomic site charge nrept integer repeat counter ifrz integer frozen atom if ifrz gt 0 The integer nrept need not be specified if the atom site is not frozen in which case a value of 1 is assumed A number greater than 1 specified here indicates that the next nrept 1 entries in the CONFIG file are ascribed the atomic characteristics given in the current record The sum of the repeat numbers for all atoms in a molecule should equal the number specified by the atoms directive 4 shell n where n is the number of core shell units Each of the subsequent n records contains index 1 1 integer site index of core i
84. energy from the rest of the system thus emulating an infinite like environment surrounding the MD cell The thermostat width matters as the more violent the events on the inside of the MD cell the bigger width may be needed in order to ensure safe dissipation of the excess kinetic energy 134 STFC Section 6 1 12 e pseudo Gauss Rescale the kinetic energy of the thermostat bath so that particles within have Gaussian distributed kinetic energy with respect to the target temperature e pseudo direct The Direct thermostat is the simplest possible model allowing for heat exchange between the MD system and the heath bath All mass non frozen particles within the bath have their kinetic energy scaled to 1 5 kgT at the end of each time step during the simulation Care is exercised to prevent introduction of non zero net momentum when scaling velocities Users are reminded to use for target temperature the temperature at which the original system was equilibrated in order to avoid simulation instabilities Due to the unphysical nature of this temperature control the thermostat width does not matter to the same extent as in the case of the Langevin thermostat Note that embedding a thermostat in the MD cell walls is bound to produce wrong ensemble averages and instantaneous pressure and stress build ups at the thermostat boundary Therefore ensembles lose their meaning as such and so does the conserved quantity for true ensembl
85. file may be interpreted as erroneous This is easily overcome by commenting out the Use mpi line and uncommenting the Include mpif h one situated immediately after the Implicit None line If there is an entry in the Makefile for the particular combination of architecture compiler amp MPI implementation then the user may instantiate the compilation by issuing at the command line make entry and then pressing lt Enter gt 295 STFC Appendix E Usually the one named hpc is suitable for the majority of platforms To find out the keywords for all available entries within the Makefile issue make press lt Enter gt and then examine the Makefile entries corresponding to the keywords reported If there is not a suitable entry then you should seek advice from a computer scientist or the support staff of the particular machine HPC service The necessary components for the source compilation are 1 a FORTRAN9O TR15581 compliant compiler if the full PATH to it is not passed to the DEFAULT ENVIRONMENT PATH then it MUST be explicitly supplied in the Makefile 2 an MPI2 or MPI1 MPI 1 0 implementation COMPILED for the architecture 0S and the targeted compiler if the full PATH to these is not passed to the DEFAULT ENVIRONMENT PATH then it MUST be explicitly supplied in the Makefile 3 a MAKE command Makefile interpreter in the system SHELL where 2 is not necessary for co
86. happen The calculation of four body forces in DL POLY 4 is handled by the link cell algorithm This error arises if the required number of link cells exceeds the permitted array dimension in the code Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxcell in SET_BOUNDS recompile and resubmit Message 88 error legend array exceeded in build_book_intra The second dimension of a legend array has been exceeded Action If you have an intra molecular like interaction present in abundance in your model that you suspect is driving this out of bound error increase its legend bound value mxfinteraction at the end of SCAN_FIELD recompile and resubmit If the error persists contact authors Message 89 error too many four body dihedrals inversions potentials specified This should never happen Action Report to authors Message 90 error specified tersoff potentials have different types This is not allowed Only one general type of tersoff potential is allowed in FIELD as there are no mixing rules between different tersoff potentials Action Correct your model representation in FIELD and try again Message 91 error unidentified atom in four body dihedrals inversions potential list The specification of a four body or dihedrals or inversions potential in the FIELD file has referenced an atom type that is unknown Action Locate the errant atom t
87. however prove useful for relaxing crystal structures to 0 Kelvin for the purpose of identifying a true crystal structure 5 2 6 Simulation Efficiency and Performance Although the DL_POLY 4 underlining parallelisation strategy DD and link cells see Section 7 1 1 is ex tremely efficient it cannot always provide linear parallelisation speed gain with increasing processor count for a fixed size system Nevertheless it will always provide speedup of the simulation i e there still is a sufficient speed gain in simulations when the number of nodes used in parallel is increased The simplest explanation why this is is that increasing the processor count for a fixed size system decreases not only the work and memory load per processor but also the ratio size of domain to size of halo both in counts of link cells When this ratio falls down to values close to one and below the time DL POLY_4 spends on inevitable communication MPI messages across neighbouring domains to refresh the halo data increases with respect to and eventually becomes prevalent to the time DL_POLY_4 spends on numeric calculations integration and forces In such regimes the overall DL_POLY 4 efficiency falls down since processors spend more time on staying idle while communicating than on computing It is important that the user recognises when DL_POLY_4 becomes vulnerable to decreased efficiency and what possible measures could be taken to avoid this DL POLY_4 calculates and
88. in the code yourself Amendments to subroutines READ_FIELD and INVERSIONS FORCES will be required Message 450 error undefined tethering potential A form of tethering potential has been requested which DL_POLY_4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY_4 if this is reasonable Alternatively you may consider defining the required potential in the code yourself Amendments to subroutines READ_FIELD and TETHERS_FORCES will be required Message 451 error three body potential cutoff undefined The cutoff radius for a three body potential has not been defined in the FIELD file Action Locate the offending three body force potential in the FIELD file and add the required cutoff Resubmit the job Message 452 error undefined vdw potential A form of vdw potential has been requested which DL_POLY_4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY_4 if this is reasonable Alternatively you may consider defining the required potential in the code yourself Amendments to subroutines READ_FIELD VDW_GENERATE and DIHEDRALS_14_VDW will be required Message 453 error four body potential cutoff undefined The cutoff radius for a four body potential has not been defined in the FIELD file Action Locate the offending four body force potential in the FIELD file and add the
89. integration scheme as file names are finished with the flavour they develop if they have a counterpart implementing the same algorithm but in the alternative flavour Names are self explanatory 7 2 6 SERIAL Specific Files These implement an emulation of some general MPI calls used in DL_POLY_4 source code when compiling in serial mode as well as some modified counterparts of the general files changed to allow for faster and or better memory optimised serial execution Names are self explanatory 7 2 7 Comments on MPI Handling Only a few files make explicit calls to MPI routines COMMS MODULE 10 MODULE READ_CONFIG_PARALLEL READ_CONFIG WRITE_CONFIG VDW_TABLE_READ CHECK_CONFIG SYSTEM_EXPAND SYSTEM_INIT PASS_SHARED_UNITS UPDATE_SHARED_UNITS EXPORT_ATOMIC_DATA READ_HISTORY DEPORT_ATOMIC_DATA METAL_LD_EXPORT PARALLEL_FFT EXCHANGE_GRID DEFECTS_REFERENCE_WRITE DEFECTS_REFERENCE_READ_PARALLEL DEFECTS_REFERENCE_READ DEFECTS_REFERENCE_EXPORT DEFECTS_WRITE DEFECTS1_WRITE TRAJECTORY_WRITE MSD_WRITE RSD_WRITE SYSTEM_REVIVE The rest of the files that use MPI functionality in any way make implicit calls via generic functions developed in COMMS_MODULE 189 STFC Section 7 2 7 2 8 Comments on SETUP_MODULE The most important module by far is SETUP_MODULE which holds the most important global parameters and variables some of which serve as parameters for global array bounds set in SET_BOUNDS A brief account of these is given be
90. its allotted domain This in DL_POLY_4 is handled by the SET HALO PARTICLES routine Systems containing complex molecules present several difficulties They often contain ionic species which usually require Ewald summation methods 22 83 and intra molecular interactions in addition to inter molecular forces Intramolecular interactions are handled in the same way as in DL_POLY_Classic where each processor is allocated a subset of intramolecular bonds to deal with The allocation in this case is based on the atoms present in the processor s domain The SHAKE and RATTLE algorithms 73 23 require significant modification Each processor must deal with the constraint bonds present in its own domain but it must also deal with bonds it effectively shares with its neighbouring processors This requires each processor to inform its neighbours whenever it updates the position of a shared atom during every SHAKE RATTLE_VV1 cycle RATTLE_VV2 updates the velocities so that all relevant processors may incorporate this update into its own iterations In the case of the DD strategy the SHAKE RATTLE algorithm is simpler than for the Replicated Data method of DL_POLY_Classic where global updates of the atom positions merging and splicing are required 84 The absence of the merge requirement means that the DD tailored SHAKE and RATTLE are less communications dependent and thus more efficient particularly with large processor counts The DD strategy i
91. kinds_f90 o rdf_module o setup_module o rdf_module o kinds_f90 o setup_module o read_config o comms_module o config_module o domains_module o io_module o kinds_f90 o parse_module o setup_module o read_config_parallel o comms_module o config_module o domains_module o io_module o kinds_f90 o parse_module o setup_module o read_control o bonds_module o comms_module o config_module o defects1_module o development_module o greenkubo_module o kinds_f90 0 kinetic_module o langevin_module o metal_module o msd_module o 220 STFC Appendix C parse_module o setup_module o vdw_module o read_field o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o external_field_module o four_body_module o inversions_module o kinds_f90 o kinetic_module o metal_module o parse_module o A pmf_module o rdf_module o rigid_bodies_module o setup_module o site_module o tersoff_module o tethers_module o three_body_module o vdw_module o read_history o comms_module o config_module o domains_module o io_module o kinds_f90 o parse_module o setup_module o site_module o refresh_halo_positions o comms_module o config_module o setup_module o regauss_temperature o comms_module o config_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o relocate_particles o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_modul
92. m potential 47 48 nm 4 Buckingham potential buck Uri A exp 52 5 Born Huggins Meyer potential bhm C U rij A exp B o riz o 2 89 ij ij 6 Hydrogen bond 12 10 potential hbnd A B ees ee e 2 vea ap ap pi 7 Shifted force n m potential 47 48 snm no E ny Y 2Y y na Cone a with n m mpl m y m 1 7 mp ny n D A m 1 _ n m p 5 2 92 y This peculiar form has the advantage over the standard shifted n m potential in that both Eo and ro well depth and location of minimum retain their original values after the shifting process 8 Morse potential mors U rij Eo H1 exp k rij ro 1 2 93 9 Shifted Weeks Chandler Anderson WCA potential 49 wea 12 6 1 U rij a 53 Ex 7 i ns K TTA 2 94 0 Tij 2 256 0 4 The WCA potential is the Lennard Jones potential truncated at the position of the minimum and shifted to eliminate discontinuity includes the effect of excluded volume It is usually used in combi nation with the FENE equation 2 10 bond potential This implementation allows for a radius shift of up to half a A lt 0 5 0 with a default of zero Age fauit 0 27 STFC Section 2 3 10 Standard DPD potential dpd U rij It takes the Groot Warren 50 form giving a soft and purely repulsive interaction 2 i s Te 1 i i Tij lt Te 2 95 Tij Z Ye O nja
93. molecule It is followed n records specifying the tehered sites in the molecule tether key ad potential key see Table 6 7 index 1 i integer atomic site index variable 1 real potential parameter see Table 6 7 variable 2 real potential parameter see Table 6 7 The meaning of these variables is given in Table 6 7 This directive and associated data records need not be specified if the molecule contains no flexible chemical bonds See the note on the atomic indices appearing under the shell directive above Table 6 7 Tethering Potentials key potential type Variables 1 3 functional form harm Harmonic k Ur 3 mr 20 rhrm Restraint k Tre U r gt k ri ae ri pO lt Te Ur 5 k r2 k rellri ri re ri r gt re quar Quartic k k k U r k ri F E r ri20y3 r r rf 9 bonds n where n is the number of flexible chemical bonds in the molecule Each of the subsequent n records contains bond key a4 potential key see Table 6 8 index 1 i integer first atomic site index in bond 146 STFC Section 6 1 index 2 7 integer second atomic site index in bond variable 1 real potential parameter see Table 6 8 variable 2 real potential parameter see Table 6 8 variable 3 real potential parameter see Table 6 8 variable 4 real potential parameter see Table 6 8 The meaning of these variables is given in Table 6 8 This directive and associa
94. molecule e g by defining a methane tetrahedron to have 10 rather than 9 bond constraints in which case the SHAKE RATTLE procedure will become unstable In addition massless sites e g charge sites cannot be included in a simple constraint approach making modelling with potentials such as TIP4P water impossible All these problems may be circumvented by defining rigid body units the dynamics of which may be described in terms of the translational motion of the centre of mass COM and rotation about the COM 90 STFC Section 3 6 To do this we need to define the appropriate variables describing the position orientation and inertia of a rigid body and the rigid body equations of motion The mass of a rigid unit M is the sum of the atomic masses in that unit Nsites M m 3 172 j 1 where m is the mass of an atom and the sum includes all sites Nsites in the body The position of the rigid unit is defined as the location of its centre of mass R 1 Nsites j where r is the position vector of atom j The rigid body translational velocity V is defined by 1 Nsites j l and its angular momentum J can then be defined by the expression Nsites J Y m 4x vj V 3 175 j 1 where v is the velocity of atom j and d is the displacement vector of the atom j from the COM is given by gau k 3 176 The net translational force F acting on the rigid body unit is the vector sum of the forces acting on the atoms of the
95. nvt_h0_scl o config_module o kinds_f90 o kinetic_module o setup_module o nvt_h0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nvt_hi_lfv o comms_module o config_module o domains_module o kinds_f90 0 A kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_hi_scl o config_module o kinds_f90 0 kinetic_module o A rigid_bodies_module o setup_module o 219 STFC Appendix C nvt_hi_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_l0_lfv o comms_module o config_module o kinds_f90 o kinetic_module o langevin_module o setup_module o site_module o nvt_10_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nvt_11_1fv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o nvt_li_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o origin_config o config_module o development_module o kinds_f90 o0 parallel_fft o comms_module o gpfa_module o kinds_f90 o setup_module o parse_module o comms_module o kinds_f90 o setup_module o pass_shared_units o comms_module o config_module o domains_module o kinds_f90 o rigid_bodies_module o setup_module o pmf_coms o comms_modul
96. o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_a0_1lfv o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o setup_module o site_module o 218 STFC Appendix C nvt_a0_vv o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o setup_module o site_module o nvt_al_lfv o comms_module o config_module o core_shell_module o domains_module o kinds_f90 o kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_al_vv o comms_module o config_module o core_shell_module o domains_module o kinds_f90 o kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_bO_lfv o comms_module o config_module o kinds_f90 o0 kinetic_module o A setup_module o site_module o nvt_bO_scl o config_module o kinds_f90 o kinetic_module o setup_module o nvt_b0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nvt_bi_lfv o comms_module o config_module o domains_module o kinds_f90 o0 A kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_bi_scl o config_module o kinds_f90 o kinetic_module o A rigid_bodies_module o setup_module o nvt_b1_vv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_eO_lfv o comms_module o config_module o kinds_f
97. o config_module o kinds_f90 o kinetic_module o langevin_module o setup_module o site_module o nst_10_vv o comms_module o config_module o kinds_f90 o kinetic_module o langevin_module o setup_module o site_module o nst_11_1fv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o nst_11_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o nst_m0_lfv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_m0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_m1_lfv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_m1_vv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o setup_module o site_module o numeric_container o comms_module o kinds_f90 o setup_module o nve_0_lfv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nve_O_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nve_1_lfv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nve_1_vv
98. o nst_b1_1lfv o nst_hi_lfv o nst_mi_lfv o xscale o core_shell_kinetic o regauss_temperature o z_density_collect o statistics_collect o statistics_connect_set o statistics_connect_spread o statistics_connect_frames o system_revive o rdf_compute o z_density_compute o vaf_compute o bonds_compute o angles_compute o dihedrals_compute o inversions_compute o statistics_result o dl_poly o Define Velocity Verlet files FILES_VV pseudo_vv f90 constraints_shake_vv f90 pmf_shake_vv f90 constraints_rattle f90 pmf_rattle f90 nvt_h0_sc1 f90 nvt_gO_scl f 90 npt_h0_sc1 f90 nst_hO_scl f90 nve_0_vv f90 nvt_e0_vv f90 nvt_10_vv f90 nvt_a0_vv f90 nvt_b0_vv f90 nvt_hO_vv f90 nvt_g0_vv f90 npt_10_vv f90 npt_b0_vv f90 npt_h0_vv f90 npt_m0_vv f90 nst_10_vv f90 nst_b0_vv f90 nst_h0_vv f90 nst_m0_vv f90 nvt_h1_sc1 f90 nvt_gi_scl f90 npt_h1_sc1 f90 nst_h1_sc1 f90 nve_1_vv f90 nvt_el_vv f90 nvt_11_vv f90 nvt_al_vv f90 nvt_b1_vv f90 nvt_h1_vv f90 nvt_gi_vv f90 npt_11_vv f90 npt_b1_vv f90 npt_h1_vv f90 npt_mi_vv f90 nst_11_vv f90 nst_b1_vv f90 nst_h1_vv f90 nst_m1_vv f90 w_at_start_vv f90 w_integrate_vv f90 w_md_vv f90 226 STFC Appendix C Define LeapFrog Verlet files FILES_LFV pseudo_lfv f90 constraints_shake_lfv f90 pmf_shake_lfv f90 nve_0_1fv f90 nvt_e0_1fv f90 nvt_10_1fv f90 nvt_a0_1fv f90 nvt_b0_1fv f90 nvt_h0_1fv f90 nvt_g0_l1fv f90 npt_10_lfv f90 npt_b0_1fv f90 npt_
99. particle has been assigned to the core and shell sites Action Correct the erroneous entry in FIELD and resubmit Message 33 error coincidence of particles in constraint bond unit DL_POLY_4 has found a fault in the definition of a constraint bond unit in the FIELD file The same particle has been assigned to the both sites Action Correct the erroneous entry in FIELD and resubmit Message 34 error length of constraint bond unit gt real space cutoff rcut DL_POLY_4 has found a constraint bond unit length FIELD larger than the real space cutoff rcut 250 STFC Appendix D CONTROL Action Increase cutoff in CONTROL or decrease the constraint bondlength in FIELD and resubmit For small system consider using DL POLY Classic Message 35 error coincidence of particles in chemical bond unit DL_POLY 4 has found a faulty chemical bond in FIELD defined between the same particle Action Correct the erroneous entry in FIELD and resubmit Message 36 error only one bonds directive per molecule is allowed DL_POLY_4 has found more than one bonds entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 38 error transfer array exceeded in metal_ld_export This should never happen Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxbfxp parameter in SET_BOUNDS recompile and resubmit Send
100. potential key see Table 6 14 variable 1 real potential parameter see Table 6 14 variable 2 real potential parameter see Table 6 14 variable 3 real potential parameter see Table 6 14 variable 4 real potential parameter see Table 6 14 variable 5 real cutoff range for this potential A potential 1 record 2 variable 6 real potential parameter see Table 6 14 variable 7 real potential parameter see Table 6 14 variable 8 real potential parameter see Table 6 14 variable 9 real potential parameter see Table 6 14 variable 10 real potential parameter see Table 6 14 variable 11 real potential parameter see Table 6 14 potential n record 2n 1 potential n record 2n cross term 1 record 2n 1 atmnam 1 as first atom type atmnam 2 a8 second atom type 154 STFC Section 6 1 variable a variable b variable c real real real potential parameter potential parameter potential parameter cross term n n 1 2 record 2n n n 1 2 see Table 6 14 see Table 6 14 see Table 6 14 e kihs atomkey expects 3n records specifying n particular Tersoff single atom type parameter sets in the following manner potential 1 atmnam key variable 1 variable 2 variable 3 variable 4 variable 5 potential 1 variable 6 variable 7 variable 8 variable 9 variable 10 variable 11 potential 1 variable 12 variable 13 variable 14 variable 15 variable 16 potential n potential n record 1 as ad real real
101. reports the major and secondary link cell algorithms Mz My Mz employed in the simulations immediately after execution Mz analogously for My and Mz is the integer number of the ratio of the width of the system domains in x direction i e perpendicular to the y z plane to the major and secondary coming from three and or four body and or Tersoff interactions short range cutoffs specified for the system Pa M Nine Wel z cutoff W MD box width L plane y z 5 1 P nodes ls alresti n gt where x y and z represent the directions along the MD cell lattice vectors Every domain node of the MD cell is loaded with Mz 2 My 2 M 2 link cells of which M M M belong to that domain 110 STFC Section 5 3 and the rest are a halo image of link cells forming the surface of the immediate neighbouring domains In this respect if we define performance efficiency as minimising communications with respect to maximising computation minimising the halo volume with respect to the node volume best performance efficiency will require Mz My M M and M gt 1 The former expression is a necessary condition and only guarantees good communication distribution balancing Whereas the latter is a sufficient condition and guarantees prevalence of computation over communications DL_POLY 4 issues a built in warning when a link cell algorithms has a dimension less than four i e less than four link cells pe
102. required cutoff Resubmit the job Message 454 error unknown external field A form of external field potential has been requested which DL_POLY_4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY_4 if this is reasonable Alternatively you may consider defining the required potential in the code yourself Amendments to subroutines READ_FIELD and EXTERNAL_FIELD_APPLY will be required 272 STFC Appendix D Message 456 error external field xpis ton is applied to a layer with at least one frozen particle For a layer to emulate a piston no particle constituting it must be frozen Action Locate the offending site s in the FIELD file and unfreeze the particles Message 461 error undefined metal potential A form of metal potential has been requested which DL_POLY_4 does not recognise Action Locate erroneous entry in the FIELD file and correct the potental interaction to one of the allowed ones for metals in DL POLY 4 Message 462 error thermostat friction constant must be gt 0 A zero or negative value for the thermostat friction constant has been encountered in the CONTROL file Action Locate the ensemble directive in the CONTROL file and assign a positive value to the time constant Message 463 error barostat friction constant must be gt 0 A zero or negative value for the barostat friction constant has been encountered in
103. short ranged typically of order 3 A This property plus the fact that Tersoff potentials two and three body contributions scale as N where N is the number of particles makes it essential that these terms are calculated by the link cell method 62 DL_POLY_4 applies no long ranged corrections to the Tersoff potentials In DL_POLY_4 Tersoff forces are handled by the routine TERSOFF_FORCES 2 3 4 Three Body Potentials The three body potentials in DL POLY 4 are mostly valence angle forms They are primarily included to permit simulation of amorphous materials e g silicate glasses However these have been extended to include the Dreiding 19 hydrogen bond The potential forms available are as follows 1 Harmonic harm k U Ojik 5 sir b0 2 180 2 Truncated harmonic thrm k U Ojik 5 Ojik 09 exp r 15 07 2 181 43 STFC Section 2 3 3 Screened Harmonic shrm U Ojik E Oja 00 exp ri P1 rik p2 2 182 4 Screened Vessal 37 bvs1 00050 gyp le m ra gt exp rij p1 rik p2 2 183 5 Truncated Vessal 38 bvs2 U Ojik k Prin Ojik 90 Ojik o Qn a a ST Ojik 8o T 80 expl ri r amp e l 2 184 6 Dreiding hydrogen bond 19 hbnd U Ojik Dry cost Ojik 5 Rro rin 6 Rro ryr 9 2 185 Note that for the hydrogen bond the hydrogen atom must be the central atom Several of these fun
104. shows the extent to which the Ewald sum is correctly converged These variables can be found under the columns headed eng_cou and vir_cou in the OUTPUT file see Section 6 2 6 The remainder of this section explains the meanings of these parameters and how they can be chosen The Ewald sum can only be used in a three dimensional periodic system There are five variables that control the accuracy a the Ewald convergence parameter reut the real space force cutoff and the kmaxa kmaxb and kmaxc integers that specify the dimensions of the SPME charge array as well as FFT arrays The three integers effectively define the range of the reciprocal space sum one integer for each of the three axis directions These variables are not independent and it is usual to regard one of them as pre determined and adjust the others accordingly In this treatment we assume that recut defined by the cutoff directive in the CONTROL file is fixed for the given system The Ewald sum splits the electrostatic sum for the infinite periodic system into a damped real space sum and a reciprocal space sum The rate of convergence of both sums is governed by a Evaluation of the real space sum is truncated at r reut so it is important that be chosen so that contributions to the real space Important note As the SPME method substitues the standard Ewald the values of kmaxa kmaxb and kmaxc are the double of those in the prescription of the standard Ewald since they
105. surface in a system with charges can also be modelled with DL_POLY_4 if periodicity is allowed in the Z direction In this case slabs of ions well separated by vacuum zones in the Z direction can be handled with imcon 1 2 or 3 200 Appendix B DL POLY_ 4 Macros Introduction Macros are simple executable files containing standard UNIX commands A number of the are supplied with DL_POLY_4 and are found in the execute sub directory These are not guaranteed to be immaculate but with little adaptation they can become a useful tool to a researcher The available macros are as follows e cleanup e copy e gopoly e gui e select e store The function of each of these is described below It is worth noting that most of these functions could be performed by the DL_POLY Java GUI 21 cleanup cleanup removes several standard data files from the execute sub directory It contains the UNIX commands rm OUTPUT STATIS REVCON REVOLD REVIVE RDFDAT ZDNDAT DEFECTS gopoly and removes the files OUTPUT REVCON REVOLD STATIS REVIVE DEFECTS and gopoly all variants It is useful for cleaning the sub directory up after a run Useful data should be stored elsewhere however copy copy invokes the UNIX commands mv CONFIG CONFIG OLD mv REVCON CONFIG mv REVIVE REVOLD which collectively prepare the DL POLY 4 files in the execute sub directory for the continuation of a simu lation It is always a good idea to store these files elsewhere in
106. that identifies the inconsistency In some cases an inconsistency is resolved by DL_POLY_4 supplying a default value or DL_POLY_4 assuming a priority of one directive over the another in clash of mutually exclusive directives However in other cases this cannot be done and controlled termination of the program execution is called by the subroutine ERROR In any case appropriate diagnostic message is displayed notifying the user of the nature of the problem 5 4 2 The DL_POLY_4 Internal Error Facility DL_POLY_4 contains a number of in built error checks scattered throughout the package which detect a wide range of possible errors In all cases when an error is detected the subroutine ERROR is called resulting in an appropriate message and termination of the program execution either immediately or after some additional processing In some case if the cause for error is considered to be mendable it is corrected and the subroutine WARNING results in an appropriate message Users intending to insert new error checks should ensure that all error checks are performed concurrently on all nodes and that in circumstances where a different result may obtain on different nodes a call to the global status routine GCHECK is made to set the appropriate global error flag on all nodes Only after this is done a call to subroutine ERROR may be made An example of such a procedure might be Logical safe safe test_condition Call gcheck safe If
107. that the all w_ F90 files in source and source V are in fact inclusion files that are wrapped as routines within DL_POLY This wrapping up of functional calls is done to shorten the length of the code by reusing general functional sequences where possible 7 2 3 Module Files The DL_POLY_4 module files contain all global variables scalars and arrays and parameters as well as some general methods and generic functions intrinsically related to the purpose or and contents of the specific module The file names and the methods or and functions developed in them have self explanatory names More information of their purpose can be found in their headers The rest of files in DL POLY_4 are dependent on the module files in various ways The dependency relation to a module file is explicitly stated in the declaration part of the code 7 2 4 General Files The DL_POLY_4 general files are common to both MPI and SERIAL version of the code In most cases they have self explanatory names as their order is matched as closely as possible to that occurring in the main segment of the code DL_POLY Only the first five files are exception of that rule WARNING and ERROR are important reporting subroutines that have call points at various places in the code and NUMERIC_CONTAINER and SPME_CONTAINER are containers of simple functions and subroutines related in some way to their purpose in the code 7 2 5 VV and LFV Specific Files These implement the specific
108. the cell vectors and the particles positions are specified in A there is a fine connection between them This would not be the case if the particles positions were kept in reduced space with fractional coordinates Last but not least it is worth pointing out that composite entities such as velocities and forces have their units expressed as composites of the DL_POLY units as shown in Section 1 3 7 Table 6 5 CONFIG File Key record 2 levcfg meaning 0 coordinates included in file 1 coordinates and velocities included in file 2 coordinates velocities and forces included in file Table 6 6 Periodic Boundary Key record 2 imcon meaning no periodic boundaries cubic boundary conditions orthorhombic boundary conditions parallelepiped boundary conditions x y parallelogram boundary conditions with no periodicity in the z direction awnr 6 1 2 3 Further Comments on the CONFIG File The CONFIG file has the same format as the output file REVCON Section 6 2 7 When restarting from a previous run of DL_POLY_4 i e using the restart restart noscale or restart scale directives in the CONTROL file above the CONFIG file must be replaced by the REVCON file which is renamed as the CONFIG file The copy macro in the execute sub directory of DL_POLY_4 does this for you The CONFIG file has the same format as the optional output file CFGMIN which is only produced when the minimise op
109. the CONTROL file Action Locate the ensemble directive in the CONTROL file and assign a positive value to the time constant Message 464 error thermostat relaxation time constant must be gt 0 A zero or negative value for the thermostat relaxation time constant has been encountered in the CONTROL file Action Locate the ensemble directive in the CONTROL file and assign a positive value to the time constant Message 466 error barostat relaxation time constant must be gt 0 A zero or negative value for the barostat relaxation time constant has been encountered in the CONTROL file Action Locate the ensemble directive in the CONTROL file and assign a positive value to the time constant Message 467 error rho must not be zero in valid buckingham potential User specified vdw type buckingham potential has a non zero force and zero rho constants Only both zero or both non zero are allowed Action Inspect the FIELD file and change the values in question appropriately 273 STFC Appendix D Message 468 error r0 too large for snm potential with current cutoff The specified location r0 of the potential minimum for a shifted n m potential exceeds the specified potential cutoff A potential with the desired minimum cannot be created Action To obtain a potential with the desired minimum it is necessary to increase the van der Waals cutoff Locate the rvdw directive in the CONTROL file and reset to a magni
110. the atoms making up the given intermolecular interaction unit same as a unit type in DAT files These descriptor lines can be commented out or not i e having as the first symbol would not affect the reading operation but it would ease importing of the data for plotting and manipulating in Xm Grace software In all TAB files the number of grid points bins must be specified on the second line commented out or not For angles TABANG TABDIH TABINV no other information needs to be provided as their ranges are pre determined 0 lt O in TABANG amp TABINV lt 180 and 180 lt in TABDIH lt 180 In the TABBND file however the bond cutoff rmax A must be precede the grid number Note that all potential and force data are to be provided in the same energy units as specified by the user in the FIELD file see Section 6 1 3 with distances in A and angles in degrees All the data related to angles are internally transformed and handled by DL_POLY _4 with angles measured in radians 100 STFC Section 4 3 Finally in order to instruct DL POLY _4 to use tabulated intramolecular force fields read from the TAB files the user has to specify in the FIELD file the keyword tab or tab for each intramolecular interaction thereby chosen for tabulation similarly to how it is described in Section 6 1 3 The dash symbol in front of the keyword tab is only valid for bonds and angles and is interpreted in the same manner as i
111. the core shell units but this should should not amount to more than a few percent of the total kinetic energy To determine safe shell masses in practice first a rigid ion simulation is performed in order to gather the velocity autocorrelation functions VAF of the ions of interest to polarise Each VAF is then Fast Fourier transformed to find their highest frequency of interaction Vrigid ion It is then a safe choice to assign a shell mass x m so that Veore she11 gt 3 Vrigia ion The user must make sure to assign the correct mass 1 x m to the core 2 5 2 Relaxed Massless Shells Model The relaxed shell model is presented in 68 where shells have no mass and as such their motion is not governed by the usual Newtonian equation whereas their cores motion is Because of that shells respond instantaneously to the motion of the cores for any set of core positions the positions of the shells are such that the force on every shell is zero The energy is thus a minimum with respect to the shell positions This represents the physical fact that the system is always in the ground state with respect to the electronic degrees of freedom Relaxation of the shells is carried out at each time step and involves a search in the multidimensional space of shell configurations The search in DL_POLY_4 is based on the powerful conjugate gradients technique 69 in an adaptation as shown in 68 Each time step a few iterations 10 30 are n
112. the problem to us if this is persistent Correct the erroneous entry in FIELD and resubmit Message 39 error density array exceeded in metal_ld_export This should never happen Action You might consider using densvar option in CONTROL Send the problem to us if this is persistent Message 40 error too many bond constraints specified This should never happen Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 41 error too many bond constraints per domain DL_POLY 4 limits the number of bond constraint units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action 251 STFC Appendix D Use densvar option in CONTROL to increase mxcons alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 42 error undefined direction passed to deport_atomic_data This should never happen Action Send the problem to us Message 43 error deport_atomic_data outgoing transfer buffer exceeded This may happen in extremely non equilibrium simulations or usually when the potential in use do not hold the system stable Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxbfdp parameter in SET_BOUNDS recompile and resubmit Message 4
113. timestep At It is relatively simple to show that the constraint force has the form Hij dij v v d Bij x At d2 Qij 3 18 The velocity corrections can therefore be written as uf At By _ bij dis vj 04 dij 3 19 2 Mi mi d j For a system of simple diatomic molecules computation of the constraint force will in principle allow the correct atomic positions to be calculated in one pass However in the general polyatomic case this 61 STFC Section 3 2 correction is merely an interim adjustment not only because the above formula is approximate but the successive correction of other bonds in a molecule has the effect of perturbing previously corrected bonds Either part of the RATTLE algorithm is therefore iterative with the correction cycle being repeated for all bonds until each has converged to the correct length within a given tolerance for RATTLE_VV1 SHAKE and the relative bond velocities are perpendicular to their respective bonds within a given tolerance for RATTLE_VV2 RATTLE The tolerance may be of the order 1074 A to 1078 A depending on the precision desired The SHAKE procedure may be summarised as follows 1 All atoms in the system are moved using the LFV algorithm assuming an absence of rigid bonds constraint forces This is stage 1 of the SHAKE algorithm 2 The deviation in each bondlength is used to calculate the corresponding constraint force equa tion 3 16 that retrospec
114. will not be used This option is not available in DL_ POLY Classic Note that rdf and vdw met are not complementary i e if the former is used in FIELD none of the pairs defined by the latter will be considered for RDF calculations The selected RDFs are calculated in the RDF_COLLECT RDF_EXCL_COLLECT RDF_FRZN_COLLECT and RDF_COMPUTE by collecting distance information from all two body pairs as encountered in the Verlet neighbour list created in the LINK_CELL_PAIRS routine within the TWO_BODY_FORCES routine In the construction of the Verlet neighbour list pairs of particles part of the exclusion list are excluded The exclusion list contains particles that are part of e core shell units e bond constraints e chemical bonds that are NOT distance restraints e valence angles that are NOT distance restraints e dihedrals e inversions e frozen particles RDF pairs containing type s of particles that fall in this list will be polluted However there are many ways to overcome such effects 4 tersoff n where n is the number of specified Tersoff potentials There are two types of Tersoff potential forms that cannot be mixed used simultaneously They are shorthanded as ters and kihs atomkeys e ters atomkey expects 2n records specifying n particular Tersoff single atom type parameter sets and n n 1 2 records specifying cross atom type parameter sets in the following manner potential 1 record 1 atmnam as atom type key ad
115. with the variable timestep option when iterative algorithms are present in the simulation Such may be driven by a combination of options such as minimise ensemble npt ensemble nst in the presence of constraints associated with the tolerance and mxshake options and or core shells units dealt by the relaxed shell model and associated with the rlxtol option in the model system as defined in the FIELD file Integration Defaults The default ensemble is NVE The default integration scheme is Trotter derived Velocity Verlet VV although Leapfrog Verlet LFV is also available VV is considered superior to LFV since 1 Integration can be developed in symplectic manner for certain ensembles such as NVE NVEk NVT Evans as well as all Nose Hoover ensembles NVT amp NPT amp NsT when there is no external field applied on the system otherwise they do not conserve the phase space volume and MTK ensembles NPT amp NsT 2 All ensemble variables are updated synchronously and thermodynamic quantities and estimators are exact at the every step whereas in LFV particle velocities and thermostat and 294 STFC Appendix E barostat friction velocities are half an integration time step behind the rest of the ensemble variables and due to this certain estimators are approximated at full timestep 3 It offers better numerical stability and faster convergence when i constraint solve
116. 00 1 3 1 0000 2 3 1 63299 FINISH VDW 45 C C lj 0 12000 3 2963 142 STFC Section 6 1 C CT lj 0 08485 3 2518 OW OS 1j 0 15100 3 0451 OS OS 1j 0 15000 2 9400 CLOSE 6 1 3 1 The FIELD File Format The file is free formatted and not case sensitive Every line is treated as a command sentence record Commented records beginning with a and blank lines are not processed and may be added to aid legibility see example above Records must be limited in length to 100 characters Records are read in words as a word must not exceed 40 characters in length Words are recognised as such by separation by one or more space characters The contents of the file are variable and are defined by the use of directives Additional information is associated with the directives 6 1 3 2 Definitions of Variables in the FIELD File The file divides into three sections general information molecular descriptions and non bonded interaction descriptions appearing in that order in the file General information The first viable record in the FIELD file is the title The second is the units directive Both of these are mandatory record 1 header al00 field file header record 2 units a40 Unit of energy used for input and output The energy units on the units directive are described by additional keywords a eV for electron Volts b kcal mol for k calories per mol e kJ mol for k Joules per mol d Kelvin Boltzmann for Kelvin per Bolt
117. 000E 00 0 000000E 00 98 STFC Section 4 2 4 99000 0 000000E 00 0 000000E 00 user host more ANGDAT TITLE Hexane FA OPLSAA gt CG mapped with 3 beads A B A ANGLES Probability Density Functions PDF histogram bin hist_sum bins dTheta_bin bins cutoff frames types 360 180 2285 1 Theta degrees PDF_norm Theta PDF_norm Theta sin Theta dTheta_bin 0 50000 type index instances A B A 1 1000 0 25000 0 000000E 00 0 000000E 00 0 75000 0 000000E 00 OOOO000E 00 1 25000 0 000000E 00 0 000000E 00 o 178 75000 1 380569E 02 6 328564E 01 179 25000 8 368490E 03 393238E 01 179 75000 2 901532E 03 6 649842E 01 O One can see that all the header lines are commented out due to starting with the hash symbol Nonethe less the header contains some useful information The title is as usual placed in the first line which is followed by an explanatory line with the definition of a normalised PDF The third line provides the four most important descriptors the number of bins on the histogram grid the cutoff interval absolute value of the span over which the distributions are sampled the number of frames samples used and the number of unique unit types analysed where unit is one of the following bonds angles dihedrals or inversions The last explanatory line in the header found in between two empty commented out lines defines the meaning of the columns and at the end the grid bin si
118. 1 exp 2ri kt K 2 219 L 0 50 STFC Section 2 5 2 Approximation of the structure factor S k S k bi k1 balla b3 k3 Ql k1 k2 ka 2 220 where Q k1 ka k3 is the discrete Fourier transform of the charge array Q 1 l2 3 defined as N Qll 42 3 Sig Y Mnluiz h nL x Malus lo naLo x j 1 n1 n2 n3 M uz 3 n3L3 2 221 in which the sums over n1 23 etc are required to capture contributions from all relevant periodic cell images which in practice means the nearest images 3 Approximating the reciprocal space energy Urecip 1 5 G k ka k3 Q k1 ka k3 y 2 222 Ureci P OV c k1 k2 k3 where GT is the discrete Fourier transform of the function exp k 4a M G k1 ko kg ee B k1 ko k3 Q ki kz k3 2 223 in which Q k1 k2 k3 is the complex conjugate of Q k1 ko k3 and B k1 ka ka b1 1 1 b2 k2 b3 k3 2 224 The function G k ka k3 is thus a relatively simple product of the Gaussian screening term appear ing in the conventional Ewald sum the function B k1 k2 k3 and the discrete Fourier transform of Q k1 ka k3 4 Calculating the atomic forces which are given formally by OU recip 1 OQ ki ka k3 G ka ka kg ZA 2 225 i are Veo 2 ki k2 k3 ar 2 225 1 2 3 Fortunately due to the recursive properties of the B splines these formulae are easily evaluated The virial and the stress tensor are calcula
119. 1 1 a Tkj Or Pane 2 v Pk V P35 Tkj Tkj N 2Ap Tkj ro Tki 5 exp p j Lj k 0 PAR A Bajf 1 1 kj To fki 5 exp 205 A TO y Pk V Pj ro Tkj 9 Many body perturbation component potential force Ui o Ork N OU2 Y me 1 g 1 a kj Ore jj 2 NV PR VPI Tjk 2 121 2 122 2 123 2 124 2 125 With the metal forces thus defined the contribution to be added to the atomic virial from each atom pair is then J 33 2 126 STFC Section 2 3 which equates to OU Y 3 OV N N N oV rij Ori OF pi Opi y 1 3V Y 22 Org OV 2 Opi OV rye Ori OV 1 3 Sij Uy Tij av av O 3V OV Ca v 0 ae Dns 2 127 i 1 Ai ij Opi A Opijlriz Orig _ 1 5 Opig rig gt pij rij YO 7 P aN LA Lani pag ORE OV Vga OR OF pi OF e Opi Tig Opi Op Ory 1 EAM virial The same as above EEAM virial The same as above 2BEAM virial The same as above but with a second embedding contribution from the extra band complexity Y2 ws g 4 2BEEAM virial The same as above but with a second embedding contribution from the extra band complexity Va ws g 5 Finnis Sinclair virial NN Yi 3 5 y 2 rij c co F C1Tij t car rij c c 2czrij Tij i 1 jAi N N 1 Af 1 rij dy o EoD 4 F 2 rij d 38 rae 2 128 2 i 1 Ai 2 E d 6 Extended Finnis Sinclair virial 1AN Y SY lr c Co
120. 1 exp ie R t dmass 2E rin t 20 dmass At x t lt 5 xt At y t z 73 3 90 3 91 3 92 3 93 STFC Section 3 5 Several iterations are required to obtain self consistency In DL POLY_4 the number of iterations is set to 3 4 if bond constraints are present The conserved quantity is derived from the extended Hamiltonian for the system which to within a constant is the Helmholtz free energy mass t a a Huvt Hyve SSE f kp Text f x s ds 3 94 where f is the system s degrees of freedom equation 3 11 The VV and LFV flavours of the Gentle Stochastic Thermostat are implemented in the DL_POLY_4 routines NVT_GO_vv and NVT_GO_LFV respectively The routines NVT_G1_vv and NvT_G1_LFV implement the same but also incorporate RB dynamics 3 5 Barostats The size and shape of the simulation cell may be dynamically adjusted by coupling the system to a barostat in order to obtain a desired average pressure Pext and or isotropic stress tensor 7 DL_POLY_4 has four such algorithms the Langevin type barostat 31 the Berendsen barostat 29 the Nos Hoover type barostat 30 and the Martyna Tuckerman Klein MTK barsotat 32 Only the Berendsen barostat does not have defined conserved quantity Note that the MD cell s centre of mass momentum is removed at the end of the integration algorithms with barostats 3 5 1 Instantaneous pressure and stress The instantaneous p
121. 205 D DL_POLY_4 Error Messages and User Action 245 E DL POLY 4 README 293 Bibliography 299 Index 303 List of Tables 6 1 6 2 6 3 6 4 6 5 6 6 6 7 6 8 6 9 6 10 6 11 6 12 6 13 6 14 6 15 6 16 6 17 Internal Trajectory Detects File Key sae 654 44865 69 o See EGS 131 Internal Restart Key ea s 4 04 44446 4s eb a ee pa Pee bes BSA a ED Ee 133 Internal Ensemble Key eae a ha ye ee ee ee OP eR ee eae Be 133 Electrostatics Key 6 a 484 2448 baa ee a ee ke ee eS Re eee a eee 136 CONFIG File Key record 2 sis rr Sas Hee EES we A 141 Periodic Boundary Key record 2 2 2 4 c22 c a4 40s eb2 eA e ee ee wae des 141 Tethering Potentials wc seati a aaraw a be Re eR RY a ee ee a eR 146 Chemical Bond Potentials o s a e e cocs 24055 ee 2 RS RASS RE GEE Ee RE 147 Valence Angle Potentials so eare cage 8 RDA o A a a ae a 149 Dihedral Angle Potentials gt e 150 Inversion Angle Potentials 2 24 2045 44 4 Sw hae a a De ee a ve ewe 150 Pair Potentials coccion cris SG SRS Ped eR a ED a See a 152 Metal Potential 2 2 4 4 g es aa oe ae a ae da ee REG SA a 153 Tersoff Potential ses cacc p L462 449 4688 Pap ee dee Lee AG eRe ee ee ee 156 Three body Potentials so e s rca ee ee eee ee 156 Four body Potentials e ca s a 268543462 8 abe ada ee ee eS 157 External Fields 2 2 44 299 244k BS ee a Re eS Ye eee REG Aa ee 158 Xl List of Figures 2 1 2 2 2 3 2 4 2 5 2 6 3 1 6 1 A l A 2 A 3 The in
122. 248 STFC Appendix D the domain decomposition link cell size and mxgrid is the parameter defining the length of the interpolation arrays An increment less than this is permissible however The same argument holds for the tabulated intramolecular interactions that are possibly supplied via the TABBND TABANG TABDIH and TABINV files All should have grids sized less than the generic mxgrid 4 Action The tables must be recalculated with an appropriate increment Message 23 error incompatible FIELD and TABLE file potentials This error arises when the specification of the short range potentials is different in the FIELD and TABLE files This usually means that the order of specification of the potentials is different When DL POLY_4 finds a change in the order of specification it assumes that the user has forgotten to enter one Action Check the FIELD and TABLE files Make sure that you correctly specify the pair potentials in the FIELD file indicating which ones are to be presented in the TABLE file Then check the TABLE file to make sure all the tabulated potentials are present in the order the FIELD file indicates Message 24 error end of file encountered in TABLE TABBND TABANG TABDIH TABINV file This means the TABLE TABBND TABANG TABDIH TABINV file is incomplete in some way either by having too few potentials included or the number of data points is incorrect Action Examine the TABLE file contents an
123. 2Egin t At 20 3 1 x t At x t 5 4 mass 3 At v t A e v t Al exp x t 48 gt 3 74 At 2Eqin t At 2 x t At x t At A a The algorithm is self consistent and requires no iterations The LFV implementation of the Nos Hoover algorithm is iterative as an initial estimate of x t at full step is calculated using an unconstrained estimate of the velocity at full step v t 1 FF f t f t At 3 75 2 LFV The iterative part is as follows 1 1 f t u t At u t At At E x t 70 1 r t At r t At v t z 3 76 3 SHAKE 4 Full step velocity 1 1 1 u t Lut At v t A 3 77 2 2 2 5 Thermostat 1 1 2Ekin t 2 dte Ap dl lapa E 2 2 dmass 1 1 1 i 5 xe At x 7 0 3 78 Several iterations are required to obtain self consistency In DL POLY 4 the number of iterations is set to 2 3 if bond constraints are present The conserved quantity is derived from the extended Hamiltonian for the system which to within a constant is the Helmholtz free energy qmass X t 2 t Huvt Hyve f kp Text I x s ds 3 79 where f is the system s degrees of freedom equation 3 11 The VV and LFV flavours of the Nos Hoover thermostat are implemented in the DL_POLY_4 routines NVT_HO_vv and NVT_HO_LFV respectively The routines NVT_H1_VV and NVT_H1_LFV implement the same but also incorporate RB dynamics 71
124. 3 At eo V t 1 2Epin t 1 v t exp nt Tat x nt A0 u t 3 166 1 1 r t At exp nt z At r t At v t Al for the anisotropic cell fluctuations case Similarly for the LFV couched algorithms these are n A E sad sat At av 20 Pos y gel 1 Pmass f Pmass u t 5 At E ali At e At E fx 1 n o 0 3 167 ret At x t 46 ole 340 t r A for the isotropic cell fluctuations case and n t 5 At exp y t At n ay LO Poe VOD Baal A Pmass f Pmass u t 5 At e a ADFA r t At r t At u t gt r Is gt A A IS NI gt A Ss for the anisotropic cell fluctuations case This ensemble is optionally extending to constant normal pressure and constant surface area NP AT 72 by semi isotropic constraining of the barostat equation of motion and slight amending the thermostat equation of motion and the conserved quantity to Feat ca mee tT mane mall a Bf 2 dt 0 Magl 0 0 a 8 2 d i 2Ekin t Pmass Tr n t nt 20 kp Text 3 169 aX 7 mass mass t 2 Pmass Tr n n t HNp AT HNVE E e 2 PextV t ES f 1 kB Text f x s ds Similarly this ensemble is optionally extending to constant normal pressure and constant surface tension NP yYT 72 by semi isotropic constraining of the barostat equation of motion and slight amending the thermosta
125. 4 error deport_atomic_data incoming transfer buffer exceeded Action See Message 43 Message 45 error too many atoms in CONFIG file or per domain This can happen in circumstances when indeed the CONFIG file has more atoms listed than defined in FIELD or when one of the domains managed by an MPI process has higher particle density than the system average and contains more particles than allowed by the default based on the system Action Check if CONFIG and FIELD numbers of particles match Try executing on various number of processors Try using the densvar option in CONTROL to increase mxatms alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Send the problem to us if this is persistent Message 46 error undefined direction passed to export_atomic_data This should never happen Action Send the problem to us Message 47 error undefined direction passed to metal_ld_export This should never happen Action Send the problem to us 252 STFC Appendix D Message 48 error transfer buffer too small in _table_read Action Standard user response Increase mxgrid parameter in SET_BOUNDS recompile and resubmit Message 49 error frozen shell core shell unit specified The DL_POLY 4 option to freeze the location of an atom i e hold it permanently in one position is not permitted for the shells in core shell units Action Remove the frozen atom option from the FIE
126. 54 mbpc This component is another analytical potential in the FS class which two body part may be defined by a matching van der Waals potential in the vdw section of the FIELD file It has the form Vij riz 0 0 gt Tye Pijlrij 3 alr c lt ri lt d 2 117 0 ryj gt d F pi evPi with parameters e a m both c and d are cutoffs All of these metal potentials can be decomposed into pair contributions and thus fit within the general tabulation scheme of DL_POLY_4 where they are treated as pair interactions though note that the metal cutoff rmet has nothing to do with short ranged cutoff ryqw DL POLY 4 calculates this potential in two stages the first calculates the local density p for each atom and the second calculates the potential energy and forces Interpolation arrays vmet gmet and fmet METAL_GENERATE METAL_TABLE_READ are used in both these stages in the same spirit as in the van der Waals interaction calculations The total force Le on an atom k derived from this potential is calculated in the standard way TE ViUmetal 2 118 We rewrite the EAM FS potential equation 2 109 as Umetal eae U D rij 2 119 i 1 A N Uz F p i l where r rj r The force on atom k is the sum of the derivatives of U and U2 with respect to rx which is recognisable as a sum of pair forces Ui V rij Tij Orig _ a OVrj rrj Tki Org 2 ay Be Orij Ork eya OTR Thi OU
127. 67 624 The RSDDAT File s sa qa 4 465 ae HOR Eh SR ea ee ak E 168 020 The CEGMIN Piles i dose foe ee ee ee ee ae ee Be ee Pe ed 169 6 2 6 The OUTPUT Piles o ce boa we Rae he ed ew hee Bee ae ees 169 6 2 7 The REVCON Pile sa s g ane gow ida 24d 4b a6 2 Pe wa Eee oa EE eS 173 G25 The REVIVE Pile 2 4 2 4 20s soble fda Boe ke AG ee EE A eS 173 629 The RDEDAT File sr 24 44 64 ds ee eee begs eh ete hae Ged a we 173 6 2 10 The ZDNDAT Pile es sa roc eee Rw ORE RSE EP A ae ee See RS 174 6 2 11 The VAFDAT Files 0 ee 174 6 2 12 The INTDAT INTPMF INTTAB Files 0 175 C213 The STATIS Piles a4 ice Sir ce Ma ee ETE ad ee we ek o ee eS 175 STFC Contents 7 The DL POLY_4 Parallelisation and Source Code 178 Sl Parallelisti lMa s ax 224 8 gee ge A a a is e 179 7 1 1 The Domain Decomposition Strategy 2 2 2 0 e a e e ee 179 7 1 2 Distributing the Intramolecular Bonded Terms 00200005 180 7 1 3 Distributing the Non bonded Terms 0 e 181 TLA Modifications tor the Ewald Sums 20 esus ae Yee ee a a he oe ee a d N 182 Takeo Metal Potentials 24 44 4604 d 6 a ae eee 4 Se he a eee 182 7 1 6 Tersoff Three Body and Four Body Potentials 24 182 TLT Globally Summed Properties aor sis aus ei Sake ee he a ee 182 7 1 8 The Parallel DD tailored SHAKE and RATTLE Algorithms 183 7 1 9 The Parallel Rigid Body Implementation
128. 7 variable 4 real potential parameter see Table 6 17 variable 5 real potential parameter see Table 6 17 The variables pertaining to each field potential are described in Table 6 17 Note only one type of field can be applied at a time Note that external force parameters are read in terms of the specified energy units and the general DL_POLY units so that the two sides of the equation defining the field are balanced For example the magnetic field units H H H2 H3 in the DL POLY FIELD scope will follow from the interaction definition as seen in Table 6 17 F lux Hg therefore F _ m la B du fa _ Dalton A ps _ Dalton al proton A ps proton ps 6 8 H 1 037837512 x 10 Tesla 6 9 H DL_POLY H MKS 1 037837512 x 101 157 STFC Section 6 1 Table 6 17 External Fields key potential type Variables 1 5 functional form elec Electric Field Ex Ey E F qE oshr Oscillating Shear A n E A cos 2n7 2 L shrx Continuous Shear A zo yaz Akl z gt 20 grav Gravitational Field Gy Y G F mG magn Magnetic Field H Hy H F q wx H sphr Containing Sphere A Ro n Reut F A RBRo r r gt Reut zbnd Repulsive Wall A 20 P F A z 2z p z gt p 2 xpis X Piston Cats joie Pee E E ACA de Vk 9 k i my Mk zres Molecule in HR Zone 9 glob k z z P A Zem Zma Zem gt 2ma ind ind mn mI z A Zmn Zem ELA enn glob glob A z 2ma 2 gt tmej ma
129. 90 o kinetic_module o A setup_module o site_module o nvt_e0_scl o comms_module o config_module o kinds_f90 o setup_module o nvt_e0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nvt_e1_lfv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_el_scl o comms_module o config_module o kinds_f90 0 rigid_bodies_module o setup_module o nvt_el_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nvt_gO_lfv o comms_module o config_module o kinds_f90 o0 kinetic_module o A langevin_module o setup_module o site_module o nvt_g0_scl o config_module o kinds_f90 o kinetic_module o setup_module o nvt_g0_vv o comms_module o config_module o kinds_f90 o kinetic_module o langevin_module o setup_module o site_module o nvt_gi_lfv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o nvt_gi_scl o config_module o kinds_f90 0 kinetic_module o A rigid_bodies_module o setup_module o nvt_gi_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o nvt_hO_lfv o comms_module o config_module o kinds_f90 o kinetic_module o A setup_module o site_module o
130. ALA Wik PEA gt AA Lij Do dela Gan exp aitri rin kAi j glOijk Cri golOijx Jalbijk 2 160 X _ C2 hi COS bik Golijk cai hi cos Ox ga Oijz 1 C4 exp si hi cos 0i54 y where the term defines the effective coordination number of atom 7 i e the number of nearest neighbors taking into account the relative distance of the two neighbors and k rj riz and the bond angle Oijk between them with respect to the central atom i The function g has a minimum for h cos 0 x the parameter d in ters and c3 in kihs determines how sharp the dependence on angle is whereas the rest express the strength of the angular effect Further mixed parameters are defined as aij a aj 2 bij bi b5 2 Age AA 4 By BiB 2 161 Rig RiR Sig S455 Singly subscripted parameters such as a and 7 depend only on the type of atom For ters the chemistry between different atom types is locked in the two sets bi atomic parameters xi and Wij Xii Wii Ll Xij Xji 1 Wij Wji 2 162 which define only one independent parameter each per pair of atom types The x parameter is used to strengthen or weaken the heteropolar bonds relative to the value obtained by simple interpolation The w parameter is used to permit greater flexibility when dealing with more drastically different types of atoms The force on an atom derived from this potential is pa calculated with the formula
131. B These raw PBD files must first be preprocessed by the user before they are in a readable format for DL_FIELD To ensure this it is advisable that users take into consideration the following steps 1 Decide on inclusion exclusion of and if necessary manually delete molecular residues that involve multiple occupancies in crystalline structures 2 Usually hydrogen atoms are not assigned in the raw PDB file The molecules must therefore be pre filled with hydrogen atoms protonated by using any standard packages available The user must ensure that proper care is taken of terminal residues which must also be appropriately terminated 3 Decide on the various charge states of some amino acids such as histidine HIS lysine LYS glu tamic acid GLU etc by adding or deleting the appropriate hydrogen atoms Force field schemes such as CHARMM will have different three letter notations for amino acids of different charge states DL_FIELD will automatically identify these differences and assign the appropriate potential parame ters accordingly 4 For cysteine CYS molecules with disulphide bonds thiolate hydrogen atoms must be removed DL FIELD will automatically define disulphide bonds between the molecules provided the S S dis tance is within a sensible value 5 DL_FIELD does not solvate the molecules and it is the user s responsibility to add water by using any standard package available for example the DL_POLY GUI 21 Fore m
132. BJ_MOD list whereas such order does not exist in the OBJ_ALL list Therefore should dependence exist between routines listed in the OBJ_ALL list it must be explicitly declared in the makefile 5 2 1 3 Note on the Interpolation Scheme In DL_POLY_4 two body like contributions van der Waals metal and real space Ewald summation to energy and force are evaluated by interpolation of tables constructed at the beginning of execution The DL_POLY_4 interpolation scheme is based on a 3 point linear interpolation in r Note that a 5 point linear interpolation in r is ised in DL_POLY 4 for interpolation of the EAM metal forces from EAM table data TABEAM 106 STFC Section 5 2 The number of grid points mxgrid required for interpolation in r to give good energy conservation in a simulation is mxgrid Max mxgrid 1000 Int reut 0 01 0 5 4 where reut is the main cutoff beyond which the contributions from the short range like interactions are negligible 5 2 2 Running To run the DL POLY 4 executable DLPOLY Z you will initially require three to six input data files which you must create in the execute sub directory or whichever sub directory you keep the executable program The first of these is the CONTROL file Section 6 1 1 which indicates to DL POLY_4 what kind of simulation you want to run how much data you want to gather and for how long you want the job to run The second file you need is the CONFIG fil
133. CONFIG SCAN_FIELD SCAN_CONTROL you will need to insert a new line in SET_BOUNDS to redefine it after the relevant subroutine has been called Finally the code must be recompiled as in this case it will only be necessary to recompile SET_BOUNDS and not the whole code The DL_POLY_4 Error Messages Message 1 error word_2_real failure The semantics in some of the INPUT files is wrong DL_POLY_4 has tried to read a number but the has found a word in non number format Action Look into your INPUT files and correct the semantics where appropriate and resubmit DL POLY 4 will have printed out in the OUTPUT file what the found non uniform word is 245 STFC Appendix D Message 2 error too many atom types in FIELD scan_field This error arises when DL_POLY_4 scans the FIELD file and discovers that there are too many different types of atoms in the system i e the number of unique atom types exceeds the 1000 Action Increase the number of allowed atom types mmk in SCAN_FIELD recompile and resubmit Message 3 error unknown directive found in CONTROL file This error most likely arises when a directive is misspelt in the CONTROL file Action Locate the erroneous directive in the CONTROL file and correct error and resubmit Message 4 error unknown directive found in FIELD file This error most likely arises when a directive is misspelt or is encountered in an incorrect location in the FIELD file which can hap
134. CONFIG the force field file FIELD and a generic control file CONTROL 2 Force field editor DL_FIELD allows the user to edit or modify parameters of a particular force field scheme in order to produce a customised scheme that is specific to a particular simulation model In addition the standard force field model framework can also be easily modified For instance introduction of pseudo points and rigid body implementation to an otherwise standard potential scheme such as CHARMM or AMBER etc 3 Force field library repertoire DL_FIELD contains a range of popular potential schemes see below all described in a single DL_FIELD format that are also easily recognisable by the user for maintenance purposes Users can easily expand the existing library to include other new molecules 112 STFC Section 5 3 Force Field Schemes The available force field schemes are as follows CHARMM proteins ethers some lipids and carbohydrates AMBER proteins and Glycam for carbohydrates OPLSAA proteins DREIDING General force field for covalent molecules PCFF Polyorganics and other covalent molecules Model Construction DL_FIELD does not have feature to construct molecular models This can be achieved by either using DL_POLY GUI 21 or any other standard molecular building packages The output files must be converted into the PDB format In the case of proteins these structures are usually obtained from data banks such as PD
135. Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxcell in SET_BOUNDS recompile and resubmit Message 402 error van der waals not specified The user has not set any cutoff in CONTROL rvdw the van der Waals potentials cutoff is needed in order for DL_POLY_4 to proceed Action Supply a cutoff value for the van der Waals terms in the CONTROL file using the directive rvdw and resubmit job Message 410 error cell not consistent with image convention The simulation cell vectors appearing in the CONFIG file are not consistent with the specified image convention Action Locate the variable imcon in the CONFIG file and correct to suit the cell vectors Message 414 error conflicting ensemble options in CONTROL file DL_POLY 4 has found more than one ensemble directive in the CONTROL file Action Locate extra ensemble directives in CONTROL file and remove Message 416 error conflicting force options in CONTROL file DL_POLY_4 has found incompatible directives in the CONTROL file specifying the electrostatic interactions options Action Locate the conflicting directives in the CONTROL file and correct 269 STFC Appendix D Message 430 error integration routine not available A request for a non existent ensemble has been made or a request with conflicting options that DL POLY 4 cannot deal with Action Examine the CONTROL and FIELD file
136. Constant T algorithm GST 71 NVT_G1_VV NVT_G1_LFV The same as the above but also incorporating RB integration NPT_LO_VV NPT_LO_LFV Constant T P algorithm Langevin 31 NPT_L1_VV NPT_L1_LFV The same as the above but also incorporating RB integration NPT_BO_VV NPT_BO_LFV Constant T P algorithm Berendsen 29 NPT_Bl_vv NPT_B1_LFV The same as the above but also incorporating RB integration NPT_HO_vv NPT_HO_LFV Constant T P algorithm Hoover 30 NPT_H1_VV NPT_H1_LFV The same as the above but also incorporating RB integration NPT_MO_VV NPT_MO_LFV Constant T P algorithm Martyna Tuckerman Klein 32 NPT_M1_vv NPT_M1_LFV The same as the above but also incorporating RB integration NPT_LO_VV NPT_LO_LFV Constant T algorithm Langevin 31 NPT_L1_VV NPT_L1_LFV The same as the above but also incorporating RB integration NST_BO_VV NST_BO_LFV Constant T algorithm Berendsen 29 NST_Bl_vv NST_B1_LFV The same as the above but also incorporating RB integration NST_HO_VV NST_HO_LFV Constant T algorithm Hoover 30 NST_H1_vv NST_H1_LFV The same as the above but also incorporating RB integration NST_MO_VV NST_MO_LFV Constant T o algorithm Martyna Tuckerman Klein 32 NST_MO_VV NST_MO_LFV The same as the above but also incorporating RB integration It is worth noting that the last four ensembles are also optionally available in an extended from to constant normal pressure and constant surface area NP AT or constant surface tension NP yT 72
137. D file Action Read the DL_POLY_4 documentation and find the potential keyword for the potential desired Message 151 error unknown EAM keyword in TABEAM DL POLY 4 checks when constructing the interpolation tables for the EAM metal potentials that the po tential function requested is one which is of a form known to the program If the requested potential form is unknown termination of the program results The most probable cause of this is the incorrect choice of the potential keyword in the FIELD file Message 160 error undefined direction passed to statistics_connect_spread This should never happen Message 163 error statistics_connect_spread outgoing transfer buffer exceeded The transfer buffer has been exceeded 265 STFC Appendix D Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxbfss parameters in SET_BOUNDS recompile and resubmit Message 164 error statistics_connect_spread incoming transfer buffer exceeded The transfer buffer has been exceeded Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxbfss parameters in SET_BOUNDS recompile and resubmit Message 170 error too many variables for statistics array This error means the statistics arrays appearing in subroutine STATISTICS_COLLECT are too small This should never happen Action Contact DL_POLY 4
138. E ra 2 149 e 2BEAM case similarly to the EAM case it is required that AB BB ph rij pi rij BA AA pi rig pi ry 2 150 for the d band densities whereas for the s band ones A A pig rig Pig ris 2 151 which means that an atom of type A contributes the same s density to the environment of an atom of type B as an atom of type B to an environment of an atom of type A However in general ba rag Aea rag Aog rg 2 152 e 2BEEAM case similarly to the EEAM case all s and d densities can be different ego Cpe ee eae Oe pt Orig amp 087 ra aa FO rig 2 153 e FS case here a different rule applies 15 pA rig o rag BP ag 2 154 so that atoms of type A and B contribute the same densities to each other but not to atoms of the same type The above rules have the following consequences to the specifications of these potentials in the DL_POLY_4 FIELD file for an alloy composed of n different metal atom types both the EAM types and FS types of potentials require the specification of n n 1 2 pair functions v rij However the its only the simple EAM type together with all the FS types that require only n density functions pig rag whereas the EEAM class requires all the cross functions pig rig possible or n in total In addition to the n n 1 2 pair functions and n or n density functions both the EAM and EEAM potentials require further specification of 39 STFC Sec
139. E 01 1 787340483 9226 455153 etc 1 4 276 O 000000000000000 23 372293600000000 0 000000000000000 44 028000000000000 1 484234330 1 872177437 13070 74357 1 972916834 1 577400769 4806 880540 2 125627191 4 336956694 8318 045939 2 503798635 1 021777575 9445 662860 6 1 2 1 The CONFIG File Format O 000000000000000 O 000000000000000 7 274585343 0 7702718106 4432 030587 7 340573742 4 328786484 1255 814536 7 491549620 2 951142896 2379 766752 3 732081894 0 5473436377 5365 202509 The file is free formatted and not case sensitive Every line is treated as a command sentence record However line records are limited to 72 characters in length Records are read in words as a word must not exceed 40 characters in length Words are recognised as such by separation by one or more space characters Te I O effects are excluded from comparison with a default simualtion and comparisons are carried over a few hundreds of timesteps This is usually accounting for over 90 of the time tosolution 139 STFC Section 6 1 The first record in the CONFIG file is a header up to 72 characters long to aid identification of the file Blank and commented lines are not allowed 6 1 2 2 Definitions of Variables in the CONFIG File record 1 header a12 title line record 2 levcfg integer CONFIG file key See Table 6 5 for permitted values imcon integer Periodic bou
140. EFECTS_REFERENCE_EXPORT DEFECTS_REFERENCE_SET_HALO DEFECTS_LINK_CELLS DEFECTS1_WRITE DEFECTS_WRITE MSD_WRITE RSD_WRITE VAF_WRITE IMPACT CORE_SHELL_ON_TOP DEPORT_ATOMIC_DATA PMF_UNITS_SET COMPRESS_BOOK_INTRA RELOCATE_PARTICLES LINK_CELL_PAIRS METAL_LD_COLLECT_EAM METAL_LD_COLLECT_FST METAL_LD_EXPORT METAL_LD_SET_HALO METAL_LD_COMPUTE EXCHANGE_GRID EWALD_SPME_FORCES METAL_FORCES VDW_FORCES EWALD_REAL_FORCES COUL_DDDP_FORCES COUL_CP_FORCES COUL_FSCP_FORCES COUL_RFP_FORCES RDF_COLLECT RDF_EXCL_COLLECT RDF_FRZN_COLLECT EWALD_EXCL_FORCES EWALD_FRZN_FORCES TWO_BODY_FORCES TERSOFF_FORCES THREE_BODY_FORCES FOUR_BODY_FORCES CORE_SHELL_FORCES TETHERS_FORCES INTRA_COUL BONDS_FORCES ANGLES_FORCES INVERSIONS_FORCES DIHEDRALS_14_VDW DIHEDRALS_FORCES EXTERNAL_FIELD_APPLY EXTERNAL_FIELD_CORRECT LANGEVIN_FORCES CONSTRAINTS_PSEUDO_BONDS PMF_PSEUDO_BONDS RIGID_BODIES_SPLIT_TORQUE RIGID_BODIES_MOVE MINIMISE_RELAX 187 STFC Section 7 2 CORE_SHELL_RELAX ZERO_K_OPTIMISE VAF_COLLECT NVT_EO_SCL NVT_E1_SCL NVT_BO_SCL NVT_B1_SCL XSCALE CORE_SHELL_KINETIC REGAUSS_TEMPERATURE Z_DENSITY_COLLECT STATISTICS_COLLECT STATISTICS_CONNECT_SET STATISTICS_CONNECT_SPREAD STATISTICS_CONNECT_FRAMES SYSTEM_REVIVE RDF_COMPUTE Z_DENSITY_COMPUTE VAF_COMPUTE BONDS_COMPUTE ANGLES_COMPUTE DIHEDRALS_COMPUTE INVERSIONS_COMPUTE STATISTICS_RESULT W_IMPACT_OPTION W_WRITE_OPTIONS W_CALCULATE_FORCES W_REFRESH_MAPPINGS W_KINETIC_OPTIONS W_STATISTICS_REPORT W_REFRESH_
141. FC Section 6 2 al a hash symbol cutpot real cutoff in A only expected in TABBND as the cutoff ranges are known for TABANG TABDIH amp TABINV ngrid integer number of grid points in table for all potentials record 3 al a hash symbol The subsequent records define each tabulated potential in turn in the order indicated by the specification in the FIELD file Each potential is defined by a header record and a set of data records with the potential and force tables empty record id record al a hash symbol atom 1 a8 first atom type atom 2 a8 second atom type atom 3 a8 third atom type only required for TABANG atom 4 a8 forth atom type only required for TABDIH amp TABINV interaction data records 0 1 ngrid abscissa real consecutive value over the full cutoff range in A for TABBND and degrees for TABANG TABDIH amp TABINV potential real potential at the abscissa grid point in units as specified in FIELD force real complementary force virial for TABBND value 6 1 8 2 Further Comments It should be noted that the number of grid points in the table files should not be less than the number of grid points DL_POLY_4 is expecting For more information the reader is advised to examine SETUP_MODULE and inspect the mxgint variables where int refers to bnd for bonds ang for angles dih for dihedrals and inv for inversions The potential and force tables are used to fill the internal arrays vint and gint for th
142. FIELD Message 486 error only one of the PMF units is permitted to have frozen atoms Only one of the PMF units is permitted to have frozen atoms Action Correct the erroneous entries in FIELD Message 488 error too many PMF constraints per domain This should not happen Action Is the use of PMF constraints in your system physically sound Message 490 error local PMF constraint not found locally This should not happen Action Is your system physically sound is your system equilibrated Message 492 error a diameter of a PMF unit gt minimum of all half cell widths The diameter of a PMF unit has exceeded the minimum of all half cell widths Action 275 STFC Appendix D Consider the physical concept you are trying to imply in the simulation Increase MD cell dimensions Message 494 error overconstrained PMF units PMF units are oveconstrained Action DL_POLY 4 algorithms cannot handle overconstrained PMF units Decrease the number of constraints on the PMFs Message 497 error pmf_quench failure Action See Message 515 Message 498 error shake algorithm pmf_shake failed to converge Action See Message 515 Message 499 error rattle algorithm pmf_rattle failed to converge Action See Message 515 Message 500 error PMF unit of zero length is not permitted PMF unit of zero length is found in FIELD PMF units are either a single atom or a group of atoms usually
143. LAGS appropriate flags for LD FC path to FORTRAN9O compiler FCFLAGS appropriate flags for FC EX EX BINROOT BINROOT TYPE System specific targets follow win MAKE LD f95 o LDFLAGS 03 FC 95 c FCFLAGS 03 EX EX BINROOT BINROOT TYPE 243 Appendix C win debug MAKE LD 95 o LDFLAGS 00 C all C undefined FC 95 c FCFLAGS 00 C all C undefined EX EX BINROOT BINROOT TYPE Default code master message check 0BJ_MOD OBJ_ALL LD EXE LDFLAGS OBJ_MOD OBJ_ALL Message message echo DL_POLY_4 compilation in SRL2 mode echo echo Use mpi must change to Use mpi_module in comms_module f90 echo Check that a platform has been specified check if test FC undefined then echo echo FORTRAN9O compiler unspecified echo echo Please edit your Makefile entries echo exit 99 LEON A if test LD undefined then echo echo FORTRAN9O Linker loaDer unspecified echo echo Please edit your Makefile entries echo exit 99 fi mkdir p BINROOT touch dl_poly f90 Declare rules f90 0 FC FCFLAGS 90 Declare dependencies OBJ_ALL OBJ_MOD 244 Appendix D DL_POLY 4 Error Messages and User Action Introduction In this appendix we document the error messages encoded in DL_PO
144. LD file Consider using a non polarisable atom instead Message 50 error too many bond angles specified This should never happen This error most likely arises when the FIELD file or and DL POLY_4 executable are corrupted Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 51 error too many bond angles per domain DL_POLY_4 limits the number of valence angle units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to increase mxangl alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 52 error end of FIELD file encountered This message results when DL_POLY_4 reaches the end of the FIELD file without having read all the data it expects Probable causes missing data or incorrect specification of integers on the various directives Action Check FIELD file for missing or incorrect data correct and resubmit Message 53 error end of CONTROL file encountered This message results when DL_POLY_4 reaches the end of the CONTROL file without having read all the data it expects Probable cause missing finish directive Action Check CONTROL file correct and resubmit Message 54 error outgoing transfer buffer exceeded in export_atomic_data This may happen
145. LY_4 and the recommended user action The correct response is described as the standard user response in the appropriate sections below to which the user should refer before acting on the error encountered The reader should also be aware that some of the error messages listed below may be either disabled in or absent from the public version of DL_POLY_4 Note that the wording of some of the messages may have changed over time usually to provide more specific information The most recent wording appears below The Standard User Response DL POLY 4 uses FORTRAN9O0 dynamic array allocation to set the array sizes at run time This means that a single executable may be compiled to over all the likely uses of the code It is not foolproof however Sometimes an estimate of the required array sizes is difficult to obtain and the calculated value may be too small For this reason DL_POLY_4 retains array dimension checks and will terminate when an array bound error occurs When a dimension error occurs the standard user response is to edit the DL POLY_4 subroutine SET_BOUNDS Locate where the variable defining the array dimension is fixed and increase accordingly To do this you should make use of the dimension information that DL_POLY_4 prints in the OUTPUT file prior to termination If no information is supplied simply doubling the size of the variable will usually do the trick If the variable concerned is defined in one of the support subroutines SCAN_
146. ME sum precision or and increase cutoff Message 321 error LFV quaternion integrator failed This indicates unstable integration but may be due to many reasons Action 267 STFC Appendix D Rethink the simulation model Increase mxquat in CONTROL and resubmit or use VV integration to check system stability Message 340 error invalid integration option requested DL_POLY_4 has detected an incompatibility in the simulation instructions namely that the requested integration algorithm is not compatible with the physical model It may be possible to override this error trap but it is up to the user to establish if this is sensible Action This is a non recoverable error unless the user chooses to override the restriction Message 350 error too few degrees of freedom This error can arise if a small system is being simulated and the number of constraints applied is too large Action Simulate a larger system or reduce the number of constraints Message 360 error degrees of freedom distribution problem This should never happen for a dynamically sensical system This error arises if a model system contains one or more free zero mass particles Zero mass mass less particles sites are only allowed for shells in core shell units and as part of rigid bodies mass less but charged RB sites Action Inspect your FIELD to find and correct the erroneous entries and try again Message 380 error simulation tem
147. NP yT 72 by semi isotropic constraining of the barostat equation of motion and slight amending the thermostat equation of motion and the conserved quantity to tal rete MOI VO _ y t noa t a a y Eolo de Ona a 6 2 0 gt Mag 0 0 a 4 6 x y 2 d 2Ekin t Pmass TrIn t no 20 3 kp Text Hate a 3 161 aX mass mass t Pmass Trin i 17 t Hrest Hyve Pr ER EL pa t f 3 Ko Tea f x s do where Yext is the user defined external surface tension and h t V t Azy t is the instantaneous hight of the MD box or MD box volume over area One defines the instantaneous surface tension as given in equation 3 120 The case Yext 0 generates the NPT anisotropic ensemble for the orthorhombic cell imcon 2 in CONFIG see Appendix A This can be considered as an orthorhombic constraint on the NoT ensemble The constraint can be strengthened further to a semi orthorhombic one by imposing that the MD cell change isotropically in the x y plane which leads to the following changes in the equations above TL ext Jex hz A O 8 29 3 162 2 mass T nt t Fraai Hive dass XU y O vi 2 ko Tos J xtas The VV and LFV flavours of the non isotropic Nos Hoover barostat and thermostat are implemented in the DL_POLY 4 routines NST_HO_VV and NST_HO_LFV respectively The routines NST_H1_VV and NST_H1_LFV implement the same but also incorporate RB dynamics 87 OSTFC
148. NROOT TYPE dirac MAKE LD usr local mpich gm pgroup121 7b bin mpif90 v o LDFLAGS 03 L usr local mpich gm pgroup121 7b lib lmpich lfmpich lmpichf90 L usr local gm binary lib lgm L usr local lib FC usr local mpich gm pgroup121 7b bin mpif90 c FCFLAGS fast Knoieee Mdalign 03 EX EX BINROOT BINROOT TYPE Franklin SUNfire cluster setenv HPCF_MPI yes franklin MAKE LD opt SUNWhpc bin mpf90 o LDFLAGS stackvar fsimple 1 x03 xarch v9b DHPCF_MPI Impi A xlic_lib sunperf FC opt SUNWhpc bin mpf90 c FCFLAGS stackvar fsimple 1 x03 xarch v9b xchip ultra xlic_lib sunperf xalias actual fpover ftrap none fnonstd libmil dalign I opt SUNWhpc HPC5 0 include v9 EX EX BINROOT BINROOT TYPE hpcx MAKE LD mpx1f90_r o LDFLAGS 03 q64 qmaxmem 1 MX FC mpx1f90_r qsuffix f f90 c FCFLAGS 03 q64 qmaxmem 1 qarch pwr5 qtune pwrb qnosave EX EX BINROOT BINROOT TYPE hpcx debug MAKE LD mpx1f90_r o LDFLAGS g C q64 00 lessl lhmd FC mpx1f90_r qsuffix f f90 c FCFLAGS g C q64 00 qarch pwr5 qtune pwr5 qnosave EX EX BINROOT BINROOT TYPE BGL MAKE LD bg1 BlueLight ppcfloor bglsys bin mpixlf95 o LDFLAGS 03 qhot qarch 440d qtune 440 FC bgl1 BlueLight ppcfloor bglsys bin mpixlf95 c FCFLAGS 03 qhot qarch 440d qt
149. Note that in some cases additional keywords shown in brackets may also be supplied in the directives or directives may be used in a long form However it is strongly recommended that the user uses only the bold part of these directives Table 6 1 Internal Trajectory Defects File Key keytrj meaning 1 0 coordinates only in file 2 coordinates velocities and forces in file coordinates and velocities in file 6 1 1 3 Further Comments on the CONTROL File 1 A number of the directives or their mutually exclusive alternatives are mandatory a rcut cut specifying the short range forces cutoff It is compulsory in all circumstances as all DL POLY_4 algorithms are directly or indirectly dependent on it b c d temp or zero specifying ceed zero in CONTROL the system temperature not mutually exclusive but if temp has to pro if zero is needed Use only one instance of these in CONTROL If a dry run is performed see below these can be omitted timestep or variable timestep specifying the simulation timestep Use only one instance of these in CONTROL If a dry run is performed see below and a timestep length is not supplied a default one of 0 001 ps is provided ewald spme sum precision or coul or shift or distan or reaction or no elec specifying the required coulombic fo rces option Apart from no elec the rest of the directives are mutually exclu
150. ODULE Message 1001 error allocation failure in comms_module gt gcheck_vector DL_POLY_4 has failed to find available memory to allocate an array or arrays i e there is lack of sufficient memory per node on the execution machine Action This may simply mean that your simulation is too large for the machine you are running on Consider this before wasting time trying a fix Try using more processing nodes if they are available If this is not an option investigate the possibility of increasing the heap size for your application Talk to your systems support people for advice on how to do this Message 1002 error deallocation failure in comms_module gt gcheck_vector DL_POLY_4 has failed to deallocate an array or arrays i e to free memory that is no longer in use Action Talk to your systems support people for advice on how to manage this Message 1003 error allocation failure in comms_module gt gisum_vector Action See Message 1001 284 STFC Appendix D Message 1004 error Action See Message 1002 Message 1005 error Action See Message 1001 Message 1006 error Action See Message 1002 Message 1007 error Action See Message 1001 Message 1008 error Action See Message 1002 Message 1009 error Action See Message 1001 Message 1010 error Action See Message 1002 Message 1011 error Action See M
151. ONFIG file DL_POLY 4 has detected that the atom indices in the CONFIG file do not form a contnual and or non repeating group of indices Action Make sure the CONFIG file is complies with the DL_POLY_4 standards You may use the no index option in the CONTROL file to override the crystalographic sites reading from the CONFIG file from reading by index to reading by order of the atom entries with consecutive incremental indexing Using this option assumes that the FIELD topology description matches the crystalographic sites atoms entries in the CONFIG file by order consecutively Message 30 error too many chemical bonds specified This should never happen This error most likely arises when the FIELD file or and DL_POLY 4 executable are corrupted Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 31 error too many chemical bonds per domain DL_POLY 4 limits the number of chemical bond units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to increase mxbond alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 32 error coincidence of particles in core shell unit DL_POLY 4 has found a fault in the definition of a core shell unit in the FIELD file The same
152. ORT The long ranged corrections are calculated by METAL_LRC Reading and generation of EAM table data from TABEAM is handled by METAL_TABLE_READ and METAL TABLE DERIVATIVES Notes on the Treatment of Alloys The distinction to be made between EAM and FS potentials with regard to alloys concerns the mixing rules for unlike interactions Starting with equations 2 109 and 2 110 it is clear that we require mixing rules for terms Vj rij and pij rij when atoms i and j are of different kinds Thus two different metals A and B we can distinguish 4 possible variants of each VigA rig gt vp rij vg rig gt Vig ris 38 STFC Section 2 3 and ey rig PEP rig GP rig PBA rig These forms recognise that the contribution of a type A atom to the potential of a type B atom may be different from the contribution of a type B atom to the potential of a type A atom In both EAM 60 and FS 15 cases it turns out that Ve m W ms 2 147 though the mixing rules are different in each case beware This has the following implications to densities of mixtures for different potential frameworks e EAM case it is required that 60 pu riz pe rij pig ris Pg ly 2 148 which means that an atom of type A contributes the same density to the environment of an atom of type B as it does to an atom of type A and vice versa e EEAM case all densities can be different 52 53 m rig Fr rig Z 0G rig F P
153. OUTPUT W_REPLAY_HISTORY W_REPLAY_HISTORF DL_POLY e VV specific files in the source VV directory PSEUDO_VV CONSTRAINTS_SHAKE_VV PMF_SHAKE_VV CONSTRAINTS_RATTLE PMF_RATTLE NVT_HO_SCL NVT_GO_SCL NPT_HO_SCL NST_HO_SCL NVE_O_VV NVT_EO_VV NVT_LO_VV NVT_AO_VV NVT_BO_VV NVT_HO_VV NVT_GO_VV NPT_LO_VV NPT_BO_VV NPT_HO_VV NPT_MO_VV NST_LO_VV NST_BO_VV NST_HO_VV NST_MO_VV NVT_H1_SCL NVT_G1_SCL NPT_H1_SCL NST_H1_SCL NVE_1_VV NVT_E1_VV NVT_L1_VV NVT_A1_VV NVT_B1_VV NVT_H1_VV NVT_G1_VV NPT_L1_VV NPT_B1_VV NPT_H1_VV NPT_M1_VvV NST_L1_VV NST_B1_VV NST_H1_VV NST_M1_VV W_AT_START_VV W_INTEGRATE_VV W_MD_VV e LFV specific files in the source LFV directory PSEUDO_LFV CONSTRAINTS_SHAKE_LFV PMF_SHAKE_LFV NVE_O_LFV NVT_EO_LFV NVT_LO_LFV NVT_AO_LFV NVT_BO_LFV NVT_HO_LFV NVT_GO_LFV NPT_LO_LFV NPT_BO_LFV NPT_HO_LFV NPT_MO_LFV NST_LO_LFV NST_BO_LFV NST_HO_LFV NST_MO_LFV NVT_L1_LFV NVT_A1_LFV NVT_B1_LFV NVT_H1_LFV NVT_G1_LFV NPT_L1_LFV NPT_B1_LFV NPT_H1_LFV NPT_M1_LFV NST_L1_LFV NST_B1_LFV NST_H1_LFV NST_M1_LFV W_AT_START_LFV W_INTEGRATE_LFV W_MD_LFV e SERIAL specific files in the source SERIAL directory MPIF H MPI_MODULE EWALD_SPME_FORC S The files in each group are listed in hierarchal order as closely as possible The further down the list the file the more dependent it is on the files listed above it The same hierarchal order is followed in the makefiles see Appendix C 188 STFC Section 7 2 It is worth noting
154. Pmass Pmass a t Pes V t 1 2Erm t 1 J 3 116 Tr nt 540 a u t 1 r t At exp nl z At r t At v t sat u t exp ut TAi i 78 STFC Section 3 5 Similarly for the LFV couched algorithms these are n t sat exp xp t At n t a t Pext V t 1 2Egin t 1 Rp t At Pmass f Pmass Pmass 1 1 1 1 o a cale H FA s X F n 5 2 scalev 1 3 117 A scale At scale f v t At scale_v v t At scale f FH RY 1 1 1 r t At e r t At u t 5At n 300 x t 540 It is worth noting DL_POLY_4 uses Taylor expansion truncated to the quadratic term to approximate exponentials of tensorial terms This ensemble is optionally extending to constant normal pressure and constant surface area NP AT 72 by semi isotropic constraining of the barostat equation of motion to Al a Pasito V t oe XpNzx t H Pozz a B Z 3 118 dt 0 Magl0 0 a B 2 Similarly this ensemble is optionally extending to constant normal pressure and constant surface tension NP yYT 72 by semi isotropic constraining of the barostat equation of motion to Caa t Pext Yext hz t V t 2Ekin t R an d Pmass Pmass Xolaa F Fesat i a B 2 y de osto 3 119 dt af A V t fit Xplzz t Rozali W a b y 0 nap 0 0 E oe aie where Yext is the user defined external surface tension and h t
155. REE_BODY_MODULE FOUR_BODY_MODULE RDF_MODULE Z_DENSITY_MODULE CORE_SHELL_MODULE CONSTRAINTS_MODULE PMF_MODULE RIGID_BODIES_MODULE TETHERS_MODULE BONDS_MODULE ANGLES_MODULE DIHEDRALS_MODULE INVERSIONS_MODULE EXTERNAL_FIELD MODULE LANGEVIN_MODULE MINIMISE_MODULE EWALD_MODULE MSD_MODULE STATISTICS_MODULE GREENKUBO_MODULE KINETIC_MODULE GPFA_MODULE PARALLEL_FFT 186 STFC Section 7 2 e general files in the source directory WARNING ERROR SCAN_CONTROL_IO NUMERIC_CONTAINER SPME_CONTAINER QUATERNIONS_CONTAINER SCAN_FIELD SCAN_CONTROL_PRE READ_CONFIG_PARALLEL SCAN_CONFIG SCAN_CONTROL READ_CONFIG SET_BOUNDS READ_CONTROL VDW_GENERATE VDW_TABLE_READ VDW_DIRECT_FS_GENERATE METAL_GENERATE METAL_TABLE READ METAL_TABLE_DERIVATIVES TERSOFF_GENERATE DIHEDRALS_14_CHECK READ_FIELD CHECK_CONFIG ORIGIN_CONFIG SCALE_CONFIG WRITE_CONFIG TRAJECTORY_WRITE SYSTEM_EXPAND RIGID_BODIES_TAGS RIGID BODIES_COMS RIGID_BODIES_WIDTHS RIGID_BODIES_SETUP INIT_INTRA TAG_LEGEND REPORT_TOPOLOGY PASS_SHARED_UNITS BUILD_BOOK_INTRA BUILD_EXCL_INTRA SCALE_TEMPERATURE UPDATE_SHARED_UNITS CORE_SHELL_QUENCH CONSTRAINTS_TAGS CONSTRAINTS_QUENCH PMF_COMS PMF_TAGS PMF_VCOMS PMF_QUENCH RIGID_BODIES_QUENCH SET_TEMPERATURE VDW_LRC METAL_LRC SYSTEM_INIT VNL_CHECK EXPORT_ATOMIC_DATA SET_HALO_PARTICLES EXPORT_ATOMIC_POSITIONS REFRESH_HALO_POSITIONS RIGID_BODIES_STRESS READ_HISTORY DEFECTS_REFERENCE_READ DEFECTS_REFERENCE_READ_PARALLEL DEFECTS_REFERENCE_WRITE D
156. REVOLD file unreadable by the code 6 1 6 The TABLE File The TABLE file provides an alternative way of reading in the short range potentials in tabular form This is particularly useful if an analytical form of the potential does not exist or is too complicated to specify in the VDW_GENERATE subroutine The table file is read by the subroutine VDW_TABLE_READ see Chapter 7 The option of using tabulated potentials is specified in the FIELD file see above The specific potentials that are to be tabulated are indicated by the use of the tab keyword on the record defining the short range potential see Table 6 12 160 STFC Section 6 1 6 1 6 1 The TABLE File Format The file is free formatted but blank and commented lines are not allowed 6 1 6 2 Definitions of Variables record 1 header a100 file header record 2 delpot real mesh resolution in delpot a cutpot real cutoff used to define tables in A ngrid integer number of grid points in tables The subsequent records define each tabulated potential in turn in the order indicated by the specification in the FIELD file Each potential is defined by a header record and a set of data records with the potential and force tables header record atom 1 a8 first atom type atom 2 a8 second atom type potential data records number of data records Int ngrid 3 4 data 1 real data item 1 data 2 real data item 2 data 3 real data item 3 data 4 real data item 4 force
157. SQUISH both contained within QUATERNION_CONTAINER The LFV implementation begins by integrating the angular velocity equation in the local frame lt a t Atl a t 3 190 The new quaternions are found using the FIQA algorithm In this algorithm the new quaternions are found by solving the implicit equation g t At g t Q la t BE Q g t Ad BE AL 3 191 where 0 amp and Qfq is 1 mn z Q E q1 go 43 q2 3 192 The above equation is solved iteratively with q t At q t At Qla t w t 3 193 as the first guess Typically no more than 3 or 4 iterations are needed for convergence At each step the normalisation constraint q t At 1 3 194 is imposed While all the above is enough to build LFV implementations the VV implementations based on the NOSQUISH algorithm of Miller et al 25 also require treatment of the quaternion momenta as defined by Po d q q 3 0 Lo P s da a za Wg 3 195 p2 qd 8 qo 41 Ly Uy P3 q3 42 q1 go Izz Wz and quaternion torques as defined by Yo qo q 4 43 0 Y F 1 92 4 q3 q Ta 3 196 Ya da do q Ty T3 d 2 QN Q Ta It should be noted that vectors p and Y are 4 component vectors The quaternion momenta are first updated a half step using the formula At At p t y p t X t 3 197 93 STFC Section 3 6 Next a sequence of operations is applied to the quaternions and the quaternion mom
158. STFC Appendix C ewald_spme_force o comms_module o config_module o domains_module o ewald_module o kinds_f90 o setup_module o exchange_grid o comms_module o domains_module o kinds_f90 o setup_module o export_atomic_data o comms_module o config_module o domains_module o kinds_f90 0 setup_module o export_atomic_positions o comms_module o config_module o domains_module o kinds_f90 0 setup_module o external_field_apply o comms_module o config_module o core_shell_module o external_field_module o kinds_f90 o kinetic_module o rigid_bodies_module o setup_module o external_field_correct o comms_module o config_module o external_field_module o kinds_f90 o rigid_bodies_module o external_field_module o kinds_f90 o setup_module o four_body_forces o comms_module o config_module o domains_module o four_body_module o kinds_f90 o setup_module o four_body_module o kinds_f90 o setup_module o gpfa_module o kinds_f90 0 greenkubo_module o kinds_f90 o setup_module o impact o comms_module o config_module o core_shell_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o init_intra o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o inversions_module o kinds_f90 o pmf_module o rigid_bodies_module o setup_module o tethers_module o intra_coul o kinds_f90 o setup_module o inversions_compute o comms_module o config_module o inversions_module o k
159. Section 3 5 3 5 5 Martyna Tuckerman Klein Barostat DL_POLY_4 includes the Martyna Tuckerman Klein MTK interpretation of the VV flavoured Nos Hoover algorithms 32 for isotropic and anisotropic cell fluctuations in which the equations of motion are only slightly augmented with respect to those for the coupled Nos Hoover thermostat and barostat Compare the isotropic cell changes case equations 3 140 to Sx vO n 100 Su LD xo 1 3 nto uto Lle z 2Ekin t Preso CY 20 kp Text dmass 20 TH 3 163 Pmass f 3 kp Text th CH 10 50 EVO Bl VE and the anisotropic cell change case equations 3 155 to d CO ANO Tr nt fy EO Oto k JA d 2Ekin t Pmass Tr n t n t 20 3 kp Let ax 7 dmass dmass 20 TA 3 164 a oO Pow V t Enlt 1 ql 7 Pmass S Pmass x n Pmass F 3 kp Test T SHO nO He SV Ten VO The changes include one extra dependence to the velocity and barostat equations and removal of the centre of mass variable R t dependence in the position equation The modifications in for the VV couched algorithms are of the following sort nt At E mt At av 20 Fes p 32Exin 0 _1 Pmass f Pmass v t exp 5 n t 4 TAi gt v t 3 165 1 r t At exp nt At At 88 1 r t At u t At STFC Section 3 5 for the isotropic cell fluctuations case and 1 t At 4 i 4 Pmass f Pmass IIS 0
160. Section 6 1 exclude finish impactij E xyz integrator string io read method j k le io write method rp type kl e k2 is the maximum k vector index in y direction k3 is the maximum k vector index in z direction switch on extended coulombic exclusion affecting intra molecular interactions such as chemical bonds and bond angles as well as bond constraints between ions that have shells and cores close the CONTROL file last data record initiate impact on the particle with index i i gt 1 at timestep j i gt 0 with energy E E gt 0 in kilo eV and direction vector x y z from the Cartesian origin centre of the MD box defaults i 1 9 0 E 027 1 y 1 z 1 set the type of Verlet integrator where string can only be leapfrog or velocity as the later is the default set the general I O read interface to method mpiio for MPI I O direct for parallel direct access FORTRAN I O or master for traditional master I O or netcdf for netCDF I O provided DL_POLY 4 is compiled in a netCDF enabled mode default mpiio j reader count 1 lt j lt job size default j 9Int Log Min job size 2 job size Log 2 is the designated number of processes to carry out I O read operations simultaneously NOTE that k is not applicable for the master method k batch size 1 lt k lt 10 000 000 default 2 000 000 is the maximum number of particle entities in a batch i e multiples of species indez r v f
161. TFC Appendix C setup_module o metal_1d_compute o comms_module o config_module o kinds_f90 o metal_module o setup_module o metal_ld_export o comms_module o domains_module o kinds_f90 o metal_module o setup_module o metal_1d_set_halo o comms_module o config_module o setup_module o metal_lrc o comms_module o config_module o kinds_f90 o metal_module o setup_module o site_module o metal_module o kinds_f90 o setup_module o metal_table_derivatives o kinds_f90 o setup_module o metal_table_read o comms_module o kinds_f90 o metal_module o parse_module o setup_module o site_module o minimise_module o kinds_f90 o setup_module o minimise_relax o comms_module o config_module o kinds_f90 0 minimise_module o parse_module o rigid_bodies_module o setup_module o msd_write o comms_module o config_module o io_module o kinds_f90 o0 parse_module o setup_module o site_module o statistics_module o netcdf_module o kinds_f90 o0 netcdf_modul o kinds_f90 0 npt_b0_1fv o comms_module o config_module o kinds_f90 o kinetic_module o A setup_module o site_module o npt_b0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o npt_bi_lfv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o setup_module o site_module o npt_b1_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_m
162. THE DL POLY4 USER MANUAL I T Todorov amp W Smith STFC Daresbury Laboratory Daresbury Warrington WA4 4AD Cheshire England United Kingdom Version 4 06 1 September 2014 STFC Preface ABOUT DL_POLY 4 DL_POLY_4 is a general purpose parallel molecular dynamics simulation package developed at Daresbury Laboratory by W Smith and I T Todorov The DL POLY project was developed under the auspices of the Engineering and Physical Sciences Research Council EPSRC for the EPSRC s Collaborative Compu tational Project for the Computer Simulation of Condensed Phases CCP5 the Computational Chemistry and Advanced Research Computing Groups CCG amp ARCG at Daresbury Laboratory and the Natural Environment Research Council NERC for the NERC s eScience project Computational Chemistry in the Environment eMinerals directed by M T Dove DL_POLY 4 is the property of Daresbury Laboratory and is issued free under licence to academic institu tions pursuing scientific research of a non commercial nature Commercial organisations may be permitted a licence to use the package after negotiation with the owners Daresbury Laboratory is the sole centre for distribution of the package Under no account is it to be redistributed to third parties without consent of the owners The purpose of the DL POLY_4 package is to provide software for academic research that is inexpensive accessible and free of commercial considerations Users have direc
163. The transfer buffer has been exceeded Action Consider increasing parameter mxbfsh in SET_BOUNDS recompile and resubmit Contact DL_POLY_4 au thors if the problem persists Message 116 error incorrect atom transfer in update_shared_units An atom has become misplaced during transfer between nodes Action This happens when the simulation is very numerically unstable Consider carefully the physical grounds of your simulation i e are you using the adiabatic shell model for accounting polarisation with too big a timestep or too large control distances for the variable timestep is the ensemble type NPT or NoT and the system target temperature too close to the melting temperature Message 118 error construction error in pass_shared_units This should not happen Action Report to authors Message 120 error invalid determinant in matrix inversion DL_POLY_4 occasionally needs to calculate matrix inverses usually the inverse of the matrix of cell vectors which is of size 3 x 3 For safety s sake a check on the determinant is made to prevent inadvertent use of a singular matrix Action Locate the incorrect matrix and fix it e g are cell vectors correct 263 STFC Appendix D Message 122 error FIELD file not found DL_POLY 4 failed to find a FIELD file in your directory Action Supply a valid FIELD file before you start a simulation Message 124 error CONFIG file not found DL_POLY_4 failed t
164. Theory Comput 5 3211 197 302 Index DL_POLY_4 software licence 10 algorithm 5 58 118 FIQA 5 93 NOSQUISH 5 93 RATTLE 5 61 62 179 183 278 SHAKE 5 60 62 179 183 261 Verlet 5 29 58 62 181 183 Verlet neighbour list 181 AMBER 4 12 113 angular momentum 91 angular restraints 19 barostat 5 94 123 124 273 Berendsen 80 Nos Hoover 82 88 boundary conditions 4 45 198 cubic 141 CCP5 3 9 constraints bond 3 5 13 60 62 63 90 91 145 171 180 181 183 251 256 261 278 Gaussian 49 63 PMF 13 63 145 171 180 direct Coulomb sum 45 47 122 136 distance dependant dielectric 47 48 123 136 distance restraints 15 dlpoly2 5 Dreiding 12 ensemble 5 270 Andersen NVT 5 60 132 Berendsen NoT 5 60 124 132 133 Berendsen NPT 5 60 123 132 133 Berendsen NVT 5 60 123 132 133 canonical 63 Evans NVT 5 60 123 132 133 Gentle Stochastic NV T 60 123 Langevin NoT 5 60 124 132 133 Langevin NPT 5 60 123 132 133 Langevin NVT 5 60 123 132 133 Martyna Tuckerman Klein NoT 132 Martyna Tuckerman Klein NoT 5 60 124 133 Martyna Tuckerman Klein NPT 5 60 124 132 133 microcanonical see ensemble NVE Nos Hoover NoT 5 60 124 132 133 Nos Hoover NPT 5 60 123 132 133 Nos Hoover NVT 5 60 123 132 133 NVE 5 60 63 123 132 133 equations of motion Euler 55 92 rigid body 92 error messages 116 245 Ewald optimis
165. This means that the HISTORY file is incomplete in some way Either should you abort the replay HIS TORY option or provide a fresh HISTORY file before restart Action In CONTROL specify properties for recalculation RDFs z density profiles defect detection or alternatively remove the option Message 590 error uknown minimisation type only force energy and distance are recognised Configuration minimisation can take only these three criteria Action In CONTROL specify the criterion you like followed by the needed arguments Message 600 error impact option specified more than once in CONTROL Only one instance of the impact option is allowed in CONTROL Action Remove any extra instances of the impact option in CONTROL Message 610 error impact applied on particle that is either frozen or the shell of a core shell unit or part of a RB It is the user s responsibility to ensure that impact is initiated on a valid particle Action In CONTROL remove the impact directive or correct the particle identity in it so that it complies with the requirements 281 STFC Appendix D Message 620 error duplicate or mixed intra molecular entries specified in FIELD The FIELD parser has detected an inconsistency in the description of bonding interactions It is the user s responsibility to ensure that no duplicate or mixed up intra molecular entries are specified in FIELD
166. _COMPUTE Similarly Z density distributions may be calculated by using the routines Z DENSITY_COLLECT and Z DENSITY_COMPUTE while velocity autocorre lation functions may be calculated using the routines VAF_COLLECT and VAF_COMPUTE Ordinary ther modynamic quantities are calculated by the routine STATISTICS_COLLECT which also writes the STATIS file Section 6 2 13 Routine TRAJECTORY_WRITE writes the HISTORY Section 6 2 1 file for later post mortem analysis Routine DEFECTS_WRITE writes the DEFECTS Section 6 2 3 file for later postmortem analysis Routine MSD_WRITE writes the MSDTMP Section 6 2 2 file for later postmortem analysis Rou tine RSD_WRITE writes the RSDDAT Section 6 2 4 file for later postmortem analysis Job termination is handled by the routine STATISTICS_RESULT which writes the final summaries in the OUTPUT file and dumps the restart files REVIVE and REVCON Sections 6 2 8 and 6 2 7 respectively 5 2 Compiling and Running DL POLY 4 5 2 1 Compiling the Source Code When you have obtained DL_POLY_4 from Daresbury Laboratory and unpacked it your next task will be to compile it To aid compilation three general makefiles have been provided in the sub directory build These are Makefile MPI for compiling a parallel version of DL POLY_4 and Makefile SRL1 and Makefile SRL2 for compiling a serial versions see Appendix C After choosing what the default compilation is to be the appropriate makefil
167. _f90 0 scale_temperature o comms_module o config_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o scan_config o comms_module o io_module o kinds_f90 o parse_module o setup_module o scan_control o comms_module o development_module o greenkubo_module o kim_modul o kinds_f90 o msd_module o parse_module o setup_module o scan_control_io o comms_module o io_module o kinds_f90 o parse_module o setup_module o scan_control_pre o comms_module o kinds_f90 o parse_module o setup_module o scan_field o angles_module o bonds_module o comms_module o 221 STFC Appendix C dihedrals_module o inversions_module o kim_modul o kinds_f90 0 metal_module o parse_module o setup_module o tersoff_module o vdw_module o set_bounds o bonds_module o comms_module o config_module o development_module o domains_module o greenkubo_module o kinds_f90 0 msd_module o setup_module o tersoff_module o vnl_module o set_halo_particles o config_module o domains_module o kinds_f90 0 setup_module o site_module o set_temperature o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o setup_module o kinds_f90 0 site_module o kinds_f90 o setup_module o spme_container o comms_module o kinds_f90 o setup_module o statistics_collect o comms_module o config_module o kinds_f90 o msd_module o setup_module o site_module o statistics_module o st
168. _quench o pmf_coms o pmf_tags o pmf_vcoms o pmf_quench o rigid_bodies_quench o set_temperature o vdw_lrc o metal_lrc o system_init o vnl_check o export_atomic_data o set_halo_particles o export_atomic_positions o refresh_halo_positions o rigid_bodies_stress o read_history o defects_reference_read o defects_reference_read_parallel o defects_reference_write o defects_reference_export o defects_reference_set_halo o defects_link_cells o defectsi_write o defects_write o msd_write o rsd_write o vaf_write o impact o core_shell_on_top o deport_atomic_data o pmf_units_set o compress_book_intra o relocate_particles o link_cell_pairs o metal_1d_collect_eam o metal_1d_collect_fst o metal_ld_export o metal_ld_set_halo o metal_ld_compute o exchange_grid o ewald_spme_forces o metal_forces o vdw_forces o ewald_real_forces o coul_dddp_forces o coul_cp_forces o coul_fscp_forces o coul_rfp_forces o rdf_collect o rdf_excl_collect o rdf_frzn_collect o ewald_excl_forces o ewald_frzn_forces o two_body_forces o tersoff_forces o three_body_forces o four_body_forces o core_shell_forces o tethers_forces o intra_coul o bonds_forces o angles_forces o dihedrals_14_vdw o dihedrals_forces o inversions_forces o external_field_apply o external_field_correct o langevin_forces o constraints_pseudo_bonds o pmf_pseudo_bonds o rigid_bodies_split_torque o rigid_bodies_move o minimise_relax o core_shel
169. _sc1 f90 nvt_gi_scl f90 npt_h1_sc1 f90 nst_hi_scl f90 nve_1_vv f90 nvt_el_vv f90 nvt_11_vv f90 nvt_al_vv f90 nvt_b1_vv f90 nvt_h1_vv f90 nvt_gi_vv f90 npt_11_vv f90 npt_b1_vv f90 npt_h1_vv f90 npt_mi_vv f90 nst_11_vv f90 nst_b1_vv f90 nst_h1_vv f90 nst_m1_vv f90 w_at_start_vv f90 w_integrate_vv f90 w_md_vv f90 Define LeapFrog Verlet files FILES_LFV pseudo_lfv f90 constraints_shake_lfv f90 pmf_shake_lfv f90 nve_0_lfv f90 nvt_e0_lfv f90 nvt_10_1fv f90 nvt_a0_1fv f90 nvt_b0_1fv f90 nvt_h0_1fv f90 nvt_g0_1fv f90 npt_10_1fv f90 npt_b0_1fv f90 npt_h0_1fv f90 npt_m0_1fv f90 nst_10_1fv f90 nst_b0_1fv f90 nst_h0_1fv f90 nst_m0_1fv f90 nve_1_lfv f90 nvt_e1_lfv f90 nvt_11_1fv f90 nvt_al_1fv f90 nvt_b1_lfv f90 nvt_h1_1fv f90 nvt_g1_1fv f90 npt_11_1fv f90 npt_b1_1fv f90 npt_h1_1fv f90 npt_m1_1fv f90 nst_11_1fv f90 nst_b1_1fv f90 nst_h1_1fv f90 nst_m1_1fv f90 w_at_start_lfv f90 w_integrate_lfv f90 w_md_1fv f90 Examine targets manually f all echo echo You MUST specify or choose a permissive target platform echo echo The available permissive targets are displayed below echo echo hpc lake newton dirac franklin echo hpcx hpcx debug BGL BGP echo archer archer pgi debug echo archer gnu archer gnu debug echo archer cray archer cray debug echo archer pathscale
170. able variable variable variable variable variable variable variable variable variable variable variable variable variable variable max number of related core shell units 1 1 max number of specified bond constraints in system max number of constraint bonds per a node max number of related constraint units 6 1 max number of shared particles per node mxshl mxcons mxlrgd mxrgd Max 2 2 n number of neighbour nodes in DD hypercube 26 max number of specified particles in a PMF unit 1 2 max number of PMF constraints per a node max number of related PMF units 1 1 max number of types RB units max number of RB units per node max number of constituent particles of an RB unit max number of related RB units 1 1 max number of specified tethered potentials in system max number of tethered atoms per node max number of related tether units 1 1 max number of parameters for tethered potentials 3 max number of specified chemical bond potentials in system max number of chemical bonds per node max number of related chemical bonds 1 6 6 1 2 max number of parameters for chemical bond potentials 4 max number of grid points in chemical bond pot arrays gt 1004 max number of specified bond angle potentials in system max number of bond angles per node max number of related bond angles 1 6 6 1 2 max number of parameters for bond angle potentials 6 max number of grid points in bond angle pot
171. actions bonds bending angles dihedral and inversion angles in a polymer differs from that of the TABLE file and assumes three columns abscissa distance in A or angle in degrees and two ordinates potential and force data virial for distance dependent interactions e g bonds and force for angle dependent interactions e g angles Shown below are examples of TABBND and TABANG files corresponding to the above PDF examples Note that the PMF and force data have been resampled onto a finer grid with points located at bin edges userChost more TABBND TITLE Hexane FA OPLSAA gt CG mapped with 3 beads A B A 5 0 500 FAB 1 00000e 02 9 0906600e 02 1 3954000e 00 2 00000e 02 9 1046200e 02 2 7908000e 00 3 00000e 02 9 1185700e 02 4 1862000e 00 userChost more TABANG TITLE Hexane FA OPLSAA gt CG mapped with 3 beads A B A 1000 ABA 1 80000e 01 8 8720627e 01 6 9119576e 01 3 60000e 01 8 8596227e 01 6 9119227e 01 5 40000e 01 8 8471827e 01 6 9118704e 01 The input tables for bonds angles dihedrals and inversions are named TABBND TABANG TABDIH and TABINV correspondingly The format of these files is fixed in terms of the line or record order In particular the initial two header lines must contain a title and a record with the grid specification and each of the following blocks of tabulated data must be preceded by an empty line and a one line descriptor record containing the white space delimited names of
172. actions beyond distance Min reut limit 2 are discarded whereas interactions at distances shorter than limit 1 will cause the simulation to abort For the purpose of extrapolating the embedding functions F p beyond its limit 2 specified in the tabulated array it is assumed that F p gt limit 2 F p limit 2 6 14 The simulation will however abort if any local density is less than the limit 1 for its corresponding embed ding function It is worth noting that in the 2BEAM and 2BEEAM the s band contribution is usually only for the alloy component so that local concentrations of a single element revert to the standard EAM or EEAM In such case the densities functions must be zeroed in the DL_POLY_4 TABEAM file A convenient way to do this for example will be data record of the type SDEN Atom1 Atomi 1 0 1 0 6 1 8 The TABBND TABANG TABDIH TABINV Files DL_POLY_4 allows the specification of tabulated data for intramolecular interactions e TABBND for chemical bonds potentials distance dependent e TABANG for bond angles potentials angle dependent e TABDIH for dihedrals torsional potentials angle dependent e TABINV for inversions potentials angle dependent The files have the same formatting rules with examples shown in Section 4 3 Refer to Section 4 1 for their derivation and usage in coarse grained model systems 6 1 8 1 Definitions of Variables record 1 header al00 file header record 2 163 ST
173. actions modules VDW_MODULE METAL_MODULE TERSOFF_MODULE THREE_BODY_MODULE FOUR_BODY_MODULE The intermolecular modules define all variables and potential arrays needed for the calculation of the particular interaction in the DL_POLY_4 scope They depend on KINDSs_F90 Their allocation methods depend on SETUP_MODULE e intra molecular interactions and site related modules RDF_MODULE Z_DENSITY_MODULE CORE_SHELL_MODULE CONSTRAINTS_MODULE PMF_MODULE RIGID_BODIES_MODULE TETHERS_MODULE BONDS_MODULE ANGLES_MODULE DIHEDRALS_MODULE INVERSIONS_MODULE These modules define all variables and potential or statistical grid arrays needed for the calculation of the particular interaction or distribution function in the DL POLY_4 scope They all depend on KINDS_F90 with allocation methods depending on SETUP_MODULE e external field module EXTERNAL_FIELD MODULE This module defines all variables and potential arrays needed for the application of an external field in the DL_POLY_4 scope It depends on KINDS_F90 and its allocation method on SETUP_MODULE 185 STFC Section 7 2 e langevin module LANGEVIN_MODULE This module defines all variables and arrays needed for the application of NPT and NaT Langevin rou tines in the DL_POLY 4 scope It depends on KINDS_F90 and its allocation method on SETUP_MODULE e minimise module MINIMISE_MODULE This module defines all variables and arrays needed for the application of a Conjugate Gradient Method minimi
174. al angle potential with an equilibrium angle of 35 264 The angle is defined by vectors r12 ro3 and r34 where the atoms 1 2 3 and 4 are shown in the following figure The figure defines the D and L enantiomers consistent with the international IUPAC convention When defining the dihedral the atom indices are entered in DL_POLY_4 in the order 1 2 3 4 In DL_POLY_4 improper dihedral forces are handled by the routine DIHEDRALS_FORCES 21 STFC Section 2 2 L a N C f D a C N f 1 2 3 4 1 2 3 4 Figure 2 4 The L and D enantiomers and defining vectors 2 2 7 Inversion Angle Potentials Figure 2 5 The inversion angle and associated vectors The inversion angle potentials describe the interaction arising from a particular geometry of three atoms around a central atom The best known example of this is the arrangement of hydrogen atoms around nitrogen in ammonia to form a trigonal pyramid The hydrogens can flip like an inverting umbrella to an alternative structure which in this case is identical but in principle causes a change in chirality The force restraining the ammonia to one structure can be described as an inversion potential though it is usually augmented by valence angle potentials also The inversion angle is defined in the figure above note that the inversion angle potential is a sum of the three possible inversion angle terms It resembles a dihedral potential in that it requires the specification of four atomi
175. allel architectures In such circumstances the OUTPUT may be empty or incomplete despite being clear that the actual simulation has progressed well beyond what has been printed in OUTPUT Ultimately this is due to OS s I O buffers not being flushed as a default by the particular OS when certain kind of errors occurs especially MPI related The safest way to avoid loss of information in such circumstances is to write the OUTPUT data to the default output channel the screen There is an easy 107 STFC Section 5 2 way to do this in DL_POLY_4 which is to use the l scr keyword in the CONTROL file The batch daemon will then place the output in the standard output file which can then be of use to the user or alternatively on many batch systems the output can be redirected into another file allowing an easier following of the job progress over time This latter technique is also useful on interactive systems where simply printing to the screen could lead to large amounts of output However such situations could be easily avoided by redirecting the output using the gt symbol for instance mpirun n 4 DLPOLY Z gt OUTPUT It is also worth noting that the use of large batch and buffer numbers can speed up enormously the perfor mance of the parallel I O for example putting in CONTROL see Section 6 1 1 io read mpiio 128 10000000 1000000 io write mpiio 512 10000000 1000000 at large processor count jobs over 1000 Howe
176. als iones a a a a a Bee BR ES 13 22 2 Distance Restraints 25 24 4424 2 9 na E ee EE sa He 15 22 3 Valence Angle Potentials ses vacs aa a iori e dee ee ed E Pad a ees 15 224A Angular Restraints s sa a dons a eeina daa a EE ES 18 2 2 5 Dihedral Angle Potentials oe lt o ce seacht isere rad pa naa eras pa ENa 19 2 2 6 Improper Dihedral Angle Potentials oaoa aa a 21 2 2 7 Inversion Angle Potentials eoc c odada i aaa a E ee 22 2 2 8 The Caleit Four Body Potential os s s s e a aora ae RRR Ee eS 24 2209 Tetera Forces 2a tonara e aa ee E a ee A Poe a ad 26 2 3 The Intermolecular Potential Functions aooaa a a 26 2 3 1 Short Ranged van der Waals Potentials lt 2 ooo lt k4 26 23 2 Metal Potentials xap dtg as ea a ee a oe Be A eh ee 30 2 3 9 Tersoff Potentials o c sa dese de eee ea el ea bbe bee ee Ges 40 2 3 4 Three Body Potentials lt sa eeo e aaa o e e 43 23 0 Four Body Potentials soa ss eo eed a a A Pe es 44 2 4 Long Ranged Electrostatic coulombic Potentials o 45 24 1 Direct Coulomb Sum oa lt sass w ecc ai 45 2 4 2 Force Shifted Coulomb Sum asa asai e ee 46 2 4 3 Coulomb Sum with Distance Dependent Dielectric 47 244A Reaction Field 2248464 paos ponda a SRS ERE Lee REP a a aa a a Bs 48 2 4 5 Smoothed Particle Mesh Ewald 0 0002 eee eee eee 49 2 0 Polarisation Shell Models a ss 22240 2008000800 Pe Eee RE a
177. als where its shape and dimension is commensurate with the unit cell of the crystal Thus for a unit cell specified by three principal vectors a b c the MD cell is defined in the DL_POLY_4 CONFIG file by the vectors 199 STFC Appendix A La La2 Laz3 Mb1 Mb2 Mbs Nc1 Nc2 Nc3 in which L M N are integers reflecting the multiplication of the unit cell in each principal direction Note that the atomic coordinate origin is the centre of the MD cell Slab boundary conditions imcon 6 Slab boundaries are periodic in the X and Y directions but not in the Z direction They are particularly useful for simulating surfaces The periodic cell in the XY plane can be any parallelogram The origin of the X Y atomic coordinates lies on an axis perpendicular to the centre of the parallelogram The origin of the Z coordinate is where the user specifies it However it is recommended that it is in the middle of the slab Domain decomposition division across Z axis is limited to 2 If the XY parallelogram is defined by vectors A and B the vectors required in the CONFIG file are A A2 0 Bi B2 0 0 0 D where D is any real number including zero If D is nonzero it will be used by DL_POLY to help determine a working volume for the system This is needed to help calculate RDFs etc The working value of D is in fact taken as one of 3xcutoff or 2xmax abs Z coordinate cutoff or the user specified D whichever is the larger The
178. an U ijkn A 1 cos ijkn 2 188 44 STFC Section 2 4 These functions are identical to those appearing in the intra molecular inversion angle descriptions above There are significant differences in implementation however arising from the fact that the four body po tentials are regarded as inter molecular Firstly the atoms involved are defined by atom types not specific indices Secondly there are no excluded atoms arising from the four body terms The inclusion of other potentials for example pair potentials may in fact be essential to maintain the structure of the system The four body potentials are very short ranged typically of order 3 A This property plus the fact that four body potentials scale as N4 where N is the number of particles makes it essential that these terms are calculated by the link cell method 62 The calculation of the forces virial and stress tensor described in the section on inversion angle potentials above DL_POLY_4 applies no long ranged corrections to the four body potentials The four body forces are calculated by the routine FOUR_BODY_FORCES 2 4 Long Ranged Electrostatic coulombic Potentials DL_POLY_4 incorporates several techniques for dealing with long ranged electrostatic potentials These are as follows 1 Direct Coulomb sum 2 Force shifted Coulomb sum 3 Coulomb sum with distance dependent dielectric 4 Reaction field 5 Smoothed Particle Mesh Ewald SPME
179. angles_compute o dihedrals_compute o inversions_compute o statistics_result o dl_poly o Define MPI SERIAL files FILES_SERIAL mpi_module f90 mpif h Define Velocity Verlet files FILES VV pseudo_vv f90 constraints_shake_vv f90 pmf_shake_vv f90 constraints_rattle f90 pmf_rattle f90 nvt_h0_sc1 f90 nvt_g0_scl f90 npt_h0_sc1 f90 nst_h0_sc1 f90 nve_0_vv f90 nvt_e0_vv f90 nvt_10_vv f90 nvt_a0_vv f90 nvt_b0_vv f90 nvt_h0_vv f90 nvt_g0_vv f90 npt_10_vv f90 npt_b0_vv f90 npt_h0_vv f90 npt_m0_vv f90 nst_10_vv f90 nst_b0_vv f90 nst_h0_vv f90 nst_m0_vv f90 nvt_hi_scl f90 nvt_g1_sc1 f90 npt_h1_sc1 f90 nst_h1_sc1 f90 241 STFC Appendix C nve_1_vv f90 nvt_el_vv f90 nvt_11_vv f90 nvt_al_vv f90 nvt_b1_vv f90 nvt_h1_vv f90 nvt_gi_vv f90 npt_11_vv f90 npt_b1_vv f90 npt_h1_vv f90 npt_mi_vv f90 nst_11_vv f90 nst_b1_vv f90 nst_h1_vv f90 nst_m1_vv f90 w_at_start_vv f90 w_integrate_vv f90 w_md_vv f90 Define LeapFrog Verlet files FILES_LFV pseudo_lfv f90 constraints_shake_lfv f90 pmf_shake_lfv f90 nve_O_lfv f90 nvt_e0_lfv f90 nvt_10_1fv f90 nvt_a0_1fv f90 nvt_bO_lfv f90 nvt_h0_1fv f90 nvt_g0_1fv f90 npt_10_1fv f90 npt_b0_1fv f90 npt_h0_1fv f90 npt_m0_1fv f90 nst_10_1fv f90 nst_b0_1fv f90 nst_h0_1fv f90 nst_m0_1fv f90 nve_1_lfv f90 nvt_e1_lfv f90 nvt_11_1fv f90 nvt_al_1fv f90 nvt_b1_lfv f90 nvt_h1_1fv f90 nvt_g1_1fv f90 npt_11_1fv f90 npt_b1_1fv f90 npt_h1_1fv f90 npt_m1_1f
180. aphic listing to FIELD topology on IO when io mpio direct sorted is selected etc ii abort display of warnings non leading to error messages and of iteration cycles in minimisation relaxation routines iii assume safe defaults for the general simulation cutoff and its padding temperature pressure and job times skip detailed topology reporting during read of FIELD in OUTPUT no FIELD replication useful for large bio chemcal simulations ignore time averaging of velocity autocorrelation functions VAFs report all calculated VAF profiles for individual species to VAFDAT files and final profile for all species in OUTPUT ignore short range non bonded interactions in simulation ignore Centre of Mass momentum removal during the simulation minimise the system configuration at start during equilibration using conjugate gradient method CGM with respect to the criterion string and tolerance f where the criterion can only be force 1 lt f lt 1000 default f 50 or energy 0 lt f lt 0 01 default f 0 005 or distance maximum absolute displacement in A 107 lt f lt 0 1 default f 0 005 the CGM minimised configuration is saved in a file CFGMIN which has the same format as CONFIG set optional padding to the major cutoff Tout to f A f gt Min 0 05 0 5 rcut default f 0 set required system pressure to f katms target pressure for constant pressure ensembles print system data every n timesteps
181. are described in greater detail in the DL_POLY Classic User Manual Many of these have been incorporated into the DL_POLY GUI 21 and may be conveniently used from there 5 3 1 Inorganic Materials The utility GENLAT can be used to construct the CONFIG file for relatively simple lattice structures Input is interactive The FIELD file for such systems are normally small and can be constructed by hand Otherwise the input of force field data for crystalline systems is particularly simple if no angular forces are required notable exceptions to this are zeolites and silicate glasses see below Such systems require only the specification of the atomic types and the necessary pair forces The reader is referred to the description of the DL_POLY 4 FIELD file for further details Section 6 1 3 DL_POLY 4 can simulate zeolites and silicate or other glasses Both these materials require the use of angular forces to describe the local structure correctly In both cases the angular terms are included as three body terms the forms of which are described in Chapter 2 These terms are entered into the FIELD file with the pair potentials An alternative way of handling zeolites is to treat the zeolite framework as a kind of macromolecule see below Specifying all this is tedious and is best done computationally what is required is to determine the nearest image neighbours of all atoms and assign appropriate bond and valence angle potentials What must b
182. are two versions of this potential available in DL_POLY_4 ters and kihs In these particular implementations ters has 11 atomic and 2 bi atomic parameters whereas kihs 61 has 16 atomic parameters The energy is modelled as a sum of pair like interactions where the coefficient of the attractive term in the pair like potential which plays the role of a bond order depends on the local environment giving a many body potential The form of the Tersoff potential is ters Uij folrij Fr rig vig Falrig gt 2 155 where fr and f are the repulsive and attractive pair potential respectively fr riz Aig exp aij rij falrij Bij exp biz rij 2 156 and fc is a smooth cutoff function with parameters R and S so chosen that to include the first neighbor shell e ters 1 Tij lt Rij ij Rij folri 5 4 cos x e Rij lt Tij lt Sij 2 157 0 Tij gt Sij e kihs here fc is modified to a have continuous second order differential 1 Tij lt Rij ig Rij ig Rij ict 5 E cos x a h cos 37 Rij lt Tij lt Sij 2 158 0 iG gt Siz ij expresses a dependence that can accentuate or diminish the attractive force relative to the repulsive force according to the local environment such that e ters ES Yi Xij 14807 LG gt Lij ha Folrix wik 9 0i5x 2 159 k i j c2 c2 glij 1 3 4 d 2 d hi cos 6 54 40 STFC Section 2 3 e kihs vis M
183. are zero if the atom is not bonded 3 Each processor passes a copy of the array to the neighbouring processors which manage the domains in contact with its own The receiving processor compares the incoming list with its own and keeps a record of the shared atoms and the processors which share them 4 In the first stage of the algorithms the atoms are updated through the usual Verlet algorithm without regard to the bond constraints 5 In the second iterative stage of the algorithms each processor calculates the incremental correction vectors for the bonded atoms in its own list of bond constraints It then sends specific correction vectors to all neighbours that share the same atoms using the information compiled in step 3 6 When all necessary correction vectors have been received and added the positions of the constrained atoms are corrected 7 Steps 5 and 6 are repeated until the bond constraints are converged 8 Finally the change in the atom positions from the previous time step is used to calculate the atomic velocities The compilation of the list of constrained atoms on each processor and the circulation of the list items 1 3 above is done at the start of the simulation but thereafter it needs only to be done every time a constraint bond atom is relocated from one processor to another In this respect DD SHAKE and DD RATTLE resemble every other intramolecular term Since the allocation of constraints is based purel
184. arrays gt 1004 max number of specified dihedral angle potentials in system max number of dihedral angles per node max number of related dihedral angles 1 6 2 6 6 1 2 max number of parameters for dihedral angle potentials 7 max number of grid points in dihedral angle pot arrays gt 1004 max number of specified inversion angle potentials in system max number of inversion angles per node max number of related inversion angles 1 6 6 1 4 max number of parameters for inversion angle potentials 3 max number of grid points in inversion angle pot arrays gt 1004 max number of pairwise RDF in system number of grid points for RDF and Z density arrays gt 1004 max number of grid points for ewald exclusion potential arrays max number of van der Waals potentials in system max number of van der Waals potential parameters 5 max number of grid points in vdw potential arrays gt 1004 max number of metal potentials in system max number of metal density potentials in system max number of metal extra density potentials in system max number of metal potential parameters 9 max number of grid points in metal potential arrays gt 1004 max number of Tersoff potentials in system max number of Tersoff potential parameters 11 max number of grid points in tersoff potential arrays gt 1004 191 STEC Section 7 2 mxgrid mxtana mxgana mxgbnd mxgang mxgdih mxginv mxtbp mx2tbp mxptbp mxfbp mx2fbp mx
185. ary for halo parts particles of partially shared RBs For all domains the kinetic contributions from each fully or partially present RB are evaluated in full and then waited with the ratio number of RB s sites local to the domain to total RB s sites and then globally summed The compilation of the lists in items 1 3 above and their circulation of the list is done at the start of the simulation but thereafter these need updating on a local level every time a RB site atom is relocated from one processor to another In this respect RBs topology transfer resembles every other intramolecular term Since the allocation of RBs is based purely on geometric considerations it is not practical to arrange for a strict load balancing For many systems however this deficiency has little practical impact on performance 7 2 Source Code 7 2 1 Modularisation Principles Modules in DL POLY_4 are constructed to define parameters and variables scalars and arrays and or develop methods that share much in common The division is far from arbitrary and module interdependence is reduced to minimum However some dependencies exist which leads to the following division by groups in hierarchical order e precision module KINDS_F90 The precision module defines the working precision wp of all real variables and parameters in DL_POLY _4 By default it is set to 64 bit double precision If the precision is changed the user must check whether the specific p
186. ase 27 and 28 NiAl alloy with EAM metal Potentials These systems consist of 27 648 and 221 184 atoms respectively Simulation at 300 K using NVT Evans ensemble with EAM tabulated forces and no electrostatics 8 1 15 Test Case 29 and 30 Fe with Finnis Sincair metal Potentials These systems consist of 31 250 and 250 000 atoms respectively Simulation at 300 K using NPT Berendsen ensemble with Finnis Sinclair forces and no electrostatics 8 1 16 Test Case 31 and 32 Ni with EAM metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NPT Berendsen ensemble with EAM tabulated forces and no electrostatics 8 1 17 Test Case 33 and 34 SPC IceVII water with constraints These systems consist of 11 664 34 992 atoms and 93 312 279 936 atoms water molecules respectively Simulation at 25 K using NVE ensemble with CGM force minimisation and SPME electrostatics Both constraint bond and rigid body dynamics cases are available 8 1 18 Test Case 35 and 36 NaCl molecules in SPC water represented as CBs RBs These systems consist of 64 512 NaCl ion pairs with 4 480 35 840 water molecules represented by constraint bonds and 4 416 35 328 water molecules represented by ridig bodies Totalling 26 816 214 528 atoms Simulation at 295 K using NPT Berendsen ensemble with CGM energy minimisation and SPME electrostatics 8 1 19 Test Case 37 and 38 TIP4P water RBs with a massless charged site
187. ass momentum is removed at the end of the integration algorithms The Berendsen algorithms conserve total momentum but not energy The VV and LFV flavours of the Berendsen thermostat are implemented in the DL POLY 4 routines NVT_BO_VV and NVT_BO_LFV respectively The routines NVT_B1_VV and NVT_B1_LFV implement the same but also incorporate RB dynamics 3 4 5 Nos Hoover Thermostat In the Nos Hoover algorithm 30 Newton s equations of motion are modified to read e u t 20 9 _ ou 3 66 The friction coefficient x is controlled by the first order differential equation dx t 2Epin t 20 3 67 dt mass where is the target thermostat energy equation 3 57 and mass 20 TA 3 68 is the thermostat mass which depends on a specified time constant Tr for temperature fluctuations normally in the range 0 5 2 ps The VV implementation of the Nos Hoover algorithm takes place in a symplectic manner as follows 1 Thermostat Note Ein t changes inside At 2Ekin t 20 x t At t x t 4 mass 1 At i e aw exp x t 5 At 3 69 1 1 At 2Egn t 20 x t 4 At x t4 74 a ae 3 70 2 VVI 1 At f t u t At u t T m 1 r t At r t At v t 54At 3 71 70 STFC Section 3 4 3 RATTLE_VV1 4 FF f t At E f t 3 72 5 VV2 i MET v t At v t At n E 3 73 6 RATTLE_VV2 7 Thermostat Note Exin t At changes inside At
188. asses of the original atomic sites The PMF bondlength applies to the distance between the centres of the two PMF units The centre Ri of each unit is given by Ni gt Deja U5 T ay BeA wj gt where r is a site position and w the site weighting 6 7 Note that the PMF constraint is intramolecular To define a constraint between two molecules the molecules must be described as part of the same DL_POLY_4 molecule DL_POLY_4 allows only one 145 STFC Section 6 1 type of PMF constraint per system The value of nummols for this molecule determines the number of PMF constraint in the system Note that in DL_POLY_4 PMF constraints are handeled in every available ensemble 7 rigid n where n is the number of basic rigid units in the molecule It is followed by at least n records each specifying the sites in a rigid unit m integer number of sites in rigid unit site 1 integer first site atomic index site 2 integer second site atomic index site 3 integer third site atomic index k z etc site m integer m th site atomic index Up to 15 sites can be specified on the first record Additional records can be used if necessary Up to 16 sites are specified per record thereafter This directive and associated data records need not be specified if the molecule contains no rigid units See the note on the atomic indices appearing under the shell directive above 8 teth n where n is the number of tethered atoms in the
189. ate_vdw_table_arrays in vdw_module gt allocate_vdw_direct_fs_arrays in metal_module gt allocate_metal_table_arrays in ewald_module gt ewald_allocate_kfrz_arrays in bonds_module allocate_bond_pot_arrays in bonds_module allocate_bond_dst_arrays in angles_module allocate_angl_pot_arrays in angles_module allocate_angl_dst_arrays in dihedrals_module allocate_dihd_pot_arrays 291 STEC Appendix D Message 1077 error Action See Message 1001 Message 1078 error Action See Message 1001 Message 1079 error Action See Message 1001 Message 1080 error Action See Message 1001 allocation failure in dihedrals_module allocate_dihd_dst_arrays allocation failure in inversions_module allocate_invr_pot_arrays allocation failure in inversions_module allocate_invr_dst_arrays allocation failure in greenkubo_module allocate_greenkubo_arrays 292 Appendix E DL_POLY_4 README DL_POLY_4 06 The source is in fully self contained free formatted FORTRAN90 MP12 code specifically FORTRAN9O TR15581 MPI1 MPI I O only The available NetCDF functionality makes the extended code dependent upon it The non extended code complies with the NAGWare and FORCHECK F90 standards with exception of the FORTRAN2003 feature TR15581 which is very rarely unavailable in the nowadays FORTRAN90 95 compilers This version supports ALL features that ar
190. ation 114 115 SPME 50 114 124 129 136 summation 49 106 114 131 136 179 182 270 force field 4 12 13 21 113 181 247 261 278 AMBER 4 12 DL_POLY 4 12 Dreiding 4 12 43 44 GROMOS 4 12 force shifted Coulomb sum 46 129 136 FORTRANDO 6 7 105 106 245 FTP 9 GROMOS 4 12 GUL 10 112 114 141 Java GUI 4 10 licence 3 long ranged corrections metal 35 van der Waals 28 minimisation 109 conjugate gradients 109 programmed 109 zero temperature 109 parallelisation 5 104 179 Domain Decomposition 5 intramolecular terms 180 polarisation 52 53 shell model 4 12 45 52 54 56 180 254 shell models 52 303 OSTFC Index potential 2BEAM 31 bond 4 112 147 171 180 183 250 271 bonded 181 182 calcite 24 25 chemical bond 4 12 15 20 21 44 53 180 181 dihedral 4 12 19 22 148 150 171 180 255 271 EAM 30 161 EEAM 30 161 electrostatics 4 8 13 15 18 21 45 122 124 128 129 136 171 180 271 external field 4 12 54 55 180 four body 4 12 26 44 45 151 157 171 180 248 259 270 272 improper dihedral 4 12 21 180 intermolecular 105 intramolecular 26 45 105 inversion 4 12 22 24 44 45 150 180 257 272 metal 4 13 26 30 105 106 151 180 182 260 non bonded 4 13 112 113 127 143 147 149 151 180 182 247 tabulated 160 248 249 Tersoff 4 12 26 40 43 151 155 180 182 257 te
191. atistics_connect_frames o comms_module o config_module o msd_module o setup_module o statistics_module o statistics_connect_set o comms_module o config_module o domains_module o kinds_f90 o msd_module o setup_module o statistics_module o statistics_connect_spread o comms_module o config_module o domains_module o kinds_f90 o msd_module o setup_module o statistics_module o statistics_module o comms_module o kinds_f90 o setup_module o statistics_result o angles_module o bonds_module o comms_module o config_module o core_shell_module o dihedrals_module o greenkubo_module o inversions_module o kinds_f90 o minimise_module o msd_module o rdf_module o setup_module o site_module o statistics_module o vnl_module o z_density_module o system_expand o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o inversions_module o io_module o kinds_f90 0 parse_module o rigid_bodies_module o setup_module o site_module o system_expan o comms_module o config_module o io_module o kinds_f90 0 parse_module o setup_module o site_module o system_init o angles_module o bonds_module o comms_module o config_module o development_module o dihedrals_module o greenkubo_module o inversions_module o kinds_f90 o metal_module o rdf_module o setup_module o site_module o statistics_module o vdw_module o z_density_module o system_revive o angles_module o bonds_module o comms_module o
192. authors Message 172 error duplicate intra molecular entries specified in TABBND TABANG TABDIH T A duplicate entry has been encountered in the intramolecular table file Action Contact DL_POLY 4 authors Message 200 error rdf z density buffer array too small in system_revive This error indicates that a global summation buffer array in subroutine SYSTEM_REVIVE is too small i e mxbuff lt mxgrdf This should never happen Action Contact DL_POLY_4 authors Message 210 error only one angles directive per molecule is allowed DL_POLY_4 has found more than one angles entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 220 error only one dihedrals directive per molecule is allowed DL_POLY_4 has found more than one dihedrals entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 230 error only one inversions directive per molecule is allowed DL_POLY_4 has found more than one inversions entry per molecule in FIELD 266 STFC Appendix D Action Correct the erroneous part in FIELD and resubmit Message 240 error only one tethers directive per molecule is allowed DL_POLY_4 has found more than one tethers entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 300 error incorrect boundary condition for link cell algorithms The use of link cells in DL POLY_4 imp
193. body Nsites ao i 3 177 j l and the torque vector 7 acting on the body in the universal frame of reference is given by Nsites pd dos 3 178 j 1 where is the force on a rigid unit site A rigid body also has associated with it a rotational inertia matrix I whose components are given by Nsites 1 Y midias d r 3 179 j l and COM stress and virial respectively written down as Nsites B a _ 0 gt aS j 1 W Y dif 3 180 1 An alternative approach is to define basic and secondary particles The basic particles are the minimum number needed to define a local body axis system The remaining particle positions are expressed in terms of the COM and the basic particles Ordinary bond constraints can then be applied to the basic particles provided the forces and torques arising from the secondary particles are transferred to the basic particles in a physically meaningful way 91 STFC Section 3 6 where d is the displacement vector of the atom j from the COM and is given by dj r R 3 181 The rigid body angular velocity w is the scalar product of the moment of inertia I inverse and the angular momentum J Galas 3 182 It is common practice in the treatment of rigid body motion to define the position R of the body in a universal frame of reference the so called laboratory or inertial frame but to describe the moment of inertia tensor in a frame of reference that is loca
194. c E Fi qu E 2 234 2 Oscillating shear oshr FE Acos 2nr z L 2 235 3 Continuous shear shrx 1 v sale z gt 20 2 236 4 Gravitational field grav Fi Fi mi G 2 237 5 Magnetic field magn F Fi qi vi x H 2 238 6 Containing sphere sphr F A Ro r ir gt Reut 2 239 7 Repulsive wall zbnd F A zo z Pp 2 gt P Zo 2 240 8 X Piston xpis Mk eee ei F P Area 1 X direction VR S ty 2 241 hai Mk 9 Harmonic restraint zone in z direction zres A Zior m n Zcom gt max 2 242 E A e Zem Zcom lt Zmin gt where Zcom is the chosen molecule centre of mass 54 STFC Section 2 7 10 Harmonic restraint zone in z direction pull out zrs A z Zmaz A 22 Smar Zmin 2 2 243 2 A Zmin 2 z lt 2max 2min 2 l 11 Harmonic restraint zone in z direction pull in zrs A z Amar zZ gt Zmaz 2 244 E A Zmin 2 2 lt iiin 12 Oscillating electric field osel Fi F qi E sin 2mwt 2 245 where t is the simulated time It is recommended that the use of an external field should be accompanied by a thermostat this does not apply to examples 6 and 7 since these are conservative fields The Oscillating shear and X piston fields may only be used with orthorhombic cell geometry imcon 1 2 and Continuous shear field with slab cell geometry imcon 6 In t
195. c g FC ftn c FCFLAGS 03 Wall pedantic g EX EX BINROOT BINROOT TYPE archer gnu debug MAKE LD ftn o LDFLAGS 03 Wall Wextra pedantic g fbounds check fbacktrace finit integer 9999 finit real nan std f2003 ffpe trap invalid zero overflow fdump core 211 STEC Appendix C FC ftn c FCFLAGS 03 Wall Wextra pedantic g fbounds check fbacktrace finit integer 9999 finit real nan std f2003 ffpe trap invalid zero overflow fdump core EX EX BINROOT BINROOT TYPE archer cray MAKE LD ftn o LDFLAGS 03 en FC ftn c FCFLAGS 03 en EX EX BINROOT BINROOT TYPE archer cray debug MAKE LD ftn o LDFLAGS 03 en G2 FC ftn c FCFLAGS 03 en G2 EX EX BINROOT BINROOT TYPE archer pathscale MAKE LD ftn o LDFLAGS byteswapio 03 FC ftn c FCFLAGS byteswapio 03 EX EX BINROOT BINROOT TYPE CRAY XT3 6 pathscale compilers DEBUG archer pathscale debug MAKE LD ftn o LDFLAGS byteswapio 00 g ffortran bounds check FC ftn c FCFLAGS byteswapio 00 g ffortran bounds check EX EX BINROOT BINROOT TYPE archer X2 MAKE LD ftn o LDFLAGS 03 Ofp3 Ocache2 rm FC ftn c FCFLAGS 03 Ofp3 Ocache2 rm EX EX BINROOT BINROOT TYPE archer X2 debug MAKE LD ft
196. c positions The potential functions available in DL_POLY_4 are as follows 22 STFC Section 2 2 1 Harmonic harm k U dijkn 5 bijkn po 2 58 2 Harmonic cosine hcos k U Pijkn 5 cos ijkn cos o 2 59 3 Planar potential plan U ijkn A 1 cos dizkn 2 60 4 Extended planar potential xpln k U diem gt 1 cos m Qijkn Po 2 61 5 Tabulated potential tab The potential is defined numerically in TABINV see Section 4 3 and Section 6 1 8 In these formulae Qijkn is the inversion angle defined by T m w Qijkn cos z2 2 62 TijWkn with and the unit vectors Un Pet li Tiel rn Wa Palla 2 64 As usual Tij Tj Ly ele and the hat f indicates a unit vector in the direction of r The total inversion potential requires the calculation of three such angles the formula being derived from the above using the cyclic permutation of the indices j gt k gt n gt j etc Equivalently the angle may be written as 9 1271 2 ij Urn ag Veen Pijkn cost f lEs thin aj Ben 2 65 Formally the force on an atom arising from the inversion potential is given by 17 ZU bin 2 66 Ore ijkn y with being one of 2 7 k n and a one of x y z This may be expanded into o 1 o zaU Pijkn F U dijkn X Or tit cot Obijkn ijen ty 0 2 1 2 o Me tn ri Den 2 67 Ore Tij 23
197. cal space and the self energy correction For molecular systems as opposed to systems comprised simply of point ions additional modifications EWALD_EXCL_FORCES are necessary to correct for the excluded intra molecular coulombic interactions In the real space sum these are simply omitted In reciprocal space however the effects of individual Gaussian charges cannot easily be extracted and the correction is made in real space It amounts to removing terms corresponding to the potential energy of an ion due to the Gaussian charge on a neighbouring charge m or vice versa This correction appears as the final term in the full Ewald formula below The distinction between the error function erf and the more usual complementary error function er fc found in the real space sum should be noted The same considerations and modifications EWALD_FRZN_FORCES are taken into account for frozen atoms which mutual coulombic interaction must be excluded The total electrostatic energy is given by the following formula 1 2 exp Meee 2 L 2 didn Us dV 5 Yo exp ik r I y er fe arnj o 0 E k20 TEQE es Tnj 2 214 1 y 3 qeq bn y rilorem m m 1 80 Amege molecules lt m va Tim 3Strictly speaking the real space sum ranges over all periodic images of the simulation cell but in the DL POLY_4 imple mentation the parameters are chosen to restrict the sum to the simulation cell and its nearest neighbours i e th
198. ccessed Possible values are mpiio in which case MPI I O is used direct which uses parallel FORTRAN direct access files and master which performs all I O through a master processor or netcdf for netCDF I O provided DL_POLY_4 is compiled in a netCDF enabled mode mpiio is the recommended method and for large systems master should be avoided Available options depend on which method is to be used and all are optional in each case Where numerical values are to be supplied specifying 0 or a negative numbers indicates that DL_POLY_4 will resort to the default value The possible options are e io read mpiio direct netcdf j k l e j specifies the number of processors that shall access the disk k specifies the maximum number of particles that the reading processors shall deal with at any one time Large values give good performance but may results in an unacceptable memory overhead l specifies the maximum number of particles that the reading processors shall read from the disk in one I O transaction Large values give good performance but may results in an unacceptable memory overhead e accepts Yes only to switch global error checking performed by the I O subsystem the default is No io read master I l specifies the maximum number of particles that the reading process shall read from the disk in one I O transaction Large values give good performance but may results in an unacceptable memory overhead b io write method rp type
199. ccessfully then a freshly date stamped file named DLPOLY Z should appear in the listing of the execute subdirectory the 1s haltr command issued on a Linux Unix like shell within execute will place the executable in the last row of the list If unsuccessful then you should read the Compiling and Running DL POLY_4 Section 5 2 1 To run the code you first need to place the necessary input files within execute TEST cases containing suitable input files as well as examples of output files can be obtained at the DL_POLY_4 FTP site ftp ftp dl ac uk cep5 DL_POLY Examine the contents of data README txt and bench README txt for more information To run the serial version you simply issue the command DLPOLY Z or DLPOLY Z cu within the execute subdirectory If you have compiled a parallel version and are running it on a parallel machine then naturally you will need to familiarise yourself with the local procedures of how to run jobs on that machine In general though running a parallel job will usually require that you issue a necessary run command e g mpirun n 8 DLPOLY Z or submit a job script from within execute If you need to know more then search the manual and examine sections of interests You may also wish to visit DL_POLY project web page http www ccp5 ac uk DL_POLY and examine the useful links within FAQ User Forum etc If you are looking to gain more in depth experience then regular training workshops are available To find
200. cessor computer The files are stored in compressed format The test cases can be run by typing select n from the execute directory where n is the number of the test case The select macro will copy the appropriate CONTROL CONFIG and FIELD files to the execute directory ready for execution The output file OUTPUT may be compared with the file supplied in the data directory It should be noted that the potentials and the simulation conditions used in the following test cases are chosen to demonstrate a limited set of relevant functionality over a limited extent of molecular systems complexity only They are not necessarily appropriate for serious simulation of the test systems In other words the tests are not warranted to have well defined force field in terms of applicability transferability and fullness as well as to have a well defined state point thus initial configurations may be away from equilibrium if physical at all 8 1 1 Test Case 1 and 2 Sodium Chloride These are a 27 000 and 216 000 ion systems respectively with unit electric charges on sodium and chlorine Simulation at 500 K with a NVT Berendsen ensemble The SPME method is used to calculate the Coulombic interactions 8 1 2 Test Case 3 and 4 DPMC in Water These systems consist of 200 and 1 600 DMPC molecules in 9379 and 75032 water molecules respectively Simulation at 300 K using NVE ensemble with SPME and RATTLE algorithm for the constrained motion Total system siz
201. cs simulation It is the routine that first opens the OUTPUT file Section 6 2 which provides the summary of the job The root program calls the molecular dynamics cycle routines LFV MD_LFv or LEV mD_vv implementing the VV and LFV depending on which integrator has been specified for the simulation These routines contain major routines required to perform the simulation control the normal molecular dynamics cycle and monitor the cpu and memory usage They also bring about a controlled termination of the program if the cpu usage approaches the allotted job time within a pre set closure time and or if the memory usage approaches the allocated limit for density dependent arrays Users are recommended to study the aforementioned root directories as a model for other implementations of the package they may wish to construct The dependencies and calling hierarchies of all the DL_POLY_4 subroutines can be found in Section 7 2 2 Should additional functionality be added to DL_POLY_4 by the user the SET_BOUNDS routine and its support subroutines may need modifying to allow specification of the dimensions of any new arrays Any molecular dynamics simulation performs five different kinds of operation initialisation forces calcu lation integration of the equations of motion calculation of system properties and job termination It is worth considering these operations in turn and to indicate which DL_POLY 4 routines are available to perform th
202. ctions are identical to those appearing in the intra molecular valence angle descriptions above There are significant differences in implementation however arising from the fact that the three body potentials are regarded as inter molecular Firstly the atoms involved are defined by atom types not specific indices Secondly there are no excluded atoms arising from the three body terms The inclusion of other potentials for example pair potentials may in fact be essential to maintain the structure of the system The three body potentials are very short ranged typically of order 3 This property plus the fact that three body potentials scale as N4 where N is the number of particles makes it essential that these terms are calculated by the link cell method 62 The calculation of the forces virial and stress tensor as described in the section valence angle potentials above DL POLY 4 applies no long ranged corrections to the three body potentials The three body forces are calculated by the routine THREE_BODY_FORCES 2 3 5 Four Body Potentials The four body potentials in DL_POLY_4 are entirely inversion angle forms primarily included to permit sim ulation of amorphous materials particularly borate glasses The potential forms available in DL POLY 4 are as follows 1 Harmonic harm U dijkn Dijen bo 2 186 2 Harmonic cosine hcos U Sisk 5 C08 dijkn cos d0 Y 2 187 3 Planar potential pl
203. ctively and recompile However it is unlikely that such measures will cure the problem as it is more likely to lay in the physical description of the system being simulated For example are the core shell spring constants well defined Is the system being too far from equilibrium Message 476 error shells MUST all HAVE either zero or non zero masses The polarisation of ions is accounted via a core shell model as the shell dynamics is either relaxed shells have no mass or adiabatic all shells have non zero mass Action 274 STFC Appendix D Choose which model you would like to use in the simulated system and adapt the shell masses in FIELD to comply with your choice Message 478 error shake algorithms constraints amp pmf failed to converge Your system has both bond and PMF constraints SHAKE RATTLE_VV1 is done by combined application of both bond and PMF constraints SHAKE RATTLE_VV1 in an iterative manner until the PMF constraint virial converges to a constant No such convergence is achieved Action See Message 515 Message 480 error PMF constraint length gt minimum of all half cell widths The specified PMF length has exceeded the minimum of all half cell widths Action Specify shorter PMF length or increase MD cell dimensions Message 484 error only one potential of mean force permitted Only one potential of mean force is permitted in FIELD Action Correct the erroneous entries in
204. cute EX DLPOLY Z EXE BINROOT EX TYPE master FC undefined LD undef ined Define object files OBJ_MOD kinds_f90 o comms_module o setup_module o parse_module o development_module o netcdf_modul o io_module o domains_module o site_module o config_module o vnl_module o defects_module o defects1_module o vdw_module o metal_module o tersoff_module o three_body_module o four_body_module o kim_modul o rdf_module o z_density_module o core_shell_module o constraints_module o pmf_module o rigid_bodies_module o tethers_module o bonds_module o angles_module o dihedrals_module o inversions_module o external_field_module o langevin_module o minimise_module o ewald_module o msd_module o statistics_module o greenkubo_module o kinetic_module o gpfa_module o parallel_fft o OBJ_ALL warning o error o scan_control_io o numeric_container o spme_container o quaternions_container o scan_field o scan_control_pre o read_config_parallel o scan_config o scan_control o read_config o 224 STFC Appendix C set_bounds o read_control o bonds_table_read o angles_table_read o dihedrals_table_read o inversions_table_read o vdw_generate o vdw_table_read o vdw_direct_fs_generate o metal_generate o metal_table_read o metal_table_derivatives o tersoff_generate o dihedrals_14_check o read_field o check_config o origin_config o scale_config o write_config o traject
205. d t 6424 2 ela daiwa bE ew ae ed 80 3 0 4 Nos Hoover Barostat gt eas ecce a w eaaa SEER Da sl ER SAR Ea 82 3 5 5 Martyna Tuckerman Klein Barostat e 88 3 6 Rigid Bodies and Rotational Integration Algorithms 90 36 1 Description of Rigid Body Units 2 sect 4 casa dc la 90 3 6 2 Integration of the Rigid Body Equations of Motion 92 3 6 3 Thermostats and Barostats coupling to the Rigid Body Equations of Motion 94 4 Coarse Graining Functionality 96 4 1 User Defined Coarse Grain Models with Tabulated Force Fields 97 4 2 Intramolecular Probability Distribution Function PDF Analysis 97 4 3 Setting up Tabulated Intramolecular Force Field Files o 100 5 Construction and Execution 102 5 1 Constructing DL_POLY_4 an Overview ee 103 5 1 1 Constructing the Standard Versions sooo 103 bile Constructing Non standard Versions sssr e foe k eos A SRAM Yo 104 52 Compiling and Riinning DLPOLY A sacana ead e aa e d a be 4 oe Dhaene beeen 105 D21 Compiling the Source Gade Se sa s se m oe BE eee aa ee ee ae ed 105 STFC Contents O22 RUI 2 cited rs Gg Oh Sas e Se SG ESE a 107 e Weare sg ek ee ee eee ee ee Se SEE ASS Be ee Se ee be 107 O24 Restarting 0 bdo 4 uaa se Be PA ee e A ek 108 5 2 5 Optimising the Starting Structure lt lt i ea i eccna ee 109 5 2 6 Simulation Efficiency and Performance
206. d and adiabatic shell model MgO These systems consist of 8 000 4 000 shells and 64 000 32 000 shells atoms respectively Simulation at 3000 K using NPT Berendsen ensemble with SPME FIELD and CONTROL files for each shell model are provided separately 8 1 9 Test Case 17 and 18 Potential of mean force on K in water MgO These systems consist of 13 500 500 PMFs and 53 248 2 048 PMFs atoms respectively Simulation at 300 K using NPT Berendsen ensemble with SPME and SHAKE RATTLE algorithm for the constrained motion 8 1 10 Test Case 19 and 20 CuzAu alloy with Gupta metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NVT Nos Hoover ensemble with Gupta forces and no electrostatics 8 1 11 Test Case 21 and 22 Cu with EAM metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NPT Berendsen ensemble with EAM tabulated forces and no electrostatics 8 1 12 Test Case 23 and 24 Al with Sutton Chen metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NVT Evans ensemble with Sutton Chen forces and no electrostatics 195 STFC Section 8 1 8 1 13 Test Case 25 and 26 Al with EAM metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NVT Evans ensemble with EAM tabulated forces and no electrostatics 8 1 14 Test C
207. d barostat relaxation times in ps and set required simulation target external surface tension to y dyn cm nst Q fifo tens y semi select the same NP yT ensemble as above but with the semi anisotropic constraint so that the MD cell changes isotropically in the x y plane nst Q fi f2 orthorhombic select the NPT anisotropic ensemble for the orthorhombic nst Q fi fo orth semi epsilon constant f equilibration steps n ewald evaluate every n ewald precision f ewald sum a k ka k3 MD cell orthorhombic constraint equivalent to the NP yT ensemble when y 0 NP y OT select the same NP y OT ensemble as above but with the semi anisotropic constraint so that the MD cell changes isotropically in the x y plane semi orthorhombic constraint equivalent to the NP y OT semi ensemble set relative dielectric constant to f default f 1 0 equilibrate system for the first n timesteps default n 0 evaluate the k space contributions to the Ewald sum once every n timesteps 1 lt n lt 10 activated when n gt 2 n lt lor undefined defaults ton 1 n gt 10 defaults ton 4 calculate electrostatic forces using Ewald sum with automatic parameter optimisation for precission f 1072 lt f lt 0 5 default f 100 calculate electrostatic forces using Ewald sum with a Ewald convergence parameter in A k1 is the maximum k vector index in x direction 124 STFC
208. d by another potential specification 147 STFC Section 6 1 10 angles n 11 12 where n is the number of valence angle bonds in the molecule Each of the n records following contains angle key ad potential key see Table 6 9 index 1 i integer first atomic site index index 2 j integer second atomic site index central site index 3 k integer third atomic site index variable 1 real potential parameter see Table 6 9 variable 2 real potential parameter see Table 6 9 variable 3 real potential parameter see Table 6 9 variable 4 real potential parameter see Table 6 9 The meaning of these variables is given in Table 6 9 This directive and associated data records need not be specified if the molecule contains no angular terms See the note on the atomic indices appearing under the shell directive above dihedrals n where n is the number of dihedral interactions present in the molecule Each of the following n records contains dihedral key ad potential key see Table 6 10 index 1 i integer first atomic site index index 2 7 integer second atomic site index central site index 3 k integer third atomic site index index 4 1 integer fourth atomic site index variable 1 real first potential parameter see Table 6 10 variable 2 real second potential parameter see Table 6 10 variable 3 real third potential parameter see Table 6 10 variable 4 real 1 4 electrostatic interaction scale factor variable 5 real 1
209. d liberally 1 36 FORTRAN9O0 Parameters and Arithmetic Precision All global parameters defined by the FORTRAN9O parameter statements are specified in the module file SETUP_MODULE which is included at compilation time in all subroutines requiring the parameters All parameters specified in SETUP MODULE are described by one or more comment cards One super global parameter is defined at compilation time in the KINDS_F90 module file specifying the working precision wp by kind for real and complex variables and parameters The default is 64 bit double precision i e Real wp Users wishing to compile the code with quadruple precision must ensure that their architecture and FORTRAN90 compiler can allow that and then change the default in KINDS_F90 Changing the precision to anything else that is allowed by the FORTRAN90 compiler and the machine architecture must also be compliant with the MPI working precision mpi_wp as defined in COMMS_MODULE in such cases users must correct for that in there 1 3 7 Units Internally all DL_POLY_4 subroutines and functions assume the use of the following defined molecular units e The unit of time to is 1 x 10 seconds i e picoseconds e The unit of length lo is 1 x 107 metres i e Angstroms e The unit of mass mo is 1 6605402 x 1072 kilograms i e Daltons atomic mass units e The unit of charge qo is 1 60217733 x 107 Coulombs i e electrons units of proton charge e The unit of ene
210. d regenerate it if it appears to be incomplete If it look intact check that the number of data points specified is what DL_POLY_4 is expecting Message 25 error wrong atom type found in CONFIG file On reading the input file CONFIG DL _POLY_4 performs a check to ensure that the atoms specified in the configuration provided are compatible with the corresponding FIELD file This message results if they are not or the parallel reading wrongly assumed that CONFIG complies with the DL_POLY_3 4 style Action The possibility exists that one or both of the CONFIG or FIELD files has incorrectly specified the atoms in the system The user must locate the ambiguity using the data printed in the OUTPUT file as a guide and make the appropriate alteration If the reason is in the parallel reading then produce a new CONFIG using a serial reading and continue working with it Message 26 error neutral group option now redundant DL_POLY_4 does not have the neutral group option Action Use the Ewald sum option It s better anyway Message 27 error unit s member indexed outside molecule s site range An intra molecular or intra molecular alike interaction topological unit has member site which is given a number outside the scope of the molecule it is part of 249 STFC Appendix D Action Find the erroneous entry in FIELD correct it and try running DL_POLY_4 again Message 28 error wrongly indexed atom entries found in C
211. d using an unconstrained estimate of the velocity at full step u t Also calculated is an unconstrained estimate of the half step position r t 4At 1 FF HA FAL Rit R t At 3 109 Fig t Rt t 2 LFV The iterative part is as follows 3 At scale 1 x 1 alo f 2 2 scale v 1 scale At scale f scale f t R t v t At scale_v u t At scalef HA AD E HORE u t de 2At FEE Abr ip Ax 3 110 H t At e exp n t 340 Atl H t VELAN ep ne 50 At V t 3 SHAKE 4 Full step velocity and half step position lv t wat u t At r t At lt C AD 3 111 1 th e u t 3 E 5 Thermostat and Barostat 1 1 n t At exp xp At n t At P t At Poxt 2Epin t At 1 At av t At 3 3 112 l Pmass f Pmass 1 1 nl gE zA nlt 50 STFC Section 3 5 Several iterations are required to obtain self consistency In DL_POLY_4 the number of iterations is set to 7 8 if bond constraints are present Note also that the change in box size requires the SHAKE algorithm to be called each iteration The VV and LFV flavours of the langevin barostat and Nos Hoover thermostat are implemented in the DL_POLY_4 routines NPT_LO_vv and NPT_LO_LFV respectively Both VV and LFV implementations make use of the DL_POLY_4 module LANGEVIN_MODULE The routines NPT_L1_VV and NPT_L1_LFV implement the same but also incorporate RB dynamics
212. data records number of data records Int ngrid 3 4 data 1 real data item 1 data 2 real data item 2 data 3 real data item 3 data 4 real data item 4 6 1 6 3 Further Comments It should be noted that the number of grid points in the TABLE file should not be less than the number of grid points DL_POLY 4 is expecting This number is given by the parameter mxgvdw calculated in the SETUP_MODULE file see Section 5 2 1 3 and 7 2 8 DL POLY 4 will re interpolate the tables if delpot ne lt dlrvdw no usually when ngrid gt mxgvdw but will abort if delpot gt dlrvdw The potential and force tables are used to fill the internal arrays vvdw and gvdw respectively see Sec tion 2 3 1 The contents of force arrays are derived from the potential via the formula U r 6 13 Note this is not the same as the true force During simulation interactions beyond distance cutpot are discarded 6 1 7 The TABEAM File The TABEAM file contains the tabulated potential functions no explicit analytic form describing the EAM or EEAM metal interactions in the MD system This file is read by the subroutine METAL_TABLE_READ see Chapter 7 161 STEC Section 6 1 6 1 7 1 The TABEAM File Format The file is free formatted but blank and commented lines are not allowed 6 1 7 2 Definitions of Variables record 1 header al00 file header record 2 numpot integer number of potential functions in file For an n component a
213. ded for the compilation of DL POLY_4 and 11 places where it could be installed PATHS To facilitate the user with the construction of their own keyword entry examples are provided in the makefiles In the case when users use a makefile for DL_POLY_4 compilation in serial mode they will have to provide a valid PATH to the FORTRAN9O compiler on their specific platform 4 The makefile produces the executable version of the code which as a default will be named DLPOLY Z and located in the execute subdirectory 5 DL_POLY 4 also has a Java GUI The files for this are stored in the subdirectory java Compilation of this is simple and requires running the javac compiler and the jar utility Details for these procedures are provided in the GUI manual 21 6 To run the executable for the first time you require the files CONTROL FIELD and CONFIG and possibly TABLE if you have tabulated van der Walls potentials TABEAM if you have tabulated metal potentials and REFERENCE if defect detection is opted for These must be present in the directory from which the program is executed See Section 6 1 for the description of the input files 7 Executing the program will produce the files OUTPUT STATIS REVCON and REVIVE and op tionally HISTORY RDFDAT ZDNDAT MSDTMP REFERENCE DEFECTS in the executing directory See Section 6 2 for the description of the output files This simple procedure is enough to create a standard version to run most
214. degrees of freedom and the degrees of freedom corresponding to rotation and vibration of the unit are discounted as if the kinetic energy of these is regarded as zero equation 3 11 2 5 1 Dynamical Adiabatic Shells Shell Model The dynamical shell model is a method of incorporating polarisability into a molecular dynamics simulation The method used in DL POLY 4 is that devised by Fincham et al 67 and is known as the adiabatic shell model In the adiabatic method a fraction of the atomic mass is assigned to the shell to permit a dynamical description The fraction of mass x is chosen to ensure that the natural frequency of vibration Vcore she11 of the harmonic spring which depends on the reduced mass i e 1 k ue Vcore shell Fm Pe gt 2 232 52 STFC Section 2 5 with m the rigid ion atomic mass is well above the frequency of vibration of the whole atom in the bulk system Dynamically the core shell unit resembles a diatomic molecule with a harmonic bond however the high vibrational frequency of the bond prevents effective exchange of kinetic energy between the core shell unit and the remaining system Therefore from an initial condition in which the core shell units have negligible internal vibrational energy the units will remain close to this condition throughout the simulation This is essential if the core shell unit is to maintain a net polarisation In practice there is a slow leakage of kinetic energy into
215. description does not take into account the possible inclusion of distance dependent 1 4 interactions as permitted by some force fields Such interactions are permissible in DL_POLY_4 and are described in the section on pair potentials below DL_POLY_4 also permits scaling of the 1 4 van der Waals and Coulomb interactions by a numerical factor see Table 6 10 Note that scaling is abandoned when the 1 4 members are also 1 3 members in a valence angle intercation 1 4 checks are performed in DIHEDRALS_14_CHECK routine 1 4 interactions do of course contribute to the atomic virial In DL_POLY 4 dihedral forces are handled by the routine DIHEDRALS_FORCES and INTRA_COUL and DIHE DRALS_14_VDW called within 2 2 6 Improper Dihedral Angle Potentials Improper dihedrals are used to restrict the geometry of molecules and as such need not have a simple relation to conventional chemical bonding DL POLY_4 makes no distinction between dihedral and improper dihedral angle functions both are calculated by the same subroutines and all the comments made in the preceding section apply An important example of the use of the improper dihedral is to conserve the structure of chiral centres in molecules modelled by united atom centres For example a amino acids such as alanine CH3CH NH2 COOH in which it is common to represent the CH3 and CH groups as single centres Conservation of the chirality of the a carbon is achieved by defining a harmonic improper dihedr
216. dimension Agype will be 1 if the term represents a tether 1 2 for a core shell unit or a bond constraint unit or a bond 1 2 3 for a valence angle and 1 2 3 4 for a dihedral or an inversion 1 NpmF unit o 2 1 for a PMF constraint unit or 1 0 1 NRB unit for a rigid body unit 180 STFC Section 7 1 6 Using the key array each processor can identify the global indices of the atoms in the bond term and can use this in conjunction with the local sorted atoms list and a binary search algorithm to find the atoms in local atom list 7 Using the local atom identity the potential energy and force can be calculated It is worth mentioning that although rigid body units are not bearing any potential parameters their definition requires that their topology is distributed in the same manner as the rest of the intra molecular like interactions Note that at the start of a simulation DL POLY_4 allocates individual bonded interactions to specific processors based on the domains of the relevant atoms DL_POLY_4 routine BUILD_BOOK_INTRA This means that each processor does not have to handle every possible bond term to find those relevant to its domain Also this allocation is updated as atoms move from domain to domain i e during the relocation process that follows the integration of the equations of motion DL_POLY_4 routine RELOCATE_PARTICLES Thus the allocation of bonded terms is effectively dynamic changing in response to
217. 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 iv Contents THE DL_POLY_4 USER MANUAL a About Ib POMY A oa va 6 eck ee iaa a eee EEE RR A ee i Disclaimer lt sea soe osoo a aa 4446446885 RES e Dee EE heehee eG EEE eee eS ii Acknowledgements c o s oac Be aa a OE Bob eee a ek he ee ee 111 Manual INGGAIIOM s us y a ae ee E Ge A we ee Ae A iv Contents v List of Tables xi List of Figures xii 0 Quick Word INSTALL amp RUN 1 1 Introduction 2 Li The Di POLY Package 2 24 4406 a ai aa a das i R de boa Sete aa ai a de eee 3 12 Functionality 244244224 poo ariana ee OP Dae ad ee a Be 3 L21 Molecular Systeme s esis gm eoa eB Bs ae Gok pi poa a Re eS 3 Lo Force Field ead eet BRA a as be AeA ee ee we Re 4 1223 Boundary Conditions s s 204604 24429484 base eed ede PERG ea ee 4 1 2 4 Java Graphical User Interface sa s aaoi sosok s s anpii a Gn a a a A k ee ee 4 L25 Algorithms s s ss setu a gip E ua ee a o a a g Oe ae aD ee a a 5 1 2 6 DL POLY Classic features incompatible or unavalable in DL POLY 4 5 LS Presraminine Sil 0 boca ds ara ol a en ee o BS a a 6 1 31 Programming Language o soe erase gore a da y anede a Gap m Ew a OS 6 1 3 2 Modularisation and Intent s
218. distributes the SPME charge array over the processors in a manner that is completely commensurate with the distribution of the configuration data under the DD strategy As a consequence the FFT handles all the necessary communication implicit in a distributed SPME application The DL_POLY_4 subroutine EWALD_SPME_FORCES perfoms the bulk of the FFT operations and charge array construction while SPME_FORCES calculates the forces Other routines required to calculate the Ewald sum include EWALD_MODULE EWALD_EXCL_FORCES EWALD_FRZN_FORCES and SPME_CONTAINER 7 1 5 Metal Potentials The simulation of metals Section 2 3 2 by DL_POLY_4 makes use of density dependent potentials The dependence on the atomic density presents no difficulty however as this class of potentials can be resolved into pair contributions This permits the use of the distributed Verlet neighbour list as outlined above DL_POLY_4 implements these potentials in various subroutines with names beginning with METAL 7 1 6 Tersoff Three Body and Four Body Potentials DL_POLY_4 can calculate Tersoff three body and four body interactions Although some of these inter actions have similar terms to some intramolecular ones three body to the bond angle and four body to inversion angle these are not dealt with in the same way as the normal bonded interactions They are gen erally very short ranged and are most effectively calculated using a link cell scheme 82 No reference is made
219. due to thermostats etc It is nominally the conserved variable of the system and is not to be confused with conventional system energy which is a sum of the kinetic and configuration energies The interval for printing out these data is determined by the directive print in the CONTROL file At each time step that printout is requested the instantaneous values of the above statistical variables are given in the appropriate columns Immediately below these three lines of output the rolling averages of the same variables are also given The maximum number of time steps used to calculate the rolling averages is controlled by the directive stack in file CONTROL see above and listed as parameter mxstak in the SETUP_MODULE file see Section 7 2 2 The default value is mxstak 100 Energy Units The energy unit for the energy and virial data appearing in the OUTPUT is defined by the units directive appearing in the FIELD file System energies are therefore read in units per MD cell Pressure Units The unit of pressure is katms irrespective of what energy unit is chosen 171 STFC Section 6 2 6 2 6 7 Sample of Final Configuration The positions velocities and forces of the 20 atoms used for the sample of the initial configuration see above are given This is written by the main subroutine DL_POLY 6 2 6 8 Summary of Statistical Data This portion of the OUTPUT file is written from the subroutine STATISTICS_RESULT The number of ti
220. e 36 amoe U Ojik k Ojik 00 1 1 4 107 0jix 90 5 6 10 Ojix 90 7 0 1077 bjir 00 2 2 1078 bjir 90 2 28 14 KKY 41 kky 1 Si rr a 15 Tabulated potential tab The potential is defined numerically in TABANG see Section 4 3 and Section 6 1 8 In these formulae 6 is the angle between bond vectors r and riz Fs Pa a Ojik cos E 2 30 Tijfik In DL POLY 4 the most general form for the valence angle potentials can be written as U Ojik Tijs rik AC Sry Sr S rik 4 2 31 where A 0 is a purely angular function and S r is a screening or truncation function All the function arguments are scalars With this reduction the force on an atom derived from the valence angle potential is given by E 0 i Bre U Ojik Tij Vik T5k gt 2 32 with atomic label being one of i j k and a indicating the x y z component The derivative is 0 o grg U iik Tijs Tik Tjk Sri Sri SC gra AB rij 19 A Ojik S rik S rin Se 04 gt S rij Tij Orij rg 0 A Ojik S rij S Tjk Sek dei S rik Tik OfTik Tk A Ojik S rij S rik Gee 025 S rik 2 33 Tjk OTjk with 64 1 if a b and da 0 if a b In the absence of screening terms S r this formula reduces to o SU 841k Tij Tik Tjk o Ore AO 2 34 Q Or 17 STFC Section 2 2 The derivative of the angular functi
221. e Section 6 1 2 This contains the atom positions and depending on how the file was created e g whether this is a configuration created from scratch or the end point of another run the velocities and forces also The third file required is the FIELD file Section 6 1 3 which specifies the nature of the intermolecular interactions the molecular topology and the atomic properties such as charge and mass Sometimes you may require a fourth file TABLE Section 6 1 6 which contains short ranged potential and force arrays for functional forms not available within DL POLY 4 usually because they are too complex e g spline potentials and or a fifth file TABEAM Section 6 1 7 which contains metal potential arrays for non analytic or too complex functional forms and or a sixth file REFERENCE Section 6 1 4 which is similar to the CONFIG file and contains the perfect crystalline structure of the system Examples of input files are found in the data sub directory which can be copied into the execute subdirectory using the select macro found in the execute sub directory A successful run of DL_POLY_4 will generate several data files which appear in the execute sub directory The most obvious one is the file OUTPUT Section 6 2 6 which provides an effective summary of the job run the input information starting configuration instantaneous and rolling averaged thermodynamic data minimisation information final configurations radia
222. e 1001 Message 1041 error allocation failure in langevin_module gt langevin_allocate_arrays Action See Message 1001 Message 1042 error allocation failure in rigid_bodies_module gt allocate_rigid_bodies_arrays Action See Message 1001 Message 1043 error deallocation failure in rigid_bodies_module gt deallocate_rigid_bodies_arrays Action See Message 1002 Message 1044 error allocation failure in comms_module gt gimin_vector Action See Message 1001 Message 1045 error deallocation failure in comms_module gt gimin_vector Action See Message 1002 Message 1046 error allocation failure in comms_module gt grmin_vector Action See Message 1001 Message 1047 error deallocation failure in comms_module gt grmin_vector Action 289 STFC Appendix D See Message 1002 Message 1048 error error allocation failure in comms_module gt grsum_matrix Action See Message 1001 Message 1049 error deallocation failure in comms_module gt grsum_matrix Action See Message 1002 Message 1050 error sorted I O base communicator not set Possible corruption if IO MODULE This should never happen Action Make sure you have a clean copy of DL_POLY_4 compiled without any suspicious warning messages Contact authors if the problem persists Message 1053 error sorted I O allocation error
223. e Table 6 12 The variables pertaining to each potential are described in Table 6 12 Note that any pair potential not specified in the FIELD file will be assumed to be zero metal n where n is the number of metal potentials to be entered It is followed by n records each specifying a particular metal potential in the following manner atmnam 1 a8 first atom type atmnam 2 as second atom type key ad potential key see Table 6 13 variable 1 real potential parameter see Table 6 13 variable 2 real potential parameter see Table 6 13 variable 3 real potential parameter see Table 6 13 variable 4 real potential parameter see Table 6 13 variable 5 real potential parameter see Table 6 13 151 STFC Section 6 1 Table 6 12 Pair Potentials key potential type Variables 1 5 functional form tab Tabulation tabulated potential 12 6 126 AIB U r 42 4 lj Lennard Jones e o U r 4e 27 27 nm n m 47 48 Eo n miro U r C m 22 n 22 buck Buckingham A p Cc U r A exp 2 bhm Born Huggins A Bi aj C D U r A exp B o r amp amp Meyer hbnd 12 10 H bond AB U r 4 4 snm Shifted force Eo n ro Tet U r ones x n m 47 48 mp 2 1 nam 27 DY nmak r yro py Ba tnt US G J mors Morse Eo ro k U r Eo 1 exp k r ro 1 12 6 1 wca Shifted 49 Weeks e ot A U r 4e 5 He rij lt 25 y A Cha
224. e and resubmit Message 511 error duplicate entry for an embedding function detected in TABEAM A duplicate embedding function entry is detected in the TABEAM file Action Remove all duplicate entries in the TABEAM file and resubmit Message 513 error particle assigned to non existent domain in read_config This can only happen if particle coordinates do not match the cell parameters in CONFIG Probably due to negligence or numerical inaccuracy inaccuracy in generation of big supercell from a small one Action Make sure lattice parameters and particle coordinates marry each other Increase accuracy when generating a supercell Message 514 error allowed image conventions are 0 1 2 3 and 6 DL_POLY_4 has found unsupported boundary condition specified in CONFIG Action Correct your boundary condition or consider using DL_POLY_Classic Message 515 error rattle algorithm constraints_rattle failed to converge The RATTLE algorithm for bond constraints is iterative If the maximum number of permitted iterations is exceeded the program terminates Possible causes include incorrect force field specification too high a temperature inconsistent constraints over constraint etc Action You may try to increase the limit of iteration cycles in the constraint subroutines by using the directive mxshak and or decrease the constraint precision by using the directive shake in CONTROL But the trouble may be much more lik
225. e available in the standard DL_POLY_Classic version with the exceptions of 1 Rigid bodies RBs linked via i constraint bonds CBs or ii potential of mean field constraints PMFs 2 Truncated octahedral imcon 4 Rhombic Dodecahedral imcon 5 and Hexagonal Prism imcon 7 periodic boundary MD cell conventions PBC Note that the last one is easily convertible to orthorhombic imcon 2 see utility nfold f90 3 Classic Ewald and Hautman Klein Ewald Coulomb evaluations 4 Temperature Accelerated Dynamics Hyper Dynamics and solvation energies No previous DL_POLY_3 4 feature is deprecated ALL NEW features are documented in the DL_POLY_4 User Manual Reference Thank you for using the DL_POLY_4 package in your work Please acknowledge our efforts by including the following reference when publishing data obtained using DL_POLY_4 I T Todorov W Smith K Trachenko amp M T Dove J Mater Chem 16 20 1911 1918 2006 Warnings 1 DL_POLY_4 can produce index ordered REVCON HISTORY and MSDTMP files which are restartable by DL_POLY_Classic Although such printed outputs look unscrambled the actual printing process is not Unscrambled printing is slightly more expensive than 293 STFC Appendix E natural scrambled printing The cost time wise is little lt 1 but HD space wise is approximately 20 This is due to the necessary addition of blanks at the end of data record included to align
226. e avoided at all costs is specifying the angle potentials without specifying bond potentials In this case DL_POLY_4 will automatically cancel the non bonded forces between atoms linked via valence angles and the system will collapse The advantage of this method is that the calculation is likely to be faster than using three body forces This method is not recommended for amorphous systems 5 3 2 Macromolecules To set up force fields for macromolecules or indeed any covalent molecules it is best to use DL_FIELD http www ccp5 ac uk DL_FIELD It is a program application tool developed to facilitate the construc tion of force field models for biological molecules and other molecules with complex geometries For instance proteins carbohydrates polymers and networked molecules such as graphenes and organic cages Although created to assist DL_POLY_4 DL_FIELD is a separate program suite that requires separate registration The primary functions of DL_FIELD are as follows 1 Force field model converter DL_FIELD converts the users atom models supplied in PDB file format into input files that are recognisable and ready to run with DL_POLY Classic and DL_POLY_4 programs with minimum users intervention This basically involves the conversion of the users atomic configuration in simple xyz coordinates into identifiable atom types base on a particular user selectable potential schemes and then automatically generate the DL_POLY configuration file
227. e code for DL_POLY_4 excluding the utility software is stored In keeping with the package concept of DL POLY_4 it does not contain any complete programs these are assembled at compile time using an appropriate makefile The subroutines in this sub directory are documented in Chapter 7 1 4 2 The utility Sub directory This sub directory stores all the utility subroutines functions and programs in DL_POLY_4 together with examples of data Some of the various routines in this sub directory are documented in the DL_POLY_Classic User Manual Users who devise their own utilities are advised to store them in the utility sub directory 1 4 3 The data Sub directory This sub directory contains examples of input and output files for testing the released version of DL_POLY_4 The examples of input data are copied into the execute sub directory when a program is being tested The test cases are documented in Chapter 8 Note that these are no longer within the distribution of any DL_POLY version but are made available on line at the DL_POLY FTP ftp ftp dl ac uk cep5 DL POLY 1 4 4 The bench Sub directory This directory contains examples of input and output data for DL_POLY_4 that are suitable for benchmark ing DL_POLY_4 on large scale computers These are described in Chapter 8 Note that these are no longer within the distribution of any DL_POLY version but are made available on line at the DL_POLY FTP ftp ftp dl ac uk ccp5 DL POLY
228. e interstitial cutoff default f Min 0 75 reut 3 A Min 0 3 reut 3 lt f lt Min 3 5 Tcout 2 A DL_POLY _ Classic Verlet shell strip cutoff option is iterpreted by DL_POLY_4 as the padding rpad f 4 option so that Tpad gets set to Max pad fdetr 4 allow for local variation of f in the system density of i particles and ii any present bonded like entities very useful for extremely non equilibrium simulations default f 0 calculate electrostatic forces using Coulomb sum with distance dependent dielectric write displacements trajectory file RSDDAT with controls i start timestep for dumping displacements configurations default i 0 j timestep interval between configurations default j 1 f displacement qualifying cutoff default f 0 15 A set restart data dump interval to n steps default n 1000 select NVE ensemble default ensemble select NVEg n ensemble type Evans with Gaussian constraints thermostat select NVT ensemble type Langevin with thermostat relaxation speed friction constant f in ps select NVT ensemble type Andersen with fi f2 as the thermostat relaxation time in ps and softness 0 lt fa lt 1 select NVT ensemble type Berendsen with thermostat relaxation constant f in ps select NVT ensemble type Nose Hoover with thermostat relaxation constant f in ps select NVT ensemble type Gentle Stochastic with thermostat relaxation constant f in ps and Lang
229. e is 51737 and 413896 atoms respectively 8 1 3 Test Case 5 and 6 KNaSi O Potassium Sodium disilicate glass NaKSi205 using two and three body potentials Some of the two body potentials are read from the TABLE file Simulation at 1000 K using NVT Nos Hoover ensemble with SPME Cubic periodic boundaries are in use System size is 69120 and 552960 ions respectively 194 STFC Section 8 1 8 1 4 Test Case 7 and 8 Gramicidin A molecules in Water These systems consist of 8 and 16 gramicidin A molecules in aqueous solution 32 096 and 256 768 water molecules with total number of atoms 99 120 and 792 960 respectively Simulation at 300 K using NPT Berendsen ensemble with SPME and SHAKE RATTLE algorithm for the constrained motion 8 1 5 Test Case 9 and 10 SiC with Tersoff Potentials These systems consist of 74 088 and 343 000 atoms respectively Simulation at 300 K using NPT Nos Hoover ensemble with Tersoff forces and no electrostatics 8 1 6 Test Case 11 and 12 CuzAu alloy with Sutton Chen metal Potentials These systems consist of 32 000 and 256 000 atoms respectively Simulation at 300 K using NVT Nos Hoover ensemble with Sutton Chen forces and no electrostatics 8 1 7 Test Case 13 and 14 lipid bilayer in water These systems consist of 12 428 and 111 852 atoms respectively Simulation at 300 K using NVT Berendsen ensemble with SPME and SHAKE RATTLE algorithm for the constrained motion 8 1 8 Test Case 15 and 16 relaxe
230. e is to be copied as Makefile in the sub directory source The general DL_POLY_4 makefile will build an executable with the full range of functionality sufficient for the test cases and for most users requirements In most cases the user will have to modify few entries in the specification part of their makefile to match the location of certain software on their system architecture Note that only FORTRAN90 compiler is required for successful build of DL_POLY_4 in serial mode and only FORTRAN90 and MPI implementation for DL POLY 4 in parallel mode Should the user add additional functionality to the code major changes of the makefile may be required In UNIX environment the compilation of the program is initiated by typing the command make target where target is the specification of the required machine For many computer systems this is all that is 105 STFC Section 5 2 required to compile a working version of DL_POLY_4 To determine which targets are already defined in the makefile examine it or type the command make without a nominated target it will produce a list of known targets The full specification of the make command is as follows make lt TARGET gt lt EX gt lt BINROOT gt where some or all of the keywords may be omitted The keywords and their uses are described below Note that keywords may also be set in the UNIX environment e g with the setenv command in a TCSH shell or
231. e link cell algorithm to share the total burden of the work reasonably equally between nodes Each node is thus responsible for a unique set of non bonded interactions and the neighbour list is therefore different on each node A feature in the construction of the Verlet neighbour list for macromolecules is the concept of excluded atoms which arises from the need to exclude certain atom pairs from the overall list Which atom pairs need to be excluded is dependent on the precise nature of the force field model but as a minimum atom pairs linked via extensible bonds or constraints and atoms grouped in pairs linked via valence angles are probable candidates The assumption behind this requirement is that atoms that are formally bonded in a chemical sense should not participate in non bonded interactions However this is not a universal requirement of all force fields The same considerations are needed in dealing with charged excluded atoms The modifications necessary to handle the excluded and frozen atoms are as follows A distributed excluded atoms list is constructed by the DL_POLY_4 routine BUILD_EXCL_INTRA at the start of the simulation and is then used in conjunction with the Verlet neighbour list builder LINK_CELL_PAIRS to ensure that excluded interactions are left out of the pair force calculations Note that completely frozen pairs of atoms are excluded in the same manner The excluded atoms list is updated during the atom relocation proces
232. e lowest energy structure found during the programmed minimisation CFGMIN is written in CONFIG file format see section 6 1 2 and can be used in place of the original CONFIG file It should be noted that none of these algorithms permit the simulation cell to change shape It is only the atomic structure that is relaxed After which it is assumed that normal molecular dynamics will commence from the final structure Notes on the Minimisation Procedures 1 The zero temperature dynamics is really dynamics conducted at 10 Kelvin However the dynamics has been modified so that the velocities of the atoms are always directed along the force vectors Thus the dynamics follows the steepest descent to the local minimum From any given configuration it will always descend to the same minimum 2 The conjugate gradient procedure has been adapted to take account of the possibilities of constraint bonds and rigid bodies being present in the system If neither of these is present the conventional unadapted procedure is followed 109 STFC Section 5 2 a In the case of rigid bodies atomic forces are resolved into molecular forces and torques The torques are subsequently transformed into an equivalent set of atomic forces which are perpen dicular both to the instantaneous axis of rotation defined by the torque vector and to the cylindrical radial displacement vector of the atom from the axis These modified forces are then used in place of t
233. e minimum images of the cell contents 49 STFC Section 2 4 2 Mec f arem 1 T N y aoa in a ry oem Atreje Voa 0 where N is the number of ions in the system and N the same number discounting any excluded in tramolecular and frozen interactions M represents the number of excluded atoms in a given molecule F represents the number of frozen atoms in the MD cell V is the simulation cell volume and k is a reciprocal lattice vector defined by k lu mu nw 2 215 where m n are integers and u v w are the reciprocal space basis vectors Both V and u v w are derived from the vectors a b c defining the simulation cell Thus Vo a b x c 2 216 and Jo vu m 2 217 axb w an ab T With these definitions the Ewald formula above is applicable to general periodic systems The last term in the Ewald formula above is the Fuchs correction 65 for electrically non neutral MD cells which prevents the build up of a charged background and the introduction of extra pressure due to it In practice the convergence of the Ewald sum is controlled by three variables the real space cutoff reut the convergence parameter and the largest reciprocal space vector kmar used in the reciprocal space sum These are discussed more fully in Section 5 3 5 DL_POLY_4 can provide estimates if requested see CONTROL file description 6 1 1 As its name implies the Smoothed Particle Mesh Ewald SPME method is a m
234. e next This is done for you by the copy macro supplied in the execute directory of DL_POLY_4 6 2 8 The REVIVE File This file is unformatted and written by the subroutine SYSTEM_REVIVE It contains the accumulated sta tistical data It is updated whenever the file REVCON is updated see previous section REVIVE should be renamed REVOLD to continue a simulation from one job to the next This is done by the copy macro supplied in the execute directory of DL_POLY_4 In addition to continue a simulation from a previous job the restart keyword must be included in the CONTROL file The format of the REVIVE file is identical to the REVOLD file described in Section 6 1 5 6 2 9 The RDFDAT File This is a formatted file containing Radial Distribution Function RDF data Its contents are as follows record 1 cfgname a72 configuration name record 2 ntprdf integer number of different RDF pairs tabulated in file mxgrdf integer number of grid points for each RDF pair There follow the data for each individual RDF i e ntprdf times The data supplied are as follows first record atname 1 a8 first atom name atname 2 a8 second atom name following records mzgrdf records radius real interatomic distance A g r real RDF at given radius Note 1 The RDFDAT file is optional and appears when the print rdf option is specified in the CONTROL file Note 2 Along with the RDFDAT file two other files will be created whenever the print analysis d
235. e number of dihedral angle units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to increase mxdihd alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 62 error too many tethered atoms specified This should never happen Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 63 error too many tethered atoms per domain DL_POLY 4 limits the number of tethered atoms in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to increase mxteth alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 64 error incomplete core shell unit found in build_book_intra This should never happen Action Report problem to authors Message 65 error too many excluded pairs specified This should never happen This error arises when DL_POLY_4 is identifying the atom pairs that cannot have a pair potential between them by virtue of being chemically bonded for example see subroutine BUILD_EXCL_INTRA Some of the working arrays used in this operation may be exceeded resulting in termination of
236. e o dihedrals_module o domains_module o inversions_module o kinds_f90 0 pmf_module o rigid_bodies_module o setup_module o site_module o tethers_module o report_topology o angles_module o bonds_module o comms_module o constraints_module o core_shell_module o dihedrals_module o inversions_module o pmf_module o rigid_bodies_module o setup_module o site_module o tethers_module o rigid_bodies_coms o comms_module o config_module o kinds_f90 o0 rigid_bodies_module o setup_module o rigid_bodies_module o kinds_f90 o setup_module o rigid_bodies_move o config_module o kinds_f90 o rigid_bodies_module o setup_module o rigid_bodies_quench o comms_module o config_module o kinds_f90 0 rigid_bodies_module o setup_module o rigid_bodies_setup o comms_module o config_module o kinds_f90 o0 rigid_bodies_module o setup_module o site_module o rigid_bodies_split_torque o comms_module o config_module o kinds_f90 o rigid_bodies_module o setup_module o rigid_bodies_stress o comms_module o config_module o kinds_f90 0 rigid_bodies_module o setup_module o rigid_bodies_tags o comms_module o config_module o rigid_bodies_module o setup_module o rigid_bodies_widths o comms_module o config_module o kinds_f90 o0 A rigid_bodies_module o setup_module o rsd_write o comms_module o config_module o io_module o kinds_f90 0 parse_module o setup_module o site_module o statistics_module o scale_config o config _module o development_module o kinds
237. e o config_module o kinds_f90 o pmf_module o setup_module o pmf_module o kinds_f90 o setup_module o pmf_pseudo_bonds o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pmf_quench o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pmf_rattle o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pmf_shake_lfv o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pmf_shake_vv o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pmf_tags o config_module o kinds_f90 o pmf_module o setup_module o pmf_units_set o comms_module o config_module o pmf_module o setup_module o pmf_vcoms o comms_module o config_module o kinds_f90 o pmf_module o setup_module o pseudo_lfv o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o pseudo_vv o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o quaternions_container o comms_module o config_module o kinds_f90 0 rigid_bodies_module o setup_module o rdf_collect o config_module o kinds_f90 o rdf_module o setup_module o rdf_compute o comms_module o config_module o kinds_f90 o rdf_module o setup_module o site_module o rdf_excl_collect o config_module o kinds_f90 o rdf_module o setup_module o rdf_frzn_collect o config_module o
238. e o msd_module o statistics_module o greenkubo_module o kinetic_module o OBJ_ALL warning o error o scan_control_io o numeric_container o spme_container o quaternions_container o scan_field o scan_control_pre o read_config_parallel o scan_config o scan_control o read_config o 233 STFC Appendix C set_bounds o read_control o bonds_table_read o angles_table_read o dihedrals_table_read o inversions_table_read o vdw_generate o vdw_table_read o vdw_direct_fs_generate o metal_generate o metal_table_read o metal_table_derivatives o tersoff_generate o dihedrals_14_check o read_field o check_config o origin_config o scale_config o write_config o trajectory_write o system_expand o rigid_bodies_tags o rigid_bodies_coms o rigid_bodies_widths o rigid_bodies_setup o init_intra o tag_legend o report_topology o pass_shared_units o build_book_intra o build_excl_intra o scale_temperature o update_shared_units o core_shell_quench o constraints_tags o constraints_quench o pmf_coms o pmf_tags o pmf_vcoms o pmf_quench o rigid_bodies_quench o set_temperature o vdw_lrc o metal_lrc o system_init o vnl_check o export_atomic_data o set_halo_particles o export_atomic_positions o refresh_halo_positions o rigid_bodies_stress o read_history o defects_reference_read o defects_reference_read_parallel o defects_reference_write o defects_reference_export o defects_reference_set_halo o
239. e of user defined pair potential functions DL POLY_4 also allows the user to read in the interpolation arrays directly from a file implemented in the VOW_TABLE_READ routine and the TABLE file Section 6 1 6 This is particularly useful if the pair potential function has no simple analytical description e g spline potentials The force on an atom j derived from one of these potentials is formally calculated with the standard formula 1 5 E Vrs T 2 98 Tij rij where tHe The force on atom 7 is the negative of this The contribution to be added to the atomic virial for each pair interaction is The contribution to be added to the atomic stress tensor is given by d F 2 100 where a and indicate the x y z components The atomic stress tensor derived from the pair forces is symmetric Since the calculation of pair potentials assumes a spherical cutoff Tydw it is necessary to apply a long ranged correction to the system potential energy and virial Explicit formulae are needed for each case and are 28 STFC Section 2 3 derived as follows For two atom types a and b the correction for the potential energy is calculated via the integral NaN 2 tee 20 7c I gar r Uay r r dr gt 2 101 Tydw where Na N are the numbers of atoms of types a and b in the system V is the system volume and gab r and U r are the appropriate pair correlation function and pair potential respectively It is usual to assume Jap r
240. e previous sections Thus we need only consider the rotational motion here The rotational equation of motion for a rigid body relates the torque to the change in angular momentum d d J I si E pre i 1 w 3 186 In a thermostat it can be written as mass where 7 is the index of the rigid body x and qmass are the thermostat friction coefficient and mass In the local frame of the rigid body and without the thermostat term these simplify to the Euler s equations e p y z Lox z g gt Bi Areso A y lez Log Oz z 3 188 yy A Tz F F A A We Irr lyy r Wy Izz STFC Section 3 6 The vectors 7 and w are the torque and angular velocity acting on the body transformed to the local body frame Integration of w is complicated by the fact that as the rigid body rotates so does the local reference frame So it is necessary to integrate equations 3 188 simultaneously with an integration of the quaternions describing the orientation of the rigid body The equation describing this is do do Y9 43 0 1 O x q a ar 4 3B q We 3 189 q2 q2 43 do q Wy 43 da 2 4 We Rotational motion in DL_POLY_4 is handled by two different methods For the LFV implementation the Fincham Implicit Quaternion Algorithm FIQA is used 24 The VV implementation uses the NOSQUISH algorithm of Miller et al 25 The implementation of FIQA is coded in Q UPDATE and NOSQUSH in NO_
241. e respective intrmolecular potential see Chapter 2 The contents of force arrays for TABBND are derived from the potential via the formula U r 6 15 Note this is not the same as the true force During simulation interactions beyond distance cutpot will bring the run to a controlled termination 6 2 The OUTPUT Files DL_POLY_4 produces up to 20 kinds of output files Some of these are HISTORY DEFECTS MSDTMP CFGMIN OUTPUT REVCON REVIVE RDFDAT ZDNDAT VDFDAT_ and STATIS These respec tively contain an incremental dump file of all atomic coordinates velocities and forces an incremental dump file of atomic coordinates of defected particles interstitials and sites vacancies an incremental dump file of of individual atomic mean square displacement and temperature a dump file of all atomic coordinates of a minimised structure an incremental summary file of the simulation a restart final configuration file a restart final statistics accumulators file a radial distribution function data file Z density distribution data file velocity autocorrelation function data files one file for each species and a statistical history file 164 STFC Section 6 2 6 2 1 The HISTORY File The HISTORY file is the dump file of atomic coordinates velocities and forces Its principal use is for off line analysis The file is written by the subroutine TRAJECTORY_WRITE The control variables for this file are ltraj nstraj istra
242. e site is frozen The routines NVE_O_VV and NVE_O_LFV implement the Verlet algorithm in velocity and leapfrog flavours respectively for free particles and calculate the instantaneous temperature Whereas the routines NVE_1_VV and NVE_1_LFV implement the same for systems also containing rigid bodies The conserved quantity is the total energy of the system Hyve U Ekin gt 3 15 where U is the potential energy of the system and Ekin the kinetic energy at time t The full selection of integration algorithms indicating both VV and LFV cast integration within DL POLY_4 is as follows 59 STFC Section 3 2 NVE_0_vv NVE_0_LFV Constant E algorithm NVE_1_VV NVE_1_LFV The same as the above but also incorporating RB integration NVT_EO_vV NVT_EO_LFV Constant Egin algorithm Evans 26 NVT_El_VVv NVT_El_LFV The same as the above but also incorporating RB integration NVT_LO_VV NVT_LO_LFV Constant T algorithm Langevin 27 NVT_L1_vv NVT_L1_LFV The same as the above but also incorporating RB integration NVT_AO_VV NVT_AO_LFV Constant T algorithm Andersen 28 NVT_Al_vv NVT_A1_LFV The same as the above but also incorporating RB integration NVT_BO_VV NVT_BO_LFV Constant T algorithm Berendsen 29 NVT_B1_vv NVT_B1_LFV The same as the above but also incorporating RB integration NVT_HO_VV NVT_HO_LFV Constant T algorithm Hoover 30 NVT_H1_vv NVT_H1_LFV The same as the above but also incorporating RB integration NVT_GO_VV NVT_GO_LFV
243. ecies indez r u f etc transmitted between I O groups I O writers for global sorting purposes l buffer size 100 lt 1 lt 100 000 default 20 000 is the maximum number of ASCII line records written in a batch NOTE that e is not applicable for the master method e parallel error check Yes default N set job time to f seconds set maximum distance allowed in variable timestep control to f A default f 0 10 A enforce the direct calculation of metal interactions defined by explicit potential forms i e it will not work for metal alloy systems using the EAM EEAM 2BEAM or 2BEEAM TABEAM swich the TABEAM default of reading embedding functions F p as interpolated over densities p to as interpolated over y p ie F F yp set minimum distance allowed in variable timestep control to f A default f 0 03 A minimise the instantaneous system configuration every n steps during equilibration with respect to the last equilibration step using conjugate gradient method CGM with respect to the criterion string and tolerance f where this criterion can only be force 1 lt f lt 1000 default f 50 or energy 0 lt f lt 0 01 default f 0 005 or distance maximum absolute displacement in 1076 lt f lt 0 1 default f 0 005 the lowest string CGM minimised configuration during equilibration is saved in a file CFGMIN which has the same format as CONFIG write MSDTMP file containing particl
244. ectory is available from the CCP5 Program Library by direct FTP see below STFC Section 1 7 1 4 8 The java Sub directory The DL_POLY_4 Java Graphical User Interface GUI is based on the Java language developed by Sun The Java source code for this GUI is to be found in this sub directory The source is complete and sufficient to create a working GUI provided the user has installed the Java Development Kit 1 4 or above which is available free from Sun at http java sun com The GUI once compiled may be executed on any machine where Java is installed 21 1 5 Obtaining the Source Code To obtain a copy of DL_POLY_4 it is necessary to have internet connection Log on to the DL_POLY website http www ccp5 ac uk DL_POLY and follow the links to the DL_POLY 4 registration page where you will firstly be shown the DL_POLY_4 software licence which details the terms and conditions under which the code will be supplied By proceeding further with the registration and download process you are signalling your acceptance of the terms of this licence Click the Registration button to find the registration page where you will be invited to enter your name address and e mail address The code is supplied free of charge to academic users but commercial users will be required to purchase a software licence Once the online registration has been completed information on downloading the DL_POLY_4 source code will be sent by e mail so
245. ectostatics no vdw APPLY MIXING TO ALLOWED amp AVAILABLE VDW CROSS INTERACTIONS LorentzBerthelot Fender Halsey Hogervorst good hope Halgren HHG Tang Toennies vdw mixing Lorentz DIRECT CALCULATION OF VDW METAL INTERACTIONS INSTEAD OF EVALUATION BY SPLINING OVER TABULATED VALUES IN MEMORY vdw direct metal direct FORCE SHIFT VDW INTERACTIONS SO THAT ENERGY AND FORCE CONTRIBUTIONS FALL SMOOTHLY TO ZERO WHEN APPROACHING R_CUT vdw shift RANDOM NUMBER GENERATOR SEEDING seed 100 200 300 I O READ METHOD READER COUNT BATCH amp BUFFER SIZES io read mpiio 2 2000000 20000 I O WRITE METHOD TYPE WRITER COUNT BATCH BUFFER SIZES io write mpiio sorted 8 2000000 20000 119 OSTFC Section 6 1 SLAB SIMULATION PARALLEL CONTROL slab RESTART OPTIONS restart noscale dump 1000 steps SYSTEM TARGET TEMPERATURE AND PRESSURE temperature 300 0 Kelvin pressure 0 001 k atmospheres SYSTEM CUTOFFS AND ELECTROSTATICS recut 10 0 Angstroms rpad 0 35 Angstroms rvdw 8 0 Angstroms exclude epsilon 1 0 ewald precision 1 0e 5 ewald evaluate RELAXED SHELL MODEL TOLERANCE rlxtol 1 0 force CONSTRANTS ITERATION LENGTH and TOLERANCE mxshak 250 cycles shake 1 0e 5 INTEGRATION FLAVOUR ENSEMBLE AND PSEUDO THERMOSTAT integration velocity verlet ensemble nst hoover 0 5 0 5 pseudo langevin 2 0 150 0 INTEGRATION TIMESTEP variable timestep 0 001 pico seconds mindis 0 03 Angstrom
246. ecular species have been specified Under these circumstances it cannot assign the data correctly and therefore terminates Action Make sure the molecular data appears before the non bonded forces data in the FIELD file and resubmit Message 14 error too many unique atom types specified This should never happen This error most likely arises when the FIELD file or and DL POLY_4 executable are corrupted Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 15 error duplicate vdw potential specified In processing the FIELD file DL_POLY_4 keeps a record of the specified short range pair potentials as they are read in If it detects that a given pair potential has been specified before no attempt at a resolution of the ambiguity is made and this error message results See specification of FIELD file 247 STFC Appendix D Action Locate the duplication in the FIELD file rectify and resubmit Message 16 error strange exit from FIELD file processing This should never happen It simply means that DL POLY_4 has ceased processing the FIELD data but has not reached the end of the file or encountered a close directive Probable cause corruption of the DL_POLY 4 executable or of the FIELD file We would be interested to hear of other reasons Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us M
247. ed by n records each specifying a particular four body potential in the following manner atmnam 1 i a8 atmnam 2 j a8 atmnam 3 k a8 atmnam 4 1 a8 key ad first central atom type second atom type third atom type fourth atom type potential key see Table 6 16 156 STFC Section 6 1 variable 1 real potential parameter see Table 6 16 variable 2 real potential parameter see Table 6 16 variable 3 real cutoff range for this potential A The variables pertaining to each potential are described in Table 6 16 Note that the third variable is the range at which the four body potential is truncated The distance is in A measured from the central atom Table 6 16 Four body Potentials key potential type Variables 1 2 functional formt harm Harmonic k d0 U E 9 doy hcos Harmonic cosine k d0 U g cos cos o plan Planar A U A 1 cos ho is the 7 7 k l four body angle 6 1 3 3 External Field The presence of an external field is flagged by the directive extern The following line in the FIELD file must contain another directive indicating what type of field is to be applied followed by the field parameters in the following manner field key ad external field key see Table 6 17 variable 1 real potential parameter see Table 6 17 variable 2 real potential parameter see Table 6 17 variable 3 real potential parameter see Table 6 1
248. edrals_module o kinds_f90 0 parse_module o setup_module o site_module o dl_poly o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o development_module o dihedrals_module o external_field_module o four_body_module o greenkubo_module o inversions_module o io_module o kinds_f90 0 kinetic_module o langevin_module o metal_module o msd_module o parse_module o pmf_module o rdf_module o rigid_bodies_module o setup_module o site_module o statistics_module o tersoff_module o tethers_module o three_body_module o vdw_module o vnl_module o z_density_module o w_at_start_lfv f90 w_at_start_vv f90 w_calculate_forces f90 w_impact_option f90 w_integrate_lfv f90 w_integrate_vv f90 w_kinetic_options f90 w_md_lfv f90 w_md_vv f90 w_refresh_mappings f90 w_refresh_output f90 w_replay_historf f90 w_replay_history f90 w_statistics_report f90 w_write_options f90 domains_module o comms_module o kinds_f90 o error o comms_module o setup_module o ewald_excl_forces o config_module o ewald_module o kinds_f90 0 setup_module o ewald_frzn_forces o comms_module o config_module o ewald_module o kinds_f90 o setup_module o ewald_module o config_module o kinds_f90 o setup_module o ewald_real_forces o comms_module o config_module o kinds_f90 0 setup_module o ewald_spme_forces o comms_module o config_module o domains_module o ewald_module o kinds_f90 o parallel_fft o setup_module o 215
249. eeded to achieve convergence to zero net force 2 5 3 Breathing Shell Model Extension While for low symmetry structures the conventional dipolar rigid shell model RSM is sufficient to absorb most of the effects of partial covalency ionic polarisation for some high symmetry systems a breathing shell model BSM 70 is used as a refinement to represent the contribution of higher order charge deformations of oxide species This is done by the inclusion of non central ion interaction to account for a finite ion shell radius rf which is allowed to deform isotropically under its environment However all short range repulsion potentials i e vdw a BSM ion interacts by with its environment must act upon the radius of the ion U U r r rather than the nuclear position U U r A further constraining potential is then added to represent the self energy of the ion s breathing shell This most commonly uses the same shape as the one of the harmonic bond see Section 2 2 1 1 O U rig Hr rg 2 233 where 7 and j are the intramolecular index of the ion s core and shell respectively Hence to employ the BSM the user needs to specify an extra bonded interaction for each BSM ed core shell pair in the relevant bonds sections in the FIELD file for all molecules that contain BSM ions It is worth noting that the BSM energy and virial are thus part of the bonds energy and virial and their calculation as part of the bonds forces rou
250. el to f default f 1inD A ps act exactly the same as padding f option above set required short ranged interactions cutoff to f A rescale system temperature every n steps during equilibration with respect to the last equilibration step atomic velocities are scaled collectively seed control to the random number generator used in the generation of gaussian distributions and stochastic processes set shake rattle tolerance to f default f 107 calculate electrostatic forces using force shifted Coulomb sum calculate electrostatic forces using force shifted Coulomb sum with Fennell 63 damping Ewald like convergence parameter amp in AT calculate electrostatic forces using force shifted Coulomb sum with Fennell 63 damping Ewald like convergence derived by automatic parameter optimisation for precision f as for Ewald summation 107 lt f lt 0 5 default f 107 limits the number of processors in z direction to 2 for slab simulations act exactly the same as ewald evaluate every n act exactly the same as ewald precision f calculate electrostatic forces using Ewald sum with a Ewald convergence parameter in AW k1 is twice the maximum k vector index in x direction k2 is twice the maximum k vector index in y direction k3 is twice the maximum k vector index in z direction set rolling average stack to n timesteps accumulate statistics data every n timesteps run simulation for n timesteps default
251. ely to be cured by careful consideration of the physical system being simulated For example is the system stressed in some way Too far from equilibrium Message 517 error allowed configuration information levels are 0 1 and 2 DL_POLY 4 has found an erroneous configuration information level 0 le l le 2 i for the trajectory option in CONTROL or ii in the header of CONFIG Action Correct the error in CONFIG and rerun 278 STFC Appendix D Message 518 error control distances for variable timestep not intact DL_POLY 4 has found the control distances for the variable timestep algorithm to be in contention with each other Action mxdis MUST BE gt 2 5x mndis Correct in CONTROL and rerun Message 519 error REVOLD is incompatible or does not exist Either REVOLD does not exist or its formatting is incompatible Action Change the restart option in CONTROL and rerun Message 520 error domain decomposition failed A DL_POLY 4 check during the domain decomposition mapping has been violated The number of nodes allowed for imcon 0 is only 1 2 4 and 8 The number of nodes allowed for imcon 6 is restricted to 2 along the z direction The number of nodes should not be a prime number since these are not factoris able decomposable Action You must ensure DL_POLY_4 execution on a number of processors that complies with the advise above Message 530 error pseudo thermostat thickness MUST comply wit
252. em We do not give a detailed description but provide only a guide Readers are recommended to examine the different routines described in the DL POLY_4 User Manual for further details particularly regarding further dependencies i e additional routines that may be called The following outline assumes a system containing flexible molecules held together by rigid bonds Initialisation requires firstly that the program determine what platform resources are made available to the specific simulation job This is done by the DL_POLY 4 routine MAP_DOMAINS in DOMAINS_MODULE that attempts to allocate and map the resources nodes in parallel in compliance with the DD strategy MAP_DOMAINS is called within the routine SET BOUNDS which also sets the necessary limits for various simulation array sizes and all global variables as declared in SETUP_MODULE to convenient values based on a rough scan through the CONFIG CONTROL FIELD and optionally TABLE and TABEAM Section 6 1 files The routine also calls the READ_CONFIG routine to obtain atomic positions and optionally velocities and forces from the CONFIG file After allocation of all necessary simulation arrays and variables with compulsory initialisation to zero value the job control information is required this is obtained by the routine READ_CONTROL which reads the CONTROL file The description of the system to be simulated the types of atoms and molecules present and the intermolecular forces
253. em when the job is submitted The close time directive represents the time DL_POLY_4 will require to write and close all the data files at the end of processing This means the effective processing time limit is equal to the job time minus the close time Thus when DL_POLY_4 reaches the effective job time limit it begins the close down procedure with enough time in hand to ensure the files are correctly written In this way you may be sure the restart files etc are complete when the job terminates Note that setting the close time too small will mean the job will crash before the files have been finished If it is set too large DL_POLY_4 will begin closing down too early How large the close time needs to be to ensure safe close down is system dependent and a matter of experience It generally increases with increasing simulation system size 7 The starting options for a simulation are governed by the keyword restart If this is not specified in the control file the simulation will start as new When specified it will continue a previous simulation restart provided all needed restart files are in place and not corrupted If they are not in place or are found corrupted it will start a new simulation without initial temperature scaling of the previous configuration restart noscale Internally these options are handled by the integer variable keyres which is explained in Table 6 2 8 The various ensemble options i e nve nvt evans nvt anderse
254. em stressed in some way Too far from equilibrium Message 106 error neighbour list array too small in link_cell_pairs Construction of the Verlet neighbour list in subroutine LINK_CELL_PAIRS non bonded pair force has ex ceeded the neighbour list array dimensions 261 STFC Appendix D Action Consider using densvar option in CONTROL for extremely non equilibrium simulations or increase by hand mxlist in SET_BOUNDS Message 107 error too many pairs for rdf look up specified This should never happen A possible reason is corruption in FIELD or and DL_POLY 4 executable Action Reconstruct FIELD recompile afresh DL POLY_4 and resubmit If the problem persists get in touch with DL_POLY_4 authors Message 108 error unidentified atom in rdf look up list During reading of RDF look up pairs in FIELD DL_POLY_4 has found an unlisted previously atom type Action Correct FIELD by either defining the new atom type or changing it to an already defined one in the erroneous line Resubmit Message 109 error calculated pair rdf index too large This should never happen In checking the RDF pairs specified in the FIELD file DL POLY 4 calculates a unique integer index that henceforth identify every RDF pair within the program If this index becomes too large termination of the program results Action Report to authors Message 108 error duplicate rdf look up pair specified During reading of RDF look up pairs i
255. emperature defined in equation 3 10 x t The VV implementation of the Evans algorithm is straight forward The conventional VV1 and VV2 steps are carried out as before the start of VV1 and after the end of VV2 there is an application of thermal constraining This involves the calculation of x t before the VV1 stage and x t At after the VV2 stage with consecutive thermalisation on the unthermostated velocities for half a timestep at each stage in the following manner 1 Thermostat VV1 Di vilt x t 2 End A u t aah 3 25 2 VVI1 1 At f t u t At tf t z FR HELA a HO od At 3 26 3 RATTLE_VV1 4 FF f t At f t 3 27 5 VV2 v t At o SAt 5 it 3 28 6 RATTLE_VV2 7 Thermostat VV2 Y ult At f t At ia 2 Ekin t At v t At v t At exp xe An 3 29 64 STFC Section 3 4 The algorithm is self consistent and requires no iterations The LFV implementation of the Evans algorithm is iterative as an initial estimate of x t at full step is calculated using an unconstrained estimate of the velocity at full step v t The iterative part is as follows 1 FF f e Ft At 3 30 2 LFV The iterative part is as follows At 2 At scale 1 x t scale v W 1 scale f 2 scale scale 1 1 t u t At scale v u t At scale f 0 3 31 m 1 r t At r t At u t At 3 SHAKE 4 Full step velocity do e At u
256. en modelling alloys The types of metal potentials available in DL_POLY_4 are as follows 1 EAM potential eam There are no explicit mathematical expressions for EAM potentials so this potential type is read exclusively in the form of interpolation arrays from the TABEAM table file as implemented in the METAL_TABLE_READ routine Section 6 1 7 The rules for combining the potentials from different metals to handle alloys are different from the FS class of potentials see below 2 EEAM potential eeam Similar to EAM above it is given in the form of interpolation arrays from the TABEAM file but the rules for combining the potentials from different metals are different from both EAM and FS classes see below 30 STFC Section 2 3 3 2BEAM potential 2beam Similar to EEAM for the s density terms and to EAM for the d ones It is and given in the form of interpolation arrays from the TABEAM file but the rules for combining the potentials from different metals are different from both EAM EEAM and FS classes see below 4 2BEEAM potential 2beeam Similar to EEAM for both s and d density terms It is and given in the form of interpolation arrays from the TABEAM file but the rules for combining the potentials from different metals are different from both EAM EEAM 2BEAM and ES classes see below 5 Finnis Sinclair potential 13 fnsc Finnis Sinclair potential is explicitly analytical It has the fol lowing form Vi
257. en the print rdf option is specified in the CONTROL file 6 2 11 The VAFDAT Files These are formatted files containing Velocity Autocorrelation Function VAF data An individual file is created for each atomic species i e VAFDAT_atname Their contents are as follows record cfgname a72 configuration name There follow the data for the VAF either a single time averaged profile or successive profiles separated by two blank lines The data supplied are as follows first record atname a8 atom name binvaf integer number of data points in VAF profile excluding t 0 vaforigin real absolute value of VAF at t 0 C 0 3kgT m vaftimeO real simulation time ps at beginning of last VAF profile t 0 following records binvaf 1 records E real time ps Z t real scaled velocity autocorrelation function C t C 0 at given time t Note the VAFDAT files are optional and appear when the print vaf option is specified in the CONTROL file 174 STFC Section 6 2 6 2 12 The INTDAT INTPMF amp INTTAB Files These files where INT is referring to INTra molecular interactions and VDW RDF derived inter molecular have very similar formatting rules with some examples shown in Section 4 2 Refer to Section 4 2 for their meaning and usage in coarse grained model systems record 1 title al00 file header title record 2 header al00 file information header record 3 info a30 information to follow string bins integer number
258. endent on an angle but on a displacement u See Sec tion 2 2 8 for details finish This directive is entered to signal to DL_POLY_4 that the entry of the details of a 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 to see how typical FIELD files are constructed Non bonded Interactions Non bonded interactions are identified by atom types as opposed to specific atomic indices The following different types of non bonded potentials are available in DL POLY_4 vdw van der Waals pair metal metal tersoff Tersoff tbp three body and fbp four body Each of these types is specified by a specific keyword as described bellow 1 vdw n where n is the number of pair potentials to be entered It is followed by n records each specifying a particular pair potential in the following manner atmnam 1 a8 first atom type atmnam 2 as second atom type key ad potential key see Table 6 12 variable 1 real potential parameter see Table 6 12 variable 2 real potential parameter see Table 6 12 variable 3 real potential parameter see Table 6 12 variable 4 real potential parameter see Table 6 12 variable 5 real potential parameter se
259. ensor is given by tot 2 15 where a and indicate the x y z components The atomic stress tensor derived in this way is symmetric In DL POLY_4 bond forces are handled by the routine BONDS_FORCES and INTRA_COUL called within 2 2 2 Distance Restraints In DL_POLY 4 distance restraints in which the separation between two atoms is maintained around some preset value rp is handled as a special case of bond potentials As a consequence distance restraints may be applied only between atoms in the same molecule Unlike with application of the pure bond potentials the electrostatic and van der Waals interactions between the pair of atoms are still evaluated when distance restraints are applied All the potential forms of the previous section are available as distance restraints although they have different key words 1 Harmonic potential hrm 2 Morse potential mrs 3 12 6 potential bond 126 4 Lennard Jones potential 13 5 Restrained harmonic rhm 6 Quartic potential qur 7 Buckingham potential bck 8 Coulomb potential cul 9 FENE potential fne 10 AMOEBA force field bond potential 36 amo 11 Tabulated potential tab The potential is defined numerically in TABBND see Section 4 3 and Section 6 1 8 In DL POLY_4 distance restraints are handled by the routine BONDS_FORCES and INTRA_COUL called within 2 2 3 Valence Angle Potentials The valence angle potentials describe
260. enta in the order ciLa 8t 2 gila 6t 2 iLa t gila 6t 2 giLs 6t 2 3 198 which preserves the symplecticness of the operations see reference 32 Note that t is some submultiple of At In DL_POLY 4 the default is At 100t The operators themselves are of the following kind ee q cos dt q sin dt Pk q grey p cos dt p sin Cx0t Ph p 3 199 where Py is a permutation operator with k 0 3 with the following properties Po q do 41 9 93 Pia a o 93 92 3 200 Pq 42 43 do q P3q 4q3 q2 q1 Go and the angular velocity Ck is defined as 1 Ch p Ph q 3 201 AT Equations 3 198 3 200 represent the heart of the NOSQUISH algorithm and are repeatedly applied 10 times in DL POLY 4 The final result is the quaternion updated to the full timestep value i e q t At These equations form part of the first stage of the VV algorithm VV1 In the second stage of the VV algorithm VV2 new torques are used to update the quaternion momenta to a full timestep At At p t At e p t a y ttt At 3 202 3 6 3 Thermostats and Barostats coupling to the Rigid Body Equations of Motion In the presence of rigid bodies in the atomic system the system s instantaneous pressure equation 3 95 2Ekin t Watomic t Wcom t Weonstrain t on At _ WeurF t a At VO 3 203 P t and stress equation 3 96 a t z Erin t Z atomic t
261. er defining the required potential in the code yourself Amendments to subroutines READ_FIELD and THREE_BODY_FORCES will be required Message 443 error undefined four body potential DL_POLY_4 has been requested to process a four body potential it does not recognise Action 270 STFC Appendix D Check the FIELD file and make sure the keyword is correctly defined Make sure that subroutine THREE_BODY_FORCES contains the code necessary to deal with the requested potential Add the code required if necessary by amending subroutines READ_FIELD and THREE_BODY_FORCES Message 444 error undefined bond potential DL_POLY_4 has been requested to process a bond potential it does not recognise Action Check the FIELD file and make sure the keyword is correctly defined Make sure that subroutine BONDS_FORCES contains the code necessary to deal with the requested potential Add the code required if necessary by amending subroutines READ_FIELD and BONDS_FORCES Message 445 error r_14 gt rcut in dihedrals_forces The 1 4 coulombic scaling for a dihedral angle bonding cannot be performed since the 1 4 distance has exceeded the system short range interaction cutoff rcut in subroutine DIHEDRAL_FORCES Action To prevent this error occurring again increase rcut Message 446 error undefined electrostatic key in dihedral_forces The subroutine DIHEDRAL_FORCES has been requested to process a form of electrostatic potential it d
262. ers in vacuum The parallelisation and domain decomposition is therefore limited to eight domains maximum of two in each direction in space This boundary condition should not used with the SPM Ewald summation method Cubic periodic boundaries imcon 1 The cubic MD cell is perhaps the most commonly used in simulation and has the advantage of great simplicity In DL_POLY_4 the cell is defined with the principle axes passing through the centres of the faces Thus for a cube with sidelength D the cell vectors appearing in the CONFIG file should be D 0 0 0 D 0 0 0 D Note the origin of the atomic coordinates is the centre of the cell 198 STFC Appendix A Figure A 1 The cubic MD cell LO Figure A 2 The orthorhomic MD cell Orthorhombic periodic boundaries imcon 2 The orthorhombic cell is also a common periodic boundary which closely resembles the cubic cell in use In DL POLY_4 the cell is defined with principle axes passing through the centres of the faces For an orthorhombic cell with sidelengths D in X direction E in Y direction and F in Z direction the cell vectors appearing in the CONFIG file should be D 0 0 0 E 0 0 0 F Note the origin of the atomic coordinates is the centre of the cell Parallelepiped periodic boundaries imcon 3 LU Figure A 3 The parallelepiped MD cell The parallelepiped e g monoclinic or triclinic cell is generally used in simulations of crystalline materi
263. es individual V M SD in and Tmean in Kelvin with controls i start timestep for dumping configurations default 0 j timestep interval between configurations default j 1 act exactly the same as ewald evaluate every n option above set FIQA iterations limit to n default n 100 set shake rattle iterations limit to n default n 250 set maximum timestep value in variable timestep control to f ps no default f 0 0 ps but if not opted sets to Huge 1 0 126 STFC Section 6 1 nfold i j k no elec no index no strict no topology no vafaveraging no vdw no vom optimise string f padding f rpad f pressure f print every n print analysis option to create matching CONFIG_i_j_k and FIELD_i_j_k for a volumetrically expanded version of the current system CONFIG and FIELD by replicating CONFIG s contents i j k times along the MD cell lattice vectors while preserving FIELD s topology template intact ignore electrostatics in simulation ignore particles indices as read from the CONFIG file and set particles indexing by order of reading this option assumes that the FIELD topology description matches the crystallographic sites from the CONFIG file by their order of reading rather than by their actual indexing i abort strict checks such as on existence of well defined system cutoff on contiguity of particles indices when connecting CONFIG crystallogr
264. es If the pseudo thermostat option is specified without any type of temperature control in CONTROL then both types will be applied in the order Langevin Direct at each time step during the simulation The algorithms are developed in the DL_POLY_4 routines PSEUDO_VV and PSEUDO_LFV respectively The defects option will trigger reading of REFERENCE see Section 6 1 4 which defines a reference MD cell with particles positions defining the crystalline lattice sites If REFERENCE is not found the simulation will either i halt if the simulation has been restarted i e is a continuation of an old one the restart option is used in CONTROL and the REVOLD see Section 6 1 5 file has been provided or ii recover using CONFIG see Section 6 1 2 if it is a new simulation run i e restart option is not used in CONTROL or REVOLD has not been provided The actual defect detection is based on comparison of the simulated MD cell to the reference MD cell based on a user defined site interstitial cutoff Rue Min 0 3 reut 3 A lt Raeg lt Min 1 2 Tcut 2 A 6 5 with a default value of Min 0 75 reu 3 A If the supplied value exceeds the limits the simulation execution will halt If a particle p is located in the vicinity of a site s defined by a sphere with its centre at this site and a radius Rgef then the particle is a first hand claimee of s and the site is not vacant Otherwise the site is presumed vacant and the particle is
265. espect to what is supplied in CONFIG HISTORY Action If this error is issued at start before timestep zero in a simulation then it is either your FIELD file is ill defined or that your CONFIG file or the first frame of your HISTRORY being replayed Check out for mistyped number or identities of molecules atoms etc in FIELD and for mangled blank lines in CONFIG HISTORY or a blank line s at the end of CONFIG or missing FOF End Of File character in CONFIG If this error is issued after timestep zero in a simulation that is not replaying HISTORY then it is big trouble and you should report that to the authors If it is during replaying HISTORY then your HISTORY file has corrupted frames and you must correct it before trying again Message 59 error too many core shell units per domain DL_POLY 4 limits the number of core shell units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to increase mxsh1 alternatively increase it by hand in SET_BOUNDS and recompile and resubmit 254 STFC Appendix D Message 60 error too many dihedral angles specified This should never happen Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 61 error too many dihedral angles per domain DL_POLY 4 limits th
266. essage 1001 Message 1012 error Action See Message 1002 deallocation failure in comms_module gt gisum_vector allocation failure in comms_module gt grsum_vector deallocation failure in comms_module gt grsum_vector allocation failure in comms_module gt gimax_vector deallocation failure in comms_module gt gimax_vector allocation failure in comms_module gt grmax_vector deallocation failure in comms_module gt grmax_vector allocation failure in parse_module gt get_record deallocation failure in parse_module gt get_record 285 STEC Appendix D Message 1013 error allocation failure Action See Message 1001 Message 1014 error allocation failure Action See Message 1001 Message 1015 error allocation failure allocate_core_shell_arrays Action See Message 1001 Message 1016 error allocation failure Action See Message 1001 Message 1017 error allocation failure Action See Message 1001 Message 1018 error allocation failure allocate_constraints_arrays Action See Message 1001 Message 1019 error allocation failure allocate_external_field_arrays Action See Message 1001 Message 1020 error allocation failure Action See Message 1001 Message 1021 error allocation failure Action See Message 1001 in in in in in in in
267. essage 17 error strange exit from CONTROL file processing See notes on message 16 above Message 18 error duplicate three body potential specified DL_POLY_4 has encountered a repeat specification of a three body potential in the FIELD file Action Locate the duplicate entry remove and resubmit job Message 19 error duplicate four body potential specified A 4 body potential has been duplicated in the FIELD file Action Locate the duplicated four body potential remove and resubmit job Message 20 error too many molecule sites specified This should never happen This error most likely arises when the FIELD file or and DL POLY_4 executable are corrupted Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 21 error molecule contains more atoms sites than declared The molecule contains more atom site entries that it declares in the beginning Action Recreate or correct the erroneous entries in the FIELD file and try again Message 22 error unsuitable radial increment in TABLE TABBND TABANG TABDIH TABIN file This arises when the tabulated van der Waals potentials presented in the TABLE file have an increment that is greater than that used to define the other potentials in the simulation Ideally the increment should be Teut mxgrid 4 where reut is the largest potential cutoff of all supplied for the short range potentials and
268. esubmit Message 10 error too many molecule types specified This should never happen This indicates an erroneous FIELD file or corrupted DL_POLY_4 executable Unlike DL_POLY Classic DL POLY_4 does not have a set limit on the number of kinds of molecules it can handle in any simulation this is not the same as the number of molecules Action Examine FIELD for erroneous directives correct and resubmit Message 11 error duplicate molecule directive in FIELD file The number of different types of molecules in a simulation should only be specified once If DL POLY_4 encounters more than one molecules directive it will terminate execution Action Locate the extra molecule directive in the FIELD file and remove and resubmit Message 12 error unknown molecule directive in FIELD file Once DL POLY_4 encounters the molecules directive in the FIELD file it assumes the following records will supply data describing the intramolecular force field It does not then expect to encounter directives not related to these data This error message results if it encounters a unrelated directive The most probable cause is incomplete specification of the data e g when the finish directive has been omitted Action Check the molecular data entries in the FIELD file correct and resubmit Message 13 error molecule species not specified This error arises when DL_POLY 4 encounters non bonded force data in the FIELD file before the mol
269. etc e Simple rigid molecules e g CCl4 SFe Benzene etc e Rigid molecular ions with point charges e g KNOs NH4 2SOu etc e Polymers with rigid bonds e g C Han 2 e Polymers with flexible and rigid bonds and point charges e g proteins macromolecules etc e Silicate glasses and zeolites e Simple metals and metal alloys e g Al Ni Cu CuzAu etc e Covalent systems as hydro carbons and transition elements e g C Si Ge SiC SiGe ets STFC Section 1 2 1 2 2 Force Field The DL POLY_4 force field includes the following features 1 All common forms of non bonded atom atom van der Waals potentials 2 Atom atom and site site coulombic potentials Metal metal local density dependent potentials 11 12 13 14 15 16 Ae Ww Tersoff local density dependent potentials for hydro carbons 17 Three body valence angle and hydrogen bond potentials Four body inversion potentials Ion core shell polarasation Tether potentials O 0 N Q OH Chemical bond potentials 10 Valence angle potentials 11 Dihedral angle and improper dihedral angle potentials 12 Inversion angle potentials 13 External field potentials The parameters describing these potentials may be obtained for example from the GROMOS 18 Dreiding 19 or AMBER 20 forcefield which share functional forms It is relatively easy to adapt DL_POLY 4 to user specific force fields 1 2 3 Boundary Conditions DL_POLY_4 will
270. etc transmitted between I O groups I O readers for domain distribution purposes l buffer size 100 lt 1 lt 100 000 default 20 000 is the maximum number of ASCII line records read in a batch NOTE that e is not applicable for the master method e parallel error check Yes default N set the general I O write interface to method mpiio for MPI I O direct for parallel direct access FORTRAN I O or master for traditional master I O or netcdf for netCDF I O provided DL_POLY_4 is compiled in a netCDF enabled mode default mpiio WARRNING direct is not a platfotm portable solution as it fails on LUSTRE but works on GPFS NOTE that rp is only applicable for the netcdf method rp real precision 32bit or amber for 32 bit float otherwise 64 bit double is defaulted if unspecified type sorted or unsorted DD scrambled by global index output default sorted j writer count 1 lt j lt job size default j Int Log Min job size 8y job size Log 2 is the designated number of processes to carry out I O write operations simultaneously 125 OSTFC Section 6 1 job time f maxdis f metal direct metal sqrtrho mindis f minimise string n f msdtmp i j multiple timestep n mxquat n mxshak n mxstep f NOTE that k is not applicable for the master method k batch size 1 lt k lt 10 000 000 default 2 000 000 is the maximum number of particle entities in a batch i e multiples of sp
271. evin NVT ensemble 11 Berendsen NVT ensemble 12 Nos Hoover NVT ensemble 20 Langevin NPT ensemble 21 Berendsen NPT ensemble 22 Nos Hoover NPT ensemble 23 Martyna Tuckerman Klein NPT ensemble 30 Langevin NaT ensemble 31 Berendsen NoT ensemble 32 Nos Hoover NaT ensemble 33 Martyna Tuckerman Klein NoT ensemble The zero directive enables a zero temperature optimisation The target temperature of the simu lation is reset to 10 Kelvin and a crude energy minimiser 0 wf 0 wey at uf 20 ee 2 SY Li i is used to help the system relax before each integration of the equations of motion measures are taken to conserve the MD cell momentum This must not be thought of as a true energy minimization method Note that this optimisation is applied irrespectively of whether the simulation runs in equilibration or statistical mode The algorithm is developed in the DL_POLY_4 routine ZERO_K_OPTIMISE The impact i j E x y z directive will not be activated if the particle index is beyond the one of the last particle The option will fail in a controlled manner at application time if the particle is found to be in a frozen state or the shell of an ion or part of a rigid body During application the center of mass 133 STFC Section 6 1 11 momentum is re zeroed to prevent any drifts The user must take care to have the impact initiated after any possible equilibration Otherwise the syste
272. evin friction f in ps select NPT ensemble type Langevin with fi f2 as the thermostat and barostat relaxation speed friction constants in ps select NPT ensemble type Berendsen with f1 fo as the thermostat and barostat relaxation times in ps select NPT ensemble type Nose Hoover with f1 fa as the athermostat and barostat relaxation times in ps 123 OSTFC Section 6 1 ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble npt mtk fi f2 nst langevin fi fa nst berendsen f f2 nst hoover f fa nst mtk fi fe nst Q fifo area nst Q ff tension y select NPT ensemble type Martyna Tuckerman Klein with fi f2 as the thermostat and barostat relaxation times in ps select NaT ensemble type Langevin with fi f2 as the thermostat and barostat relaxation speed friction constants in ps select NoT ensemble type Berendsen with f f2 as the thermostat and barostat relaxation times in ps select No T ensemble type Nose Hoover with f f2 as the thermostat and barostat relaxation times in ps select NoT ensemble type Martyna Tuckerman Klein with fi fo as the thermostat and barostat relaxation times in ps select NP AT ensemble type Q i e lang ber hoover or mtk with f fo as the thermostat and barostat relaxation times in ps select NP yT ensemble type Q i e lang ber hoover or mtk with f fo as the thermostat an
273. f a step out of phase between velocity and psoition The LFV algorithm is one staged It requires values of position r and force f at time t and velocity v at half a timestep behind t 1 2 At Firstly the forces are recalculated afresh at time t from time t At since the positions have changed from the last step 1 FF f e ft At 3 5 where At is the timestep 2 LFV The velocities are advanced by a timestep to t 1 2 At by integration of the new force 1 1 f At t At At 3 6 o t 540 e u t 5 At At 3 6 where m is the mass of a site and then the positions are advanced to a full step t At using the new half step velocities r t At lt r t At u t At 3 7 58 STFC Section 3 1 Molecular dynamics simulations normally require properties that depend on position and velocity at the same time such as the sum of potential and kinetic energy The velocity at time t is obtained from the average of the velocities half a timestep either side of timestep t 1 1 1 u t lt Lut At u t 4 z 3 8 The instantaneous kinetic energy for example can then be obtained from the atomic velocities as E Exin t 5 X matt 3 9 1 and assuming the system has no net momentum the instantaneous temperature is T t Ekin t 3 10 where i labels particles that can be free atoms or rigid bodies M the number of particles free atoms and rigid bodies in the system kg the Bol
274. f the RATTLE 23 and SHAKE 8 algorithms are used for solving bond constraints in the VV and LFV cast integrations respectively The rotational motion of rigid bodies RBs is handled with Fincham s implicit quaternion algorithm FIQA 24 under the LFV scheme or with the NOSQUISH algorithm of Miller et al 25 under the VV integration The following MD algorithms are available 1 Constant E algorithm 2 Evans constant Egin algorithm 26 3 Langevin constant T algorithm 27 4 Andersen constant T algorithm 28 5 Berendsen constant T algorithm 29 6 Nos Hoover constant T algorithm 30 7 Langevin constant T P algorithm 31 8 Berendsen constant T P algorithm 29 9 Nos Hoover constant T P algorithm 30 10 Martyna Tuckerman and Klein MTK constant T P algorithm 32 11 Langevin constant T algorithm 31 12 Berendsen constant T algorithm 29 13 Nos Hoover constant T a algorithm 30 14 Martyna Tuckerman and Klein MTK constant T algorithm 32 1 2 6 DL POLY Classic features incompatible or unavalable in DL POLY 4 e Force field Rigid bodies connected with constraint links are not available Shell models specification is solely determined by the presence of mass on the shells Dihedral potentials with more than three original parameters see OPLS have two artificially added parameters defining the 1 4 electrostatic and van der Waals scaling factors which must be placed at fourth and f
275. file are 1msd nstmsd istmsd which are created internally based on information read from the msdtmp directive in the CONTROL file see Section 6 1 1 The MSDTMP file will be created only if the directive msdtmp appears in the CONTROL file The MSDTMP file can become very large especially if it is formatted For serious simulation work it is recommended that the file be written to a scratch disk capable of accommodating a large data file The MSDTMP has the following structure record 1 header a52 file header record 2 megatm integer number of atoms in simulation cell in last frame frame integer number configuration frames in file records integer number of records in file For timesteps greater than nstmsd the MSDTMP file is appended at intervals specified by the msdtmp directive in the CONTROL file with the following information for each configuration record i timestep a8 the character string timestep nstep integer the current time step megatm integer number of atoms in simulation cell again tstep real integration timestep ps time real elapsed simulation time ps This is followed by the configuration for the current timestep i e for each atom in the system the following data are included record a 166 STFC Section 6 2 atmnam a8 atomic label iatm integer atom index MSD t real square root of the atomic mean square displacements in A Tmean real atomic mean temperature in Kelvin 6 2 3 The DEFECTS File
276. fluctuations in the OUTPUT file to help you with this Message 96 error incorrect atom totals in metal_ld_set_halo This should never happen Action Big trouble Report to authors Message 97 error constraints mixing with rigid bodies not allowed Action Correct FIELD and resubmit Message 99 error cannot have shells as part of a constraint rigid body or tether Action Correct FIELD and resubmit Message 100 error core shell unit separation gt rcut the system cutoff This could only happen if FIELD and CONFIG do not match each other or CONFIG is damaged Action Regenerate CONFIG and FIELD and resubmit 260 STFC Appendix D Message 101 error calculated four body potential index too large This should never happen DL_POLY_4 has a permitted maximum for the calculated index for any four body potential in the system i e as defined in the FIELD file If there are m distinct types of atom in the system the index can possibly range from 1 to m x m 1 m 2 6 If the internally calculated index exceeds this number this error report results Action Report to authors Message 102 error rcut lt 2 rcter maximum cutoff for tersoff potentials The nature of the Tersoff interaction requires they have at least twice shorter cutoff than the standard pair interctions or the major system cutoff Action Decrease Tersoff cutoffs in FIELD or increase cutoff in CONTROL and resubm
277. follows 1 Harmonic harm 1 U rij ak rio 2 79 2 Restrained harmonic rhrm 1 2 sk rio i rio lt r Uira A IN E 2 80 ru Ler kre rio te 3 rol gt re E 3 Quartic potential quar pe eee pea ee 2 81 rig rio rio ro 2 81 as in each case rj is the distance between the atom positions at moment t tl and t 0 The force on the atom arising from a tether potential potential is obtained using the general formula i a AO Lio 2 82 rio The contribution to be added to the atomic virial is given by W ro f 2 83 The contribution to be added to the atomic stress tensor is given by oP Spee 2 84 where a and indicate the x y z components The atomic stress tensor derived in this way is symmetric In DL_POLY_4 tether forces are handled by the routine TETHERS_FORCES 2 3 The Intermolecular Potential Functions In this section we outline the two body metal Tersoff three body and four body potential functions in DL_POLY_4 An important distinction between these and intramolecular bond forces in DL_POLY_4 is that they are specified by atom types rather than atom indices 2 3 1 Short Ranged van der Waals Potentials The short ranged pair forces available in DL_POLY_4 are as follows 26 STFC Section 2 3 ura 2 2 85 ij ij 1 12 6 potential 12 6 2 Lennard Jones potential 1j 6 2 86 re 2 87 Tij 2 88 3 n
278. g N N log P P may take up to 40 of the time per timestep d Particle exchange between domains involving construction and connection of new out of domain topol ogy when bonded like interactions exist by RELOCATE_PARTICLES O N PINY 3 e Iterative bond and PMF constraint solvers CONSTRAINTS_SHAKE_VV CONSTRAINTS_RATTLE_VV CONSTRAINTS_SHAKE_LFV and PMF_SHAKE_VV PMF_RATTLE_VV PMF_ SHAKE_LFV O N P NJU3 where N is the number of particles P P Py Pz the total number of domains in the MD cell and the rest of the quantities are as defined in equations 5 1 5 2 Performance may also affected by the fluctuations in the inter node communication due to unavoidable communication traffic when a simulation job does not have exclusive use of all machine resources Such effects may worsen the performance much especially when the average calculation time is of the same magnitude as or less than the average communication time i e nodes spend more time communicating rather than computing 5 3 A Guide to Preparing Input Files The CONFIG file and the FIELD file can be quite large and unwieldy particularly if a polymer or biological molecule is involved in the simulation This section outlines the paths to follow when trying to construct 111 STFC Section 5 3 files for such systems The description of the DL_POLY_4 force field in Chapter 2 is essential reading The various utility routines mentioned in this section
279. ge In the case of EAM type of metal interactions this indicates that the electron density of a particle in the system has exceeded the limits for which the embedding function for this particle s type is defined as supplied in TABEAM In the case of Finnis Sinclair type of metal interactions this indicates that the density has become negative Action Reconsider the physical sanity and validity of the metal interactions in your system and this type of simula tion You MUST change the interactions parameters and or the way the physical base of your investigation is handled in MD terms Message 508 error EAM metal interaction entry in TABEAM unspecified in FIELD The specified EAM metal interaction entry found in TABEAM is not specified in FIELD Action For N metal atom types there are 5N N 2 EAM functions in the TABEAM file One density N and one embedding N function for each atom type and N N 2 cross interaction functions Fix the table entries and resubmit Message 509 error duplicate entry for a pair interaction detected in TABEAM A duplicate cross interaction function entry is detected in the TABEAM file Action Remove all duplicate entries in the TABEAM file and resubmit 277 STFC Appendix D Message 510 error duplicate entry for a density function detected in TABEAM A duplicate density function entry is detected in the TABEAM file Action Remove all duplicate entries in the TABEAM fil
280. gger dump of atom displacements based on a qualifying cutoff in a trajectory like manner Dsiplacemets of atoms from their original position at the end of equilibration the start of statistics 0 is carried out at each timestep The tolerance for relaxed shell model rlxtol is a last resort option to aid shell relaxation of systems with very energetic and or rough potential surface Users are advised to use it with caution should there really need be as the use of high values may result in physically incorrect dynamics The difference between the directives ewald and spme is only in the ewald spme sum directive in which the ewald sum specifies the indices of the maximum k vector whereas the spme sum the dimensions of the 3D charge array which are exactly twice the maximum k vector indices Note that in either case DL_POLY_4 will carry out the SPME coulombic evaluation The force selection directives ewald spme sum precision reaction coul shift dist no elec are handled internally by the integer variable keyfce See Table 6 4 for an explanation of this variable Note that all these options with the exception of the last no elec are mutually exclusive Table 6 4 Electrostatics Key keyfce meaning Electrostatics are evaluated as follows Ignore electrostatic interactions SPM Ewald summation Coulomb sum with distance dependent dielectric Standard truncated Coulomb sum Force shifted Coulomb sum 10 Reaction fie
281. gt i k gt j N 3N 2N 1 N D iD gt gt U4 body i j k n Li Lj Ek En i 1 j gt i k gt j n gt k N gt D Vestn i Ti vi gt i 1 metal where Ushel Uteth Ubond Uangl Udind Uinv Us body gt Utersof f U3 body and U4 body aTe empirical inter action functions representing ion core shell polarisation tethered particles chemical bonds valence angles dihedral and improper dihedral angles inversion angles two body Tersoff three body and four body forces respectively The first six are regarded by DL POLY_4 as intra molecular interactions and the next four as inter molecular interactions The final term Uextn represents an external field potential The po sition vectors r4 Tp re and rg refer to the positions of the atoms specifically involved in a given interac tion Almost universally it is the differences in position that determine the interaction The numbers Nshels Nteths Noonds Nangi Naina and Niny refer to the total numbers of these respective interactions present in the simulated system and the indices shel iteth tbonds tangl tdihd aNd iiny Uniquely specify an individual interaction of each type It is important to note that there is no global specification of the intramolecular 12 STFC Section 2 2 interactions in DL_POLY_4 all core shell units tethered particles chemical bonds valence angles dihedral angles and inversion angles must be individually cited The same applies for bond co
282. gy due to the shells move to minimised configuration 2 8 Tabulation and interpolation in the treatment of intermolecular in teractions By default DL_POLY_4 tabulates in memory most of the intermolecular interactions keeping values of the potential and the negative of its first derivative times the distance or virial over an equidistant grid This is done for reasons of speed as due to the large variety of potential forms some could be quite expensive to evaluate if run unoptimised The memory tabulation could be overridden for non tabulated interactions upon user specified options such as metal direct for metal interactions and vdw direct for van der Waals interactions When energy and force are calculated for tabulated interactions a 3 point interpolation scheme of our own is used to interpolate the value for the requested distance A 5 point interpolation is used for finding the numerical derivatives of 2B E EAM type potentials which are supplied in TABEAM by the user For this a Lagrange formula is used which can be found in any textbook on numerical methods 56 Chapter 3 Integration Algorithms Scope of Chapter This chapter describes the integration algorithms coded into DL_POLY_4 57 STFC Section 3 1 3 1 Introduction As a default the DL POLY 4 integration algorithms are based on the Velocity Verlet VV scheme which is both simple and time reversible 22 It generates trajectories in the microcanonical NVE
283. h 2 Angs lt thick ness lt a quarter of the minimum MD cell width DL_POLY_4 has found a check violated while reading CONTROL Action Correct accordingly in CONTROL and resubmit Message 540 error pseudo thermostat MUST only be used in bulk simulations i e imcon MUST be 1 2 or 3 DL_POLY_4 has found a check violated while reading CONTROL Action Correct accordingly in CONTROL nve or in CONFIG imcon and resubmit Message 551 error REFERENCE not found The defect detection option is used in conjunction with restart but no REFERENCE file is found Action Supply a REFERENCE configuration Message 552 error REFERENCE must contain cell parameters REFERENCE MUST contain cell parameters i e image convention MUST be imcon 1 2 3 or 6 Action 279 STFC Appendix D Supply a properly formatted REFERENCE configuration Message 553 error REFERENCE is inconsistent An atom has been lost in transfer between nodes This should never happen Action Big trouble Report problem to authors immediately Message 554 error REFERENCE s format different from CONFIG s REFERENCE complies to the same rules as CONFIG with the exception that image convention MUST be imcon 1 2 3 or 6 Action Supply a properly formatted REFERENCE configuartion Message 555 error particle assigned to non existent domain in defects_read_reference Action See Message 513 Message 556 error too ma
284. h the fictitious ones it is advisory to store the initial FIELD_CG for the future use when the actual TAB files are ready e Run DL_POLY 4 with the replay history rdf and or analysis options invoked in the CONTROL file which will result in creation of the targeted inter and intra molecular PDF data files RDFDAT BNDDAT ANGDAT DIHDAT INVDAT and the respective PMF files as described above Note that only and only when the rdf and analysis options are both active then the VDWPMF and VDWTAB files derived from RDF s will be produced along with RDFDAT They are structured in the same manner and format as their intramolecular counterparts The user can then convert the VDWTAB file into a correctly formatted TABLE file by using the utility called pmf2tab f subject to compilation found in DL POLY 4 directory utility as follows user host pmf2tab exe lt VDWTAB e Check the data for accuracy and amend the tabulated force fields Redo the analysis on coarser finer grid s if necessary e When satisfied with the created TAB files run a DL_POLY_4 simulation for the prepared CG or simply user defined model system 101 Chapter 5 Construction and Execution Scope of Chapter This chapter describes how to compile a working version of DL POLY_4 and run it 102 STFC Section 5 1 5 1 Constructing DL_POLY_4 an Overview 5 1 1 Constructing the Standard Versions DL_POLY_4 was designed as a package of useful subroutines
285. h0_1fv f90 npt_m0_lfv f90 nst_10_1fv f90 nst_bO_lfv f90 nst_hO_lfv f90 nst_m0_1fv f90 nve_1_1fv f90 nvt_e1_lfv f90 nvt_11_1fv f90 nvt_ai_lfv f90 nvt_bi_lfv f90 nvt_hi_lfv f90 nvt_gi_lfv f90 npt_11_1fv f90 npt_b1_1fv f90 npt_hi_lfv f90 npt_m1_lfv f90 nst_11_1fv f90 nst_bi_lfv f90 nst_hi_lfv f90 nst_m1_1fv f90 w_at_start_lfv f90 w_integrate_lfv f90 w_md_lfv f90 Examine targets manually J all echo echo You MUST specify or choose a permissive target platform echo echo The available permissive targets are displayed below echo echo hpc lake newton dirac franklin echo hpcx hpcx debug BGL BGP echo archer archer pgi debug echo archer gnu archer gnu debug echo archer cray archer cray debug echo archer pathscale archer pathscale debug echo archer X2 archer X2 debug echo echo Please examine this Makefile s targets for details echo If no target suits your system then create your own echo using the advice in generic target template provided echo in this Makefile under the entry uknown_platform echo Fetch the Velocity Verlet subroutines FILES_VV MAKE links_vv links_vv for file in FILES_VV do echo linking to file rm f file ln s VV file file done 227 OSTFC Appendix C Fetch the LeapF
286. hat conserve the phase space volume and thus have well defined conserved quantities even in presence of forces external to the system 78 which is not the case for Nos Hoover NPT and NaT ensembles The NPT and NoT versions of the MTK ensemble are implemented in the DL_POLY_4 routines NPT_MO_vv and NST_MO_vv in VV flavour and NPT_MO_LFV and NST_MO_LFV LFV flavour respectively The corresponding routines incorporating RB dynamics are NPT_M1_VV and NPT_M1_LFV and NST_M1_VV and NST_M1_LFV 3 6 Rigid Bodies and Rotational Integration Algorithms 3 6 1 Description of Rigid Body Units A rigid body unit is a collection of point entities whose local geometry is time invariant One way to enforce this in a simulation is to impose a sufficient number of bond constraints between the atoms in the unit However in many cases this may be either problematic or impossible Examples in which it is impossible to specify sufficient bond constraints are 1 linear molecules with more than 2 atoms e g CO2 2 planar molecules with more than three atoms e g benzene Even when the structure can be defined by bond constraints the network of bonds produced may be problem atic Normally they make the iterative SHAKE in the LFV integration or RATTLE in the VV integration procedure slow particularly if a ring of constraints is involved as occurs when one defines water as a con strained triangle It is also possible inadvertently to over constrain a
287. he case of the X piston field it is strongly advised that the number of piston particles is chosen to be very small in comparison with the rest of the system lt 5 and that the piston contains its own set of whole molecules i e there are no molecules partially mapped on the piston which do not include any core shell CB PMF or RB units The field releases the system s centre of mass to move unconstrained and gain momentum This makes any temperature control options control the full kinetic energy of the system and thus the only ensemble valid under this conditions and possible within DL_POLY_4 at the present is the micro canonical NVE The user is advised to be careful with the parameters units For more insight do examine Table 6 17 and the example at equation 6 9 in Section 6 1 3 In DL_POLY_4 external field forces are handled by the routines EXTERNAL_FIELD_APPLY and EXTERNAL_FIELD_CORRECT 2 7 Treatment of Frozen Atoms Rigid Body and Core Shell Units Frozen atoms core shell units and rigid body units are treated in a manner similar to that of the intra molecular interactions due to their by site definition DL_POLY_4 allows for atoms to be completely immobilized i e frozen at a fixed point in the MD cell This is achieved by setting all forces and velocities associated with that atom to zero during each MD timestep Frozen atoms are signalled by assigning an atom a non zero value for the freeze parameter
288. he original atomic forces in the conjugate gradient scheme The atomic displace ment induced in the conjugate gradient algorithm is corrected to maintain the magnitude of the radial position vector as required for circular motion b With regard to constraint bonds these are replaced by stiff harmonic bonds to permit minimisa tion This is not normally recommended as a means to incorporate constraints in minimisation procedures as it leads to ill conditioning However if the constraints in the original structure are satisfied we find that provided only small atomic displacements are allowed during relaxation it is possible to converge to a minimum energy structure Furthermore provided the harmonic springs are stiff enough it is possible afterwards to satisfy the constraints exactly by further optimising the structure using the stiff springs alone without having a significant affect on the overall system energy c Systems with independent constraint bonds and rigid bodies may also be minimised by these methods 3 Of the three minimisation strategies available in DL_POLY_4 only the programmed minimiser is capable of finding more than one minimum without the user intervening 4 Finally we emphasise once again that the purpose of the minimisers in DL_POLY_4 is to help improve the quality of the starting structure and we believe they are adequate for that purpose We do not recommend them as general molecular structure optimisers They may
289. he reduced DoF mapping leads to the generation of an effective CG FF in terms of the effective interaction potentials and forces between the CG particles which are often tabulated numerically The initial coarse grain mapping of the original FA trajectory can be done with the aid of DL CGMAP tool http www ccp5 ac uk software After the CG mapped trajectory has been obtained the relevant distribution analysis and the Boltzmann Inversion procedure producing tabulated PMF s can be performed by using DL POLY_4 in replay history mode with the corresponding directives in CONTROL file For further iterative optimisation of the CG model the user is advised to use DL_POLY_4 as simulation engine within the framework of VOTCA package http www votca org which provides a handful of various systematic coarse graining methodologies For more details the user should refer to the manuals of these tools This section describes how to use DL_POLY_4 for two SCG tasks e Post simulation analysis of the intramolecular bonded and angular mean force interactions based on the calculation of the corresponding intramolecular distributions e Preparation and use of the tabulated intramolecular potentials Note Although these steps are also applicable to atomistic systems which can be useful for benchmarking purposes below we shall assume that the CG mapping has been done and the following data files have been generated for the CG mapped model sy
290. her time averaged or the last complete sample is printed out as the last part of the OUTPUT file This is written by the subroutine VAF_COMPUTE First the details of the calculations are stated either the number of samples used to give a time averaged profile or the number of the last completed sample with its starting time The absolute value of the velocity autocorrelation function for the system at t 0 C 0 is then stated Then t and Z t are given in tabular form Z t C t C 0 is the value of the velocity 172 STFC Section 6 2 autocorrelation function C t v 0 v t scaled by C 0 3kgT m Note that a readable version of these data for individual species is provided by the VAFDAT files below 6 2 7 The REVCON File This file is formatted and written by the subroutine REVIVE REVCON is the restart configuration file The file is written every ndump time steps in case of a system crash during execution and at the termination of the job A successful run of DL_POLY_4 will always produce a REVCON file but a failed job may not produce the file if an insufficient number of timesteps have elapsed ndump is controlled by the directive dump in file CONTROL see above and listed as parameter ndump in the SETUP_MODULE file see Section 7 2 2 The default value is ndump 1000 REVCON is identical in format to the CONFIG input file see Section 6 1 2 REVCON should be renamed CONFIG to continue a simulation from one job to th
291. i that the inversion potential makes no contribution to the atomic virial If the force components ff for atoms i j k n are calculated using the above formulae it is easily seen that the contribution to be added to the atomic stress tensor is given by aP raff ra trage 2 70 The sum of the diagonal elements of the stress tensor is zero since the virial is zero and the matrix is symmetric In DL_POLY_4 inversion forces are handled by the routine INVERSIONS_FORCES 2 2 8 The Calcite Four Body Potential This potential 45 46 is designed to help maintain the planar structure of the carbonate anion CO3 in a similar manner to the planar inversion potential described above However it is not an angular potential It is dependent on the perpendicular displacement u of an atom a from a plane defined by three other atoms b c and d see Figure 2 6 and has the form Uabca u Au Bu 2 71 where the displacement u is given by Te Tab Tbe X Tod 2 72 Cbe X Taal 24 STFC Section 2 2 Figure 2 6 The vectors of the calcite potential Vectors Tab Tac ANA raq define bonds between the central atom a and the peripheral atoms b c and d Vectors Tyc and ryg define the plane and are related to the bond vectors by Tbe Fac Tab Tod Yad Tad 2 73 In what follows it is convenient to define the vector product appearing in both the numerator and denomi nator of equation 2 72 as the vector
292. i_lfv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o npt_m1_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_bO_lfv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_b0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_b1_1fv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_b1_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_hO_lfv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_hO_scl o config_module o kinds_f90 o kinetic_module o setup_module o nst_h0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o nst_hi_lfv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_hi_scl o config_module o kinds_f90 0 kinetic_module o A rigid_bodies_module o setup_module o nst_h1_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o nst_10_1fv o comms_module
293. ibility see example above Records must be limited in length to 100 characters Records are read in words directives and additional keywords and numbers as a word must not exceed 40 characters in length Words are recognised as such by separation by one or more space characters Additional annotation 121 STEC Section 6 1 is not recommended but may be added onto a directive line after the last control word in it e The first record in the CONTROL file is a header up to 100 characters long to aid identification of the file e The last record is a finish directive which marks the end of the input data Between the header and the finish directive a wide choice of control directives may be inserted These are described below 6 1 1 2 The CONTROL File Directives The directives available are as follows directive meaning analyse all sampling every f nbins n rmax r calculate and collect all intramolecular PDF s every f timesteps default f 1 using a grid with n bins and bonds cutoff of r A default r 2 A analyse bonds sampling every f nbins n rmax r calculate and collect bonds PDFs every f timesteps default f 1 using a grid with n bins in the range 0 r default r 2 A analyse angles sampling every f nbins n calculate and collect angles PDFs every f timesteps default f 1 using a grid with n bins in the range 0 180 degrees analyse dihedrals sampling every f nbins
294. icle participating in the interaction Hence the angular term s derivative is more elaborate to express than the one in the ters case The derivative of g 6 is worked out in the following manner gli LO Zl o E 2 173 Tg olijk sin ijk Or Tij Tik where Og ijk 2 c hi cos Oijk Sin ijk t 2 174 OO ijk d h COS Or el O rig Tiel he ri mt TijTik ey a es Ml re pa col i de dex dei H 2 175 ij Tik 42 STFC Section 2 3 The contribution to be added to the atomic virial can be derived as OE ersoff _ 3 V OU Wom WS De ay Lae 2 176 5 Tij fij Vik fik Diga ra n u pa fa LY Orij 2 Orik o e ters ES otra alos rage toral i i jfi a 1 Ni pii a ni pni 1 3 fotris falris xa 1 8 8 i pi LE X 2 177 0 XO wir 9 0 5 gt fe ra rsh kAt j e hiks EE loss otra alos wget at ro i Al 4 i 6 ti fo ris falrig Xij 1 E Ea a x 2 178 S 7 wik ra 905 7 Fel 05 Bi rij ra fotra kHi j The contribution to be added to the atomic stress tensor is given by a reff 2 179 where a and indicate the x y z components The stress tensor is symmetric Interpolation arrays vter and gter set up in TERSOFF_GENERATE similar to those in van der Waals interactions Section 2 3 1 are used in the calculation of the Tersoff forces virial and stress The Tersoff potentials are very
295. ifth position respectively extending the original parameter list split by them STFC Section 1 3 e Boundary conditions Truncated octahedral periodic boundaries imcon 4 are not available Rhombic dodecahedral periodic boundaries imcon 5 are not available Hexagonal prism periodic boundaries imcon 7 are not available e Electrostatics Standard Ewald Summation is not available but is substituted by Smoothed Particle Mesh Ewald SPME summation Hautman Klein Ewald Summation for 3D non periodic but 2D periodic systems is not available e Non standard functionality Temperature Accelerated Dynamics Hyperdynamics Solvation Energies 1 3 Programming Style The programming style of DL_POLY 4 is intended to be as uniform as possible The following stylistic rules apply throughout Potential contributors of code are requested to note the stylistic convention 1 3 1 Programming Language DL_POLY 4 is written in free format FORTRAN90 In DL POLY 4 we have adopted the convention of explicit type declaration i e we have used Implicit None in all subroutines Thus all variables must be given an explicit type Integer Real Kind wp etc 1 3 2 Modularisation and Intent DL_POLY_4 exploits the full potential of the modularisation concept in FORTRANO9O0 Variables having in common description of certain feature or method in DL_POLY_4 are grouped in modules This simplifies subroutines call
296. in TAB files are resampled onto max Nmin Ntap grid points located at the bin edges as expected by DL POLY_4 when reading the potential and force tables where Niap is the grid number for the respective intramolecular unit type read in from its TAB file if provided otherwise Niap 0 Thus the TAB files obey the DL_POLY_4 format for numerically defined intramolecular force field tables TAB see below and hence can be directly used as such upon renaming BNDTAB gt TABBND ANGTAB gt TABANG DIHTAB gt TABDIH and INVTAB gt TABINV The user is however strongly advised to check the quality of the obtained tabulated force fields before using those as input for a CG simulation Albeit DL_POLY_4 uses a simple smoothing algorithm for noise reduction in PMF s and implements capping of the forces in the regions of zero valued PDF s in undersampled regions the PDF and PMF data are likely to suffer from 99 STFC Section 4 3 inaccuracy and increased noise which most often require extra attention and re fitting manually The general format of the above discussed files is shown in Section 6 2 12 4 3 Setting up Tabulated Intramolecular Force Field Files For a user defined e g coarse grained model system the effective potentials must be provided in a tabulated form For non bonded short range VdW interactions the TABLE file must be prepared as described in Section 6 1 6 However the tabulated data format for intramolecular inter
297. in t Pmass N 34t 20 kp Toxt 2 8 8 dmass 4 VVI 1 At f t u t A v t 4 mee 1 H t At exp nt At At H t 1 AOE E ne Lat At V t 3 145 1 1 r t At exp ht At At r t Ro t At v t At Ro t 5 RATTLE _VV1 6 FF 7 VV2 f t At f t 3 146 v t At v t4 2t Za 3 147 8 RATTLE_VV2 9 Thermostat Note Exin t At has changed and changes inside 5 1 x t At x t At At 2Epin t At Pmass M t 3A8 20 kg Text 8 dmass 5 At v t At exp x t4 At i u t At 3 148 3 5 At 2E in t At mass t LAt 2 20 k Tex XFA xt At nEaN TER wn ie 10 Barostat Note Exin t At and P t At have changed and change inside 1 3 At 1 nit At exp x t A E n t At 3 1 At 3P At Pal V t At n t At t 5At a i VES 3 3 At 3 nt 74 exp x t At 3 n t 4 74 v t At exp n t 4 3 3 At 3 n t 7 1 exp x t 74 a nt 4 74 A At 3 P t At Pex V t At Pmass At u t At 3 149 nt At nt A0 gt n t At n t At exp x t At z 84 STFC Section 3 5 11 Thermostat Note Exin t At has changed and changes inside At 2Ekin t At mass Nt At 20 kg Tox ARAT dr ee Ae Ae a e sr o Ml de Te 8 4 8 mass 7 At v t At expl x t4 gAt a u t At 3 150 7 At 2E pin t
298. in extremely non equilibrium simulations or usually when the potential in use do not hold the system stable 253 STFC Appendix D Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxbfxp parameter in SET_BOUNDS recompile and resubmit Message 55 error end of CONFIG file encountered This error arises when DL_POLY_4 attempts to read more data from the CONFIG file than is actually present The probable cause is an incorrect or absent CONFIG file but it may be due to the FIELD file being incompatible in some way with the CONFIG file Action Check contents of CONFIG file If you are convinced it is correct check the FIELD file for inconsistencies Message 56 error atomic coordinate array exceeded in export_atomic_data This may happen in extremely non equilibrium simulations or usually when the potential in use do not hold the system stable Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxatms in SET_BOUNDS recompile and resubmit Message 57 error too many core shell units specified This should never happen Action Recompile the program or recreate the FIELD file If neither of these works send the problem to us Message 58 error number of atoms in system not conserved Either and an atom has been lost in transfer between nodes domains or your FIELD is ill defined with r
299. in principle to everyone 10 Chapter 2 Force Field Interactions Scope of Chapter This chapter describes the variety of interaction potentials available in DL_POLY 4 11 STFC Section 2 1 2 1 Introduction to the DL_POLY_4 Force Field The force field is the set of functions needed to define the interactions in a molecular system These may have a wide variety of analytical forms with some basis in chemical physics which must be parameterised to give the correct energy and forces A huge variety of forms is possible and for this reason the DL_POLY_4 force field is designed to be adaptable While it is not supplied with its own force field parameters many of the functions familiar to GROMOS 18 Dreiding 19 and AMBER 20 users have been coded in the package as well as less familiar forms In addition DL_POLY_4 retains the possibility of the user defining additional potentials In DL_POLY 4 the total configuration energy of a molecular system may be written as Nshel U r Popes N 5 Ushet ishel Vcore Esheit ishel 1 Nteth Y Usetn ten Ti rt o tteth 1l Noond 5 Ubona ibond Pas Tp lbond 1 Nangi y Uangl angl Tab fe iangl 1 Ndiha 5 Uaihalidihd Tas Tb Tcs Ta idiha l Ninv Ne Uinv limot Tarlo Ve ra linv 1 4 y y Ss vdw electostatics TG j Ir r sl 2 1 i 1 g gt i N N N Y Y Y Vtersos yl i j k r Ti rt Th i 1 ffi Aj N 2N 1 N 5 Y Y tea j k r Tis Ti f Th i 1 j
300. in the FIELD file DL POLY_4 does not calculate contributions to the virial or the stress tensor arising from the constraints required to freeze atomic positions Neither does it calculate contributions from intra and inter molecular interactions between frozen atoms As with the tethering potential the reference position of a frozen site is scaled with the cell vectors in constant pressure simulations In the case of frozen rigid bodies their centre of mass is scaled with the cell vectors in constant pressure simulations and the positions of their constituent sites are then moved accordingly In DL_POLY 4 the frozen atom option is handled by the subroutine FREEZE_ATOMS The rigid body dynamics see Section 3 6 is resolved by solving the Eulerian equations of rotational motion However their statics includes calculation of the individual contributions of each RB s centre of mass stress and virial due to the action of the resolved forces on sites atoms constituting it These contribute towards the total system stress and pressure 55 STFC Section 2 8 As seen in Section 2 5 core shell units are dealt with i kinetically by the adiabatic shell model or ii statically by the dynamic shell model Both contribute to the total system stress pressure but in different manner The former does it via the kinetic stress energy and atomic stress potential energy due to the core shell spring The latter via atomic stress potential ener
301. inds_f90 0 setup_module o site_module o inversions_forces o comms_module o config_module o inversions_module o kinds_f90 0 setup_module o inversions_module o kinds_f90 o setup_module o inversions_table_read o comms_module o inversions_module o kinds_f90 0 parse_module o setup_module o site_module o io_module o comms_module o kinds_f90 o netcdf_modul o kim_modul o comms_module o kinds_f90 o setup_module o kinetic_module o comms_module o config_module o kinds_f90 o0 rigid_bodies_module o setup_module o langevin_forces o config_module o kinds_f90 o setup_module o site_module o langevin_module o kinds_f90 o setup_module o link_cell_pairs o comms_module o config_module o development_module o domains_module o kinds_f90 o setup_module o link_cell_pair o comms_module o config_module o development_module o domains_module o kinds_f90 o setup_module o link_cell pairs o comms_module o config_module o development_module o domains_module o kinds_f90 o setup_module o link cell_pairs o comms_module o config_module o development_module o domains_module o kinds_f90 o setup_module o metal_forces o config_module o kinds_f90 o metal_module o setup_module o site_module o metal_generate o kinds_f90 o metal_module o setup_module o site_module o metal_1d_collect_eam o config_module o kinds_f90 o metal_module o setup_module o site_module o metal_1d_collect_fst o config_module o kinds_f90 o metal_module o 216 S
302. ing sequences and decreases error proneness in programming as subroutines must define what they use and from which module To decrease error proneness further arguments that are passed in calling sequences of functions or subroutines have defined intent i e whether they are to be e passed in only Intent In the argument is not allowed to be changed by the routine e passed out only Intent Out the coming in value of the argument is unimportant e passed in both directions in and out Intent InOut the coming in value of the argument is important and the argument is allowed to be changed 1 3 3 Memory Management DL POLY 4 exploits the dynamic array allocation features of FORTRAN9O to assign the necessary array dimensions STFC Section 1 3 1 3 4 Target Platforms DL_POLY _4 is intended for distributed memory parallel computers Compilation of DL_POLY_4 in parallel mode requires only a FORTRAN90 compiler and Message Passing Interface MPI to handle communications Compilation of DL_POLY 4 in serial mode is also possible and requires only a FORTRAN9O compiler 1 3 5 Internal Documentation All subroutines are supplied with a header block of FORTRAN90 comment records giving 1 The name of the author and or modifying author 2 The version number or date of production 3 A brief description of the function of the subroutine Aa A copyright statement Elsewhere FORTRAN90 comment cards are use
303. ion at 300 K and 0 atmosphere is maintained in an Evans NVT isokinetic ensemble These systems consist of 32 000 and 256 000 particles respectively 8 1 24 Test Case 47 and 48 Hexane and methanol melts full atomistic and coarse grained simulations TEST47 and TEST48 contain a Hexane and a Methanol melts respectively 1000 molecules each modelled by the OPLSAA force field FF Each system is also supplied in a CG mapped representation as converted by VOTCA http www votca org or DL CCGMAP http www ccp5 ac uk projects ccp5_cg shtml These test cases are to exemplify the Coarse Graining CG procedure see Chapter 4 including FA to CG mapping and obtaining the PMF data by means of Boltzmann Inversion 87 As a result DL POLY_4 could be used for simulating a CG system with numerically defined tabulated FFs see TABBND TABANG TABDIH and TABINV files for intra molecular potentials and TABLE for inter molecular short range VDW potentials Both tests are also available as parts of the tutorial cases from the VOTCA package 88 Therefore the CONFIG CONTROL and FIELD input files are fully consistent with the corresponding setup files found in the VOTCA tutorial directories csg tutorials hexane and csg tutorials methanol 8 2 Benchmark Cases DL_POLY_4 benchmark test cases are available to download them from the CCP5 FTP server as follows FTP site ftp dl ac uk Username anonymous Password your email address D
304. ion name record 2 string as energy units 175 OSTFC Data records Subsequent lines contain the instantaneous values of statistical variables dumped from the array stpval A specified number of entries of stpval are written in the format 1p 5e14 6 The number of array elements required determined by the parameter mxnstk in the SETUP_MODULE file is mxnstk gt 27 ntpatm number of unique atomic sites 9 stress tensor elements 9 if constant pressure simulation requested The STATIS file is appended at intervals determined by the stats directive in the CONTROL file The energy unit is as specified in the FIELD file with the units directive and are compatible with the data appearing in the OUTPUT file The contents of the appended information is record i nstep integer time real nument integer record ii stpval 1 stpval 5 engcns real temp real engcfg real engsrc real engcpe real record iii stpval 6 stpval 10 engbnd real engang real engdih real engtet real enthal real record iv stpval 11 stpval 15 tmprot real vir real virsrc real vircpe real virbnd real record v stpval 16 stpval 20 virang real vircon real virtet real volume real tmpshl real record vi stpval 21 stpval 25 engshl real virshl real alpha real beta real gamma real record vii stpval 26 stpval 27 virpmf real press real the next ntpatm entries amsd 1 real current MD time step elapsed sim
305. irec tive is invoked VDWPMF amp VDWTAB both containing the data for potentials of mean force and the corresponding virials calculated based on the obtained RDF s i e PMF In RDF in the energy units specified in the FIELD file These files have a simple three column format the same as that used for PMF files in the case of bonded units see Section 4 2 The purpose of these files is to provide the user with means of setting up a PMF based force field for example in the case of initial coarse graining of an atomistic system In particular one can convert the VDWTAB file into a correctly formatted TABLE file 173 STFC Section 6 2 Section 6 1 6 by using the utility called pmf2tab f subject to compilation found in DL_POLY_4 directory utility as follows userChost pmf2tab exe lt VDWTAB see Section 4 1 for completeness 6 2 10 The ZDNDAT File This is a formatted file containing the Z density data Its contents are as follows record 1 cfigname a72 configuration name record 2 ntpatm integer number of unique atom types profiled in file mxgrdf integer number of grid points in the Z density function There follow the data for each individual Z density function i e ntpatm times The data supplied are as follows first record atname a8 unique atom name following records mzgrdf records z real distance in z direction A p z real Z density at given height z Note the ZDNDAT file is optional and appears wh
306. irectory ccp5 DL_POLY DL_POLY_4 0 BENCH The DL_POLY_4 authors provide these on an AS IS terms For more information refer to the README txt file within 197 Appendix A DL_POLY 4 Periodic Boundary Conditions Introduction DL_POLY_4 is designed to accommodate a number of different periodic boundary conditions which are defined by the shape and size of the simulation cell Briefly these are as follows which also indicates the IMCON flag defining the simulation cell type in the CONFIG file see Section 6 1 2 1 None e g isolated polymer in space imcon 0 2 Cubic periodic boundaries imcon 1 3 Orthorhombic periodic boundaries imcon 2 4 Parallelepiped periodic boundaries imcon 3 5 Slab X Y periodic Z non periodic imcon 6 We shall now look at each of these in more detail Note that in all cases the cell vectors and the positions of the atoms in the cell are to be specified in Angstroms A No periodic boundary imcon 0 Simulations requiring no periodic boundaries are best suited to in vacuuo simulations such as the confor mational study of an isolated polymer molecule This boundary condition is not recommended for studies in a solvent since evaporation is likely to be a problem Note this boundary condition have to be used with caution DL_POLY_4 is not naturally suited to carry out efficient calculations on systems with great fluctuation of the local density in space as is the case for clust
307. it Message 103 error parameter mxlshp exceeded in pass_shared_units Various algorithms constraint and core shell ones require that information about shared atoms be passed between nodes If there are too many such atoms the arrays holding the information will be exceeded and DL_POLY_4 will terminate execution Action Use densvar option in CONTROL to increase mx1shp alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 104 error arrays listme and lstout exceeded in pass_shared_units This should not happen Dimensions of indicated arrays have been exceeded Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Message 105 error shake algorithm constraints_shake failed to converge The SHAKE algorithm for bond constraints is iterative If the maximum number of permitted iterations is exceeded the program terminates Possible causes include a bad starting configuration too large a time step used incorrect force field specification too high a temperature inconsistent constraints over constraint etc Action You may try to increase the limit of iteration cycles in the constraint subroutines by using the directive mxshak and or decrease the constraint precision by using the directive shake in CONTROL But the trouble may be much more likely to be cured by careful consideration of the physical system being simulated For example is the syst
308. it is therefore essential to supply a correct e mail address The data and bench subdirectories of DL_POLY_4 are not issued in the standard package but can be downloaded directly from the FTP site in the ccp5 DL POLY DL_ POLY 4 0 directory Note Daresbury Laboratory is the sole centre for the distribution of DL_POLY_4 and copies obtained from elsewhere will be regarded as illegal and will not be supported 1 6 OS and Hardware Specific Ports Note that no support is offered for these highly specific developments 1 7 Other Information The DL_POLY website http www ccp5 ac uk DL POLY provides additional information in the form of 1 Access to all documentation including licences 2 Frequently asked questions 3 Bug reports 4 Access to the DL_POLY online forum Daresbury Laboratory also maintains a DL_POLY_4 associated electronic mailing list dl_poly_4_news to which all registered DL_POLY_4 users are automatically subscribed It is via this list that error reports and announcements of new versions are made If you are a DL_POLY_4 user but not on this list you may request to be added by sending a mail message to majordomo dl ac uk with the one line message subscribe dl_poly 4_news The DL POLY Forum is a web based centre for all DL_POLY users to exchange comments and queries You may access the forum through the DL_POLY website A registration and vetting process is required before you can use the forum but it is open
309. ithin the concept of the Velocity Verlet integration scheme It consists of two parts RATTLE_VV1 and RATTLE_VV2 applied respectively in stages one and two of Velocity Verlet algorithm RATTLE_VV1 is similar to the SHAKE algorithm as described above and handles the bond length constraint However due to the difference in the velocity update between VV VV1 and LFV schemes the constraint force generated to conserve the bondlength in RATTLE_VV1 has the form as in 3 16 but missing the factor of a half ng Hij di F dj de hj At2 di di 4 3 17 The constraint force in RATTLE_VV2 imposes a new condition of rigidity on constraint bonded atom velocities RATTLE_VV2 is also a two stage algorithm In the first stage the VV2 algorithm calculates the velocities of the atoms in the system assuming a complete absence of the rigid bond forces since forces have just been recalculated afresh after VV1 The relative velocity of atom i with respect to atom j or vice versa constituting the rigid bond ij may not be perpendicular to the bond i e may have a non zero component along the bond However by the stricter definition of rigidity this is is required to be zero as it will otherwise lead to a change in the rigid bond length during the consequent timestepping In the second stage the deviation from zero of the scalar product d v v is used retrospectively to compute the constraint force needed to keep the bond rigid over the length of the
310. itten by the subroutine RSD_WRITE The control variables for this file are lrsd nsrsd isrsd and rrsd which are created internally based on information read from the displacements directive in the CONTROL file see Section 6 1 1 The RSDDAT file will be created only if the directive defects appears in the CONTROL file The RSDDAT file may become very large especially if it is formatted For serious simulation work it is recommended that the file be written to a scratch disk capable of accommodating a large data file The RSDDAT has the following structure record 1 header a72 file header record 2 rdef real displacement qualifying cutoff A in last frame frame integer number configuration frames in file records integer number of records in file For timesteps greater than nsrsd the RSDDAT file is appended at intervals specified by the displacements directive in the CONTROL file with the following information for each configuration record i timestep a8 the character string timestep nstep integer the current time step tstep real integration timestep ps time real elapsed simulation time ps imcon integer periodic boundary key see Table 6 6 rrsd real displacement qualifying cutoff A record ii 168 STFC Section 6 2 displacements al3 the character string displacements nrsd integer the total number of displacements record iii cell 1 real x component of a cell vector cell 2 real y component of a cell vec
311. j and keytrj which are created internally based on information read from the traj directive in the CONTROL file see Section 6 1 1 The HISTORY file will be created only if the directive traj appears in the CONTROL file The HISTORY file can become very large especially if it is formatted For serious simulation work it is recommended that the file be written to a scratch disk capable of accommodating a large data file Alternatively the file may be written in netCDF format instead of in ASCII users must change ensure this functionality is available which has the additional advantage of speed The HISTORY has the following structure record 1 header a72 file header record 2 keytrj integer trajectory key see Table 6 1 in last frame imcon integer periodic boundary key see Table 6 6 in last frame megatm integer number of atoms in simulation cell in last frame frame integer number configuration frames in file records integer number of records in file For timesteps greater than nstraj the HISTORY file is appended at intervals specified by the traj directive in the CONTROL file with the following information for each configuration record i timestep a8 the character string timestep nstep integer the current time step megatm integer number of atoms in simulation cell again keytrj integer trajectory key again imcon integer periodic boundary key again tstep real integration timestep ps time real elapsed simulation time ps
312. l distribution functions RDFs Z density profiles and job timing data The OUTPUT file is human readable Also present will be the restart files REVIVE Section 6 2 8 and REVCON Section 6 2 7 REVIVE contains the accumulated data for a number of thermodynamic quantities and RDFs and is intended to be used as the input file for a following run It is not human readable The REVCON file contains the restart configuration i e the final positions velocities and forces of the atoms when the run ended and is human readable The STATIS file Section 6 2 13 contains a catalogue of instantaneous values of thermodynamic and other variables in a form suitable for temporal or statistical analysis Finally the HISTORY file Section 6 2 1 provides a time ordered sequence of configurations to facilitate further analysis of the atomic motions By default this file is formatted human readable but with little effort from the user it can be generated unformatted You may move these output files back into the data sub directory using the store macro found in the execute sub directory Lastly DL_POLY_4 may also create the files RDFDAT ZDNDAT MSDTMP RSDDAT and DEFECTS containing the RDF Z density individual means square displacement and temperature RSD and defects data respectively They are all human readable files 5 2 3 Parallel I O Many users that have suffered loss of data in the OUTPUT especially running in parallel and when an error occurs on par
313. l vector na real cell 9 real z component of c cell vector 177 Chapter 7 The DL_POLY 4 Parallelisation and Source Code Scope of Chapter This chapter we discuss the DL_POLY_4 parallelisation strategy describe the principles used in the DL_POLY_4 modularisation of the source code and list the file structure found in the source subdirectory 178 STFC Section 7 1 7 1 Parallelisation DL_POLY_4 is a distributed parallel molecular dynamics package based on the Domain Decomposition parallelisation strategy 2 3 9 10 5 6 In this section we briefly outline the basic methodology Users wishing to add new features DL_POLY_4 will need to be familiar with the underlying techniques as they are described in the above references 7 1 1 The Domain Decomposition Strategy The Domain Decomposition DD strategy 2 3 5 is one of several ways to achieve parallelisation in MD Its name derives from the division of the simulated system into equi geometrical spatial blocks or domains each of which is allocated to a specific processor of a parallel computer I e the arrays defining the atomic coordinates r velocities v and forces f for all N atoms in the simulated system are divided in to sub arrays of approximate size N P where P is the number of processors and allocated to specific processors In DL_POLY_4 the domain allocation is handled by the routine DOMAINS_MODULE and the decision of approximate sizes of various bookkee
314. l3 the character string interstitials ni integer the total number of interstitials vacancies a9 the character string vacancies nv integer the total number of vacancies record iii cell 1 real x component of a cell vector cell 2 real y component of a cell vector cell 3 real z component of a cell vector record iv cell 4 real x component of b cell vector cell 5 real y component of b cell vector cell 6 real z component of b cell vector record v cell 7 real x component of c cell vector cell 8 real y component of c cell vector cell 9 real z component of c cell vector 167 STFC Section 6 2 This is followed by the ni interstitials for the current timestep as each interstitial has the following data lines record a atmnam al0 i_atomic label from CONFIG iatm integer atom index from CONFIG record b XXX real x coordinate yyy real y coordinate ZZZ real z coordinate This is followed by the nv vacancies for the current timestep as each vacancy has the following data lines record a atmnam al0 v_atomic label from REFERENCE iatm integer atom index from REFERENCE record b XXX real x coordinate from REFERENCE yyy real y coordinate from REFERENCE ZZZ real z coordinate from REFERENCE 6 2 4 The RSDDAT File The RSDDAT file is the dump file of atomic coordinates of atoms that are displaced from their original position at t 0 farther than a preset cutoff Its principal use is for off line analysis The file is wr
315. l_relax o zero_k_optimise o vaf_collect o nvt_e0_scl o nvt_el_scl o nvt_b0_scl o nvt_b1_scl o pseudo_vv o 240 STFC Appendix C constraints_shake_vv o pmf_shake_vv o constraints_rattle o pmf_rattle o nvt_h0_scl o nvt_gO_scl o npt_h0_scl o nst_h0_scl o A nve_0_vv o nvt_e0_vv o nvt_10_vv o nvt_a0_vv o nvt_b0_vv o nvt_h0_vv o nvt_g0_vv o npt_10_vv o npt_b0_vv o npt_h0_vv o npt_m0_vv o nst_10_vv o nst_b0_vv o nst_h0_vv o nst_m0_vv o nvt_hi_scl o nvt_g1_scl o npt_hi_scl o nst_hi_scl o A nve_1_vv o nvt_el_vv o A nvt_li_vv o nvt_al_vv o nvt_b1_vv o nvt_hi_vv o nvt_gi_vv o npt_li_vv o npt_b1_vv o npt_h1_vv o npt_mi_vv o nst_li_vv o nst_b1_vv o nst_hi_vv o nst_mi_vv o pseudo_lfv o constraints_shake_lfv o pmf_shake_lfv o nve_0_lfv o nvt_e0_lfv o nvt_10_1fv o nvt_a0_lfv o nvt_bO_lfv o nvt_h0_lfv o nvt_g0_lfv o npt_10_lfv o npt_bO_lfv o npt_h0_1lfv o npt_m0_lfv o nst_10_lfv o nst_bO_lfv o nst_hO_lfv o nst_m0_lfv o nve_1_lfv o nvt_el_lfv o nvt_li_lfv o nvt_al_lfv o nvt_b1_lfv o nvt_h1_lfv o nvt_gi_lfv o npt_11_1fv o npt_b1_lfv o npt_hi_lfv o npt_mi_lfv o A nst_li_lfv o nst_b1_l1lfv o nst_hi_lfv o nst_m1_lfv o xscale o core_shell_kinetic o regauss_temperature o z_density_collect o statistics_collect o statistics_connect_set o statistics_connect_spread o statistics_connect_frames o system_revive o rdf_compute o z_density_compute o vaf_compute o bonds_compute o
316. latform supports it and make sure it is allowed for in the MPI implementation If all is OK then the code must be recompiled e MPI module MPI_MODULE The MPI module implements all MPI functional calls used in DL_POLY_4 It is only used when DL_POLY 4 is to be compiled in serial mode e communication module COMMS_MODULE MPI_MODULE The communication module defines MPI related parameters and develops MPI related functions and subroutines such as initialisation and exit global synchronisation sum maximum and minimum node ID and number of nodes simulation time It is dependent on KINDS_F90 and on MPI_MODULE if MPI is emulated for DL_POLY_4 compilation in serial mode The MPI_MODULE implements all MPI functional calls used in DL POLY_4 e global parameters module SETUP_MODULE The global parameters module holds all important global variables and parameters see above It is dependent on KINDS_F90 e parse module PARSE_MODULE 184 STFC Section 7 2 The parse module develops several methods used to deal with textual input get_line strip_blanks lower_case get_word word_2 real Depending on the method dependencies on KINDS_F90 COMMS_MODULE SETUP_MODULE DOMAINS_MODULE are found e development module DEVELOPMENT_MODULE The development module contains several methods used to help with testing and debugging DL_POLY_4 Depending on the method dependencies on KINDS_F90 COMMS_MODULE SETUP_MODULE DOMAINS_MODULE are found e I
317. ld electrostatics o o RANo ewald evaluate or multiple are not mutually exclusive and it is the first instance of these in CON TROL that is read and applied in the following simulation The choice of reaction field electrostatics directive reaction relies on the specification of the relative dielectric constant external to the cavity This is specified by the eps directive The directive ewald spme evaluate is only triggered when ewald spme sum precision is present It sets an infrequent evaluation of the k space contributions to the Ewald summation Although this option decreases the simulation cost it also inherently decreases the accuracy of the dynamics Note that the usage of this feature may lead to inacuarte or even wrong and unphysical dynamics as the less frequent the evaluation the greater the inacuarcy DL_POLY_4 uses two different potential cutoffs These are as follows a reut the universal cutoff set by cutoff It applies to the real space part of the electrostatics calculations and to the van der Waals potentials if no other cutoff is applied b ryaw the user specified cutoff for the van der Waals potentials set by rvdw If not specified its value defaults to reut Constraint algorithms in DL POLY 4 SHAKE RATTLE see Section 3 2 use default iteration pre cision of 107 and limit of iteration cycles of 250 Users may experience that during optimisation of a new built system containing constraints sim
318. le non linear elastic FENE potential 33 34 35 fene _ 2 _ ri Ay eo uri lt 4 205 k R2 In 1 m Iry A lt Ro 2 10 CO ge A Z Ro The FENE potential is used to maintain the distance between connected beads and to prevent chains from crossing each other It is used in combination with the WCA equation 2 94 potential to create a potential well for the flexible bonds of a molecule that maintains the topology of the molecule This implementation allows for a radius shift of up to half a Ro A lt 0 5 Ro with a default of zero Adefault 0 10 AMOEBA force field bond potential 36 amoe U rig k rig ro 1 2 55 rij ro 7 12 2 55 rij ro 2 11 11 Tabulated potential tab The potential is defined numerically in TABBND see Section 4 3 and Section 6 1 8 In these formulae r is the distance between atoms labelled and j Tij Ir 2 12 where ry is the position vector of an atom labelled The force on the atom j arising from a bond potential is obtained using the general formula 0 i E ty gt 2 13 Tij Note some DL_POLY_4 routines may use the convention that Tij T rj 14 STFC Section 2 2 The force f acting on atom 7 is the negative of this The contribution to be added to the atomic virial is given by W Pij T gt 2 14 with only one such contribution from each bond The contribution to be added to the atomic stress t
319. lies the use of appropriate boundary conditions This error re sults if the user specifies octahedral or dodecahedral boundary conditions which are only available in DL_POLY_Classic Action Correct your boundary condition or consider using DL POLY_Classic Message 305 error too few link cells per dimension for many body and tersoff forces sub routines The link cells algorithms for many body and tersoff forces in DL_POLY_4 cannot work with less than 3 secondary link cells per dimension This depends on the cell size widths as supplied in CONFIG and the largest system cut off as specified in CONTROL although it may be drawn or overridden by cutoffs specified as part of some potentials parameter sets in FIELD Action Decrease many body and tersoff potentials cutoffs or and number of nodes or and increase system size Message 307 error link cell algorithm violation DL_POLY_4 does not like what you are asking it to do Probable cause the cutoff is too large to use link cells in this case Action Rethink the simulation model reduce the cutoff or and number of nodes or and increase system size Message 308 error link cell algorithm in contention with SPME sum precision DL_POLY_4 does not like what you are asking it to do Probable cause you ask for SPME precision that is not achievable by the current settings of the link cell algorithm Action Rethink the simulation model reduce number of nodes or and SP
320. lised in the rigid body and changes as the rigid body rotates Thus the local body frame is taken to be that in which the rotational inertia tensor 1 is diagonal and the components satisfy y gt yy gt Izz In this local frame the so called Principal Frame the inertia tensor is therefore constant The orientation of the local body frame with respect to the space fixed frame is described via a four dimensional unit vector the quaternion q do q1 92 qa gt 3 183 and the rotational matrix R to transform from the local body frame to the space fixed frame is the unitary matrix R 2 q q2 qo 93 a 93 43 2 42 93 90 91 3 184 2 q1 93 9042 2 9243 40 901 G G GBt G so that if d is the position of an atom in the local body frame with respect to its COM its position in the universal frame w r t its COM is given by d R d 3 185 Fann 2 q q2 qo 93 2 q 93 qo a With these variables defined we can now consider the equations of motion for the rigid body unit 3 6 2 Integration of the Rigid Body Equations of Motion The equations of translational motion of a rigid body are the same as those describing the motion of a single atom except that the force is the total force acting on the rigid body i e F in equation 3 177 and the mass is the total mass of the rigid body unit i e M in equation 3 172 These equations can be integrated by the standard Verlet LFV or VV algorithms described in th
321. lloy numpot is e n n 5 2 for the EAM potential or e 3n n 1 2 for the EEAM potential or e n n 4 for the 2BEAM potential or e 5n n 1 2 for the 2BEEAM potential The subsequent records for an n component alloy define n n 1 2 cross pair potential functions pairs keyword and EAM n embedding functions one for each atom type embedding keyword n electron density functions one for each atom type density keyword EEAM n embedding functions one for each atom type and n for the EEAM potential one for each non commuting pair of atoms types 2BEAM n s band embedding functions one for each atom type sembedding keyword n n 1 2 s band density functions one for each cross pair of atoms types sdensity keyword n d band embedding functions one for each atom type dembedding or embeedding keyword and n d band density functions one for each atom types ddensity or density keyword 2BEEAM n s band embedding functions one for each atom type sembedding keyword n s band density functions one for each non commuting pair of atoms types sdensity keyword n d band embedding functions one for each atom type dembedding or embeedding keyword and n d band density functions one for each non commuting pair of atoms types ddensity or density keyword The functions may appear in any random order in TABEAM as their identification is based on their unique keyword defined first in the function s header record
322. local changes 7 1 3 Distributing the Non bonded Terms DL_POLY_4 calculates the non bonded pair interactions using the link cell algorithm due to Hockney and Eastwood 82 In this algorithm a relatively short ranged potential cutoff reut is assumed The simulation cell is logically divided into so called link cells which have a width not less than or equal to the cutoff distance It is easy to determine the identities of the atoms in each link cell When the pair interactions are calculated it is already known that atom pairs can only interact if they are in the same link cell or are in link cells that share a common face Thus using the link cell address of each atom interacting pairs are located easily and efficiently via the link list that identifies the atoms in each link cell So efficient is this process that the link list can be recreated every time step at negligible cost For reasons partly historical the link list is used to construct a Verlet neighbour list 22 The Verlet list records the indices of all atoms within the cutoff radius reut of a given atom The use of a neighbour list is not strictly necessary in the context of link cells but it has the advantage here of allowing a neat solution to the problem of excluded pair interactions arising from the intramolecular terms and frozen atoms see below In DL_POLY_4 the neighbour list is constructed simultaneously on each node using the DD adaptation of th
323. low parameter value function pi 3 14159265358979312 m constant twopi 6 28318530717958623 27 constant fourpi 12 56637061435917246 47 constant sqrpi 1 772453850905588 YT constant rtwopi 0 15915494309189535 constant 42 1 41421356237309515 Y2 constant rt3 1 73205080756887719 2 3 constant r4pie0 138935 4835 electrostatics conversion factor to internal units i e Ge boltz 0 831451115 Boltzmann constant in internal units prsunt 0 163882576 conversion factor for pressure from internal units to katms nread 5 main input channel nconf 11 configuration file input channel nfield 12 force field input channel ntable 13 tabulated potentials file input channel nrefdt 14 reference configuration input channel nrite 6 main output channel nstats 21 statistical data file output channel nrest 22 output channel accumulators restart dump file nhist 23 trajectory history file channel ndefdt 24 output channel for defects data file nrdfdt 25 output channel for RDF data nzdfdt 26 output channel for Z density data file nrsddt 27 output channel for displacements data files npdfdt 28 output channel for raw PDF files ngdfdt 29 output channel for normalised RDF data files seed 1 3 variable pair of seeds for the random number generator lseed variable logical swich on off indicator for seeding mxsite variable max number of molecular sites mxatyp variable max number of unique atomic types mxtmls variable max number of unique molecule types m
324. m is represented by a massive core and massless shell connected by a harmonic spring hereafter called the core shell unit The core and shell carry different electric charges the sum of which equals the charge on the original atom There is no electrostatic interaction i e self interaction between the core and shell of the same atom Non coulombic interactions arise from the shell alone The core shell interaction is described by a harmonic spring potential of the form 1 Uspring Taj 7 keris gt 2 227 However sometimes an anharmonic spring is used described by a quartic form l 2 lp 4 Uspring Tij 5 hari gei 2 228 Normally in practice kg is much larger than k4 The effect of an external electric field E is to separate the core and shell by a distance d qsE kz 2 229 giving rise to a polarisation dipole p qsd 2 230 The condition of static equilibrium then gives the polarisability as where qs is the shell charge and k is the force constant of the harmonic spring The calculation of the forces virial and stress tensor in this model is based on that for a diatomic molecule with charged atoms The part coming from the spring potential is similar in spirit as for chemical bonds equations 2 13 2 15 while the electrostatics is as described in the above section The relationship between the kinetic energy and the temperature is different however as the core shell unit is permitted only three translational
325. m will be thermostatted and the impact energy dissipated during the equilibration The pseudo option is intended to be used in highly non equilibrium simulations when users are primarily interested in the structural changes in the core of the simulated system as the the MD cell boundaries of the system are coupled to a thermal bath The thermal bath can be used with two types of temperature scaling algorithms i Langevin stochas tic thermostat ii Gauss and iii Direct direct thermostat If no type is specified then the Langevin temperature control algorithm is applied first followed the Direct one The user is also re quired to specify the width of the pseudo thermostat f in A which must be larger than 2 A and less than or equal to a quarter of minimum width of the MD cell The thermostat is an f thick buffer layer attached on the inside at the MD cell boundaries The temperature of the bath is specified by the user T f in Kelvin which must be larger than 1 Kelvin If none is supplied by the user T defaults to the system target temperature e pseudo langevin The stochasticity of the Langevin thermostat emulates an infinite environment around the MD cell providing a means for natural heat exchange between the MD system and the heath bath thus aiding possible heat build up in the system In this way the instantaneous temperature of the system is driven naturally towards the bath temperature Every particle within
326. me steps used in the collection of statistics is given Then the averages over the production portion of the run are given for the variables described in the previous section The root mean square variation in these variables follow on the next two lines The energy and pressure units are as for the preceding section Also provided in this section are estimates of the diffusion coefficient and the mean square displacement for the different atomic species in the simulation These are determined from a single time origin and are therefore approximate Accurate determinations of the diffusion coefficients can be obtained using the MSD utility program which processes the HISTORY file see DL_POLY Classic User Manual If an NPT NaT simulation is performed the OUTPUT file also provides the mean pressure stress tensor and mean simulation cell vectors In case when extended NT ensembles are used then further mean x y plain area and mean surface tension are also displayed in the OUTPUT file 6 2 6 9 Radial Distribution Functions If both calculation and printing of radial distribution functions have been requested by selecting directives rdf and print rdf in the CONTROL file radial distribution functions are printed out This is written from the subroutine RDF_COMPUTE First the number of time steps used for the collection of the histograms is stated Then each pre requested function is given in turn For each function a header line states the atom t
327. met 4 2BEAM density correction No long ranged corrections apply beyond ret 5 Finnis Sinclair density correction No long ranged corrections apply beyond cutoffs c and d 6 Extended Finnis Sinclair density correction No long ranged corrections apply beyond cutoffs c and d 7 Sutton Chen density correction AnD 3 m 3 Sp ol sd y 2 135 m 3 Tmet 35 STFC Section 2 3 8 Gupta density correction 27 Pro Opi 2 r r Tr r Tet 2rmet 2 2 2 exp 20 229 A 2 136 ij ij 9 Many body perturbation component density correction dij Arp a dp p m 2 137 The density correction is applied immediately after the local density is calculated The pair term correction is obtained by analogy with the short ranged potentials and is Ui D rij i l A N Tij lt Tmet 1 N ij2Tmet Ur gt D 5 Vij riz E 5 Vij rij U U i l A i 1 jfi U 27Np Vij r r dr N me Uz Y F p 6pi 2 138 i 1 N N Us Y F 7 O 6p U 6U2 i 1 i gt i Pi 6U 4r py ee a pijlr r dr Pea Note that 9U2 is not required if p has already been corrected Evaluating the integral part of the above equations yields 1 EAM energy correction No long ranged corrections apply beyond ret 2 EEAM energy correction No long ranged corrections apply beyond ret 3 2BEAM energy correction No long ranged corrections apply beyond ret 4 2BEEAM energy correction No long
328. mine FIELD for erroneous directives correct and resubmit Message 640 error too many rigid body units per domain DL_POLY_4 limits the number of rigid body units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action 282 STFC Appendix D Use densvar option in CONTROL to increase mxrgd alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 642 error rigid body unit diameter gt rcut the system cutoff DL_POLY_4 domain decomposition limits the size of a RB to a largest diagonal lt system cutoff I e the largest RB type is still within a linked cell volume Action Increase cutoff Message 644 error overconstrained rigid body unit This is a very unlikely message which usually indicates a corrupted FIELD file or unphysically overcon strained system Action Decrease constraint on the system Examine FIELD for erroneous directives if any correct and resubmit Message 646 error overconstrained constraint unit This is a very unlikely message which usually indicates a corrupted FIELD file or unphysically overcon strained system Action Decrease constraint on the system Examine FIELD for erroneous directives if any correct and resubmit Message 648 error quaternion setup failed This error indicates that the routine Q SETUP has failed i
329. mixing fender for the Fender Halsey type of mixing hogervorst for the Hogervorst good hope type of mixing halgren for the Halgren HHG type of mixing tang for the Tang Toennies type of mixing functional for the Functional type of mixing The mixing formulae can be found in Section 2 3 1 apply a force shifting procedure to all van der Waals potentials except the shifted force n m potential so that the VDW interactions energy and force contributions fall to zero smoothly for distances approaching reut calculate and collect the Z density profile every f timesteps default f 1 perform zero temperature MD run reset target system temperature 10 Kelvin SPECIAL OPTIONS 130 STFC Section 6 1 l_scr l_ fast l rout l_rin l_his ltor 1 dis redirect OUTPUT file s contents to the OS s default output channel screen interactive abandon global safety checks which gives more speed to simulations run at too few link cells per domain regimes by abandoning global safety checks however in case of parallel failures no controlled manner termination will happen OS s feedback dependence write REVIVE in ASCII default is binary read REVOLD in ASCII default is binary generate a one frame HISTORY from CONFIG and terminate straight after abandon the production of REVIVE and REVCON check and report on the minimum separation distance between all Verlet neighbour list pairs at re start
330. mpilation in SERIAL mode Note that for the TR15581 compliance gfortran requires a gcc version 4 2 0 or above By default if the compilation process is successful then an executable build will be placed in execute directory at the same level as the source directory where the code is compiled Should the execute directory not exist then it will be created automatically by the Makefile script The build may then be moved renamed etc and used as the user wishes However when executed the program will look for input files in the directory of execution Compilation on Windows The best way to get around it is to install cygwin on the system http www cygwin com to emulate a UNIX Linux like environment and then use the make command During the cygwin installation please make sure that the make and gfortran components are specifically opted for components as they may not be included as default ones in the install A potential problem for Windows based FORTRAN compilers one may encounter is that the compiler may not pick symbolic links This can be resolved by substituting the soft links with hard in the Makefile For parallel compilation all openMPI components must also be opted for during the cygwin install Compiling with NetCDF functionality The targeted Makefile needs the following substitution within before attempting compilation netcdf_modul o gt netcdf_module o 296 STFC
331. mulated system Note that this will only work efficiently if the density of the system is reasonably uniform THERE ARE NO LOAD BALANCING ALGORITHMS IN DL_POLY_4 TO COMPENSATE FOR A BAD DENSITY DISTRIBUTION 7 1 2 Distributing the Intramolecular Bonded Terms The intramolecular terms in DL_POLY_4 are managed through bookkeeping arrays which list all atoms sites involved in a particular interaction and point to the appropriate arrays of parameters that define the potential Distribution of the forces calculations is accomplished by the following scheme 1 Every atom site in the simulated system is assigned a unique global index number from 1 to N 2 Every processor maintains a list of the local indices of the atoms in its domain This is the local atom list 3 Every processor also maintains a sorted in ascending order local list of global atom indices of the atoms in its domain This is the local sorted atom list 4 Every intramolecular bonded term U ype in the system has a unique index number itype from 1 to Ntype Where type represents a bond angle dihedral or inversion Also attached there with unique index numbers are core shell units bond constraint units PMF constraint units rigid body units and tethered atoms their definition by site rather than by chemical type 5 On each processor a pointer array keYtype Ntype itype Carries the indices of the specific atoms involved in the potential term labelled itype The
332. n echo echo FORTRAN9O compiler unspecified echo echo Please edit your Makefile entries echo exit 99 fi if test LD undefined then echo echo FORTRAN90 Linker loaDer unspecified echo echo Please edit your Makefile entries echo exit 99 fi mkdir p BINROOT touch dl_poly f90 Declare rules 90 0 FC FCFLAGS 90 Declare dependencies OBJ_ALL OBJ_MOD 232 STFC Appendix C Makefile SRL1 Master makefile for DL_POLY_4 06 serial version 1 Author 1 T Todorov June 2014 Define default settings SHELL bin sh SUFFIXES SUFFIXES 90 o BINROOT execute EX DLPOLY Z EXE BINROOT EX TYPE master FC undefined LD undef ined Define object files OBJ_MOD kinds_f90 o mpi_module o comms_module o setup_module o parse_module o development_module o netcdf_modul o io_module o domains_module o site_module o config_module o vnl_module o defects_module o defects1_module o vdw_module o metal_module o tersoff_module o three_body_module o four_body_module o kim_modul o A rdf_module o z_density_module o core_shell_module o constraints_module o pmf_module o rigid_bodies_module o tethers_module o bonds_module o angles_module o dihedrals_module o inversions_module o external_field_module o langevin_module o minimise_module o ewald_modul
333. n 0 corresponding to a dry run 129 STFC Section 6 1 temperature f set required simulation temperature to f Kelvin target temperature for constant temperature ensembles trajectory ij k write HISTORY file with controls i start timestep for dumping configurations default i 0 j timestep interval between configurations default 7 1 k data level default k 0 see Table 6 1 vaf sampling every i bin size n calculate and collect velocity autocorrelation function profiles timestep f variable timestep f vdw direct vdw mix rule vdw shift zden sampling every f Zero SPECIAL OPTIONS every i timesteps default 50 with a bin size set to n timesteps default n 2i if i ge 100 or n 100 otherwise set timestep to f ps variable timestep start with timestep of f ps enforces the direct calculation of van der Waals interactions defined by explicit potential forms i e it will not work for systems using tabulated potentials TABLE apply the mixing rule to all specified analytical single species van der Waals potential interactions to generate cross species interactions when i the latter has not already been specified ii single species potentials are available specified and of the same type and iii their type is allowed to mix i e of 12 6 or LJ or DPD or AMOE or WCA type The available mixing rules are as follows lorentz for the Lorentz Berthelot type of
334. n nvt langevin nvt berendsen nvt hoover npt langevin npt berendsen npt hoover npt mtk nst langevin nst berendsen nst hoover nst mtk are mutually exclusive though none is mandatory the default is the NVE ensemble These options are handled internally by the integer variable keyens The 132 STFC Section 6 1 9 10 Table 6 2 Internal Restart Key keyres meaning O start new simulation from CONFIG file and assign velocities from Gaussian distribution 1 continue current simulation 2 start new simulation from CONFIG file and rescale velocities to desired temperature 3 start new simulation from CONFIG file and do not rescale velocities meaning of this variable is explained in Table 6 3 The nst keyword is also used in the NoT ensembles extension to NP AT and NP yT ones Note that these semi isotropic ensembles are only correct for infinite interfaces placed perpendicularly to the z axis This means that the interface is homogenious unbroken and continuous in the x y plane of the MD cell which assumes that that two of the cell vectors have a cross product only in the z direction For example if the MD box is defined by its lattice vectors a b c then a x b 0 0 1 It is the users responsibility to ensure this holds for their model system Table 6 3 Internal Ensemble Key keyens meaning 0 Microcanonical ensemble NVE 1 Evans NVT ensemble NVExin 10 Lang
335. n Table 6 8 and Table 6 9 Note that VOTCA package is also capable of collecting both intra and inter molecular stats and producing correct TAB files provided the FIELD and HISTORY files exist albeit VOTCA saves the distributions in a format different from DAT files Below we summarise the sequence of operations the user has to follow in order to perform the CG distribution analysis and prepare the TAB files for a newly coarse grained system e Perform CG mapping of the original FA system with the aid of DL_CGMAP or VOTCA in the case of using VOTCA follow its manual the remainder of the list describes using DL_POLY_4 only e Move the data files for the newly CG mapped system FIELD CG CONFIG_CG HISTORY_CG into a separate directory under the standard names FIELD CONFIG HISTORY and create the corresponding CONTROL file containing the analysis and replay history directives e As no TAB files are yet available for the CG system at this stage one can either i create the initial TAB files padded with zeros or ii use a FIELD file with fictitious records for all the interactions to be tabulated with the interaction keywords and parameters chosen arbitrarily in accord with Table 6 8 Table 6 9 Table 6 10 and Table 6 11 Note that DL CGMAP as well as VOTCA creates FIELD_CG files that already contain interaction descriptors with the tab keyword s in place so if the route ii is chosen the user needs to replace those records wit
336. n o LDFLAGS GO 00 rm FC ftn c 212 STFC Appendix C FCFLAGS GO 00 rm EX EX BINROOT BINROOT TYPE Default code master message check 0BJ_MOD OBJ_ALL LD EXE LDFLAGS OBJ_MOD OBJ_ALL Message message echo DL_POLY_4 compilation in MPI mode echo echo Use mpi_module must change to Use mpi in comms_module f90 echo Check that a platform has been specified check if test FC undefined then echo echo FORTRAN9O compiler unspecified echo echo Please edit your Makefile entries echo exit 99 fi if test LD undefined then echo echo FORTRAN90 Linker loaDer unspecified echo echo Please edit your Makefile entries echo exit 99 fi mkdir p BINROOT touch dl_poly f90 Declare rules 90 0 FC FCFLAGS 90 Declare dependencies angles_compute o angles_module o comms_module o config_module o kinds_f90 o0 setup_module o site_module o angles_forces o angles_module o comms_module o config_module o kinds_f90 0 setup_module o angles_module o kinds_f90 o setup_module o angles_table_read o angles_module o comms_module o kinds_f90 0 parse_module o setup_module o site_module o bonds_compute o bonds_module o comms_module o config_module o kinds_f90 0 setup_module o site_module o bonds_forces o bonds_module o comms_module o c
337. n FIELD DL_POLY_4 has found a duplicate entry in the list Action Delete the duplicate line and resubmit Message 111 error bond constraint unit separation gt rcut the system cutoff This should never happen DL_POLY_4 has not been able to find an atom in a processor domain or its bordering neighbours Action Probable cause link cells too small Use larger potential cutoff Contact DL_POLY_4 authors Message 112 error only one constraints directive per molecule is allowed DL_POLY_4 has found more than one constraints entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit 262 STFC Appendix D Message 113 error intramolecular bookkeeping arrays exceeded in deport_atomic_data One or more bookkeeping arrays for site related interactions have been exceeded Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively you will need to print extra diagnostic data from the DEPORT_ATOMIC_DATA subroutine to find which boded like contribution has exceeded its assumed limit and then correct for it in SET_BOUNDS recompile and resubmit Message 114 error legend array exceeded in deport_atomic_data The array legend has been exceeded Action Try increasing parameter mxfix in SET_BOUNDS recompile and resubmit Contact DL POLY_4 authors if the problem persists Message 115 error transfer buffer exceeded in update_shared_units
338. n calculate and collect dihedrals PDF s every f timesteps default f 1 using a grid with n bins in the range 180 180 degrees analyse inversions sampling every f nbins n calculate and collect inversions PDFs binsize f cap forces f close time f collect coulomb cutoff f rcut f defects i j f every f timesteps default f 1 using a grid with n bins in the range 0 180 degrees set the bin size for radial and z density distribution functions to fA 105 lt f lt reu 4 or undefined f defaults to 0 05 A cap forces during equilibration period f is maximum cap in units of kgT default f 1000 kgT A set job closure time to f seconds include equilibration data in overall statistics calculate electrostatic forces using direct Coulomb sum set required long ranged interactions cutoff reut to f write defects trajectory file DEFECTS with controls i start timestep for dumping defects configurations 122 STFC Section 6 1 delr f rpad 4f densvar f distance displacements i j f dump n ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble ensemble nve nvt evans nvt langevin f nvt andersen fi f2 nvt berendesen f nvt hoover f nvt gst f f2 npt langevin f f2 npt berendsen fi fa npt hoover fi f2 default i 0 j timestep interval between configurations default j 1 f sit
339. n reproducing all the atomic positions in rigid units from the centre of mass and quaternion vectors it has calculated Action Check the contents of the CONFIG file DL POLY_4 builds its local body description of a rigid unit type from the first occurrence of such a unit in the CONFIG file The error most likely occurs because subsequent occurrences were not sufficiently similar to this reference structure If the problem persists increase the value of tol in Q SETUP and recompile If problems still persist double the value of dettest in RIGID_BODIES_SETUP and recompile If you still encounter problems contact the authors Message 650 error failed to find principal axis system This error indicates that the routine RIGID_BODIES_SETUP has failed to find the principal axis for a rigid unit Action This is an unlikely error DL POLY_4 should correctly handle linear planar and 3 dimensional rigid units There is the remote possibility that the unit has all of its mass bearing particles frozen while some of the massless are not or the unit has just one mass bearing particle Another more likely possibility in case of linear molecules is that the precision of the coordinates of these linear molecules constituentsi as produced by the user is not good enough which leads DL_POLY_4 to accepting it as non linear while in fact it is and then failing at the current point It is quite possible despite considered as wrong practice that the user
340. nctions In this section we catalogue and describe the forms of potential function available in DL_POLY_4 The keywords required to select potential forms are given in brackets before each definition The derivations of the atomic forces virial and stress tensor are also outlined 2 2 1 Bond Potentials Figure 2 1 The interatomic bond vector The bond potentials describe explicit chemical bonds between specified atoms They are all functions of the interatomic distance Only the coulomb potential makes an exception as it depends on the charges of the specified atoms The potential functions available are as follows 1 Harmonic bond harm U rig 5k rig ro 2 2 2 Morse potential mors U rij Eol 1 exp k rig ro 1 2 3 je 2 4 ij ij 13 3 12 6 potential bond 12 6 STFC Section 2 2 4 Lennard Jones potential 1j 5 Restrained harmonic rhrm 1 2 sk rij To E ras Tol lt r Ury ae ea o 13 CS 2 6 ri l kr krellrj ro re lrig ol gt re oe 6 Quartic potential quar k U rij zru ro tag ro Horia fo 2 7 7 Buckingham potential buck 8 Coulomb potential coul U riz k y Electrostatics rij gt aa 2 9 TEQE Tij where qe is the charge on an atom labelled It is worth noting that the Coulomb potential switches to the particular model of Electrostatics opted in CONTROL 9 Shifted finitely extendib
341. nd is best suited for large molecular simulations from 10 to 10 atoms on large processor counts The two packages are reasonably compatible so that it is possible to scale up from a DL POLY_Classic to a DL_POLY_4 simulation with little effort It should be apparent from these comments that DL_POLY_4 is not intended as a replacement for DL POLY Classic Users are reminded that we are interested in hearing what other features could be usefully incorporated We obviously have ideas of our own and CCP5 strongly influences developments but other input would be welcome nevertheless We also request that our users respect the integrity of DL_ POLY_4 source and not pass it on to third parties We require that all users of the package register with us not least because we need to keep everyone abreast of new developments and discovered bugs We have developed various forms of licence which we hope will ward off litigation from both sides without denying access to genuine scientific users Further information on the DL POLY packages may be obtained from the DL POLY project website http www ccp5 ac uk DL_POLY 1 2 Functionality The following is a list of the features DL_POLY_4 supports 1 2 1 Molecular Systems DL_ POLY_4 will simulate the following molecular species e Simple atomic systems and mixtures e g Ne Ar Kr etc e Simple unpolarisable point ions e g NaCl KCl etc e Polarisable point ions and molecules e g MgO H20
342. ndary from each pair contribution The term subtracted is 1 44 gt 14 2 208 Arege Re 2 The effective pair force on an atom j arising from another atom n within the cavity is given by vq 1 Bo pe 2 209 j Amege E Tij In DL_POLY_4 the reaction field is optionally extended to emulate long range ordering in a force shifted manner by countering the reaction term and using a distance depending damping function erfc a rij identical to that seen in the real space portion of the Ewald sum and thus mirror the effective charge screening 63 re qiqi pe Tij f Es Tout 2a exp a rat rs E 4TEoE Tij on Vn Tout er fela Teut erfc a rat 2a exp a r Bo rj rat F Teut 7 gt 2 210 2 3 Pout Teut yr Pout pa with the force on an atom 7 given by 0 05 249 Tij 2a exp a 2 2 Li repe E iy vr rij erfc a Ten 20 exp a ray Y Boris Tig T Tat yT Tout dE cut with the force on atom 7 the negative of this 2 211 7 2 211 48 STFC Section 2 4 It is worth noting that as discussed in 63 and references therein this is only an approximation of the Ewald sum and its accuracy and effectiveness become better when the cutoff is large gt 10 preferably 12 A The contribution of each effective pair interaction to the atomic virial is W rij f 2 212 and the contribution to the atomic stress tensor is rarer a 2 213 where a 8 are x y
343. ndary key See Table 6 6 for permitted values megatm integer Optinal total number of particles crystalographic entities record 3 omitted if imcon 0 cell 1 real x component of the a cell vector in cell 2 real y component of the a cell vector in cel1 3 real z component of the a cell vector in record 4 omitted if imcon 0 cell 4 real x component of the 6 cell vector in A cell 5 real y component of the b cell vector in A cel1 6 real z component of the b cell vector in A record 5 omitted if imcon 0 cell 7 real x component of the c cell vector in A cell 8 real y component of the c cell vector in A cell 9 real z component of the c cell vector in A Note that record 2 may contain more information apart from the mandatory as listed above If the file has been produced by DL _POLY 4 then it also contains other items intended to help possible parallel I O reading Also it is worth mentioning that the periodic boundary conditions PBC as specified in Table 6 6 and described in detail in Appendix A refer generally to a triclinic type of super cell for which there are no symmetry assumptions Records 3 4 and 5 contain the Cartesian components of the super cell s lattice vectors in A DL POLY 4 can only tract triclinic type of super cells as the only types of super cell shapes that are commensurate with the domain decomposition DD parallelisation strategy of it However this is not a restriction for the replicated data RD pa
344. ndex 2 7 integer site index of shell ka real force constant of core shell spring ka real quartic anharmonic force constant of spring The spring potential is 1 1 U r Shar ghar is 6 6 with the force constant kz entered in units of engunitxA and k4 in engunit A where usually k2 gt gt k4 The engunit is the energy unit specified in the units directive 144 STFC Section 6 1 Note that the atomic site indices referred to above are indices arising from numbering each atom in the molecule from 1 to the number specified in the atoms directive for this molecule This same numbering scheme should be used for all descriptions of this molecule including the constraints pmf rigid teth bonds angles dihedrals and inversions entries described below DL POLY_4 will itself construct the global indices for all atoms in the systems Note that DL_POLY_4 determines which shell model to use by scanning shells weights provided the FIELD file see Section 2 5 If all shells have zero weight the DL_POLY 4 will choose the relaxed shell model If no shell has zero weight then DL_POLY 4 will choose the dynamical one In case when some shells are massless and some are not DL_POLY_4 will terminate execution controllably and provide information about the error and possible possible choices of action in the OUTPUT file see Section 6 2 6 Shell models extensions are dealt according to the user specifications in the FIELD files This
345. ndler Anderson U r Pij S 25 0o A 2 dpd Standard DPD 50 A ret Cr 5 Te i z 17 lt T Groot Warren U r rtre 1 07 1 12 Amos MONEE 00 ro K om o 2 FF 14 7 pair Note in this formula the terms a 8 and y are compound expressions involving the variables Eo n m ro and re See Section 2 3 1 for further details Note All local potential cutoffs re default to the general van der Waals cutoff rvdw or the general domain decomposition cutoff rcut if unspecified or set to zero in the FIELD file Similarly if the specified value of rvdw and or rcut in CONTROL is found shorter than any of re including the WCA equivalent 26 o A values specified in FIELD then rvdw and or rcut will be reset by DL POLY 4 to the largest of all values Note A defaults to zero if A gt 0 5 or it is not specified in the FIELD file 152 STFC Section 6 1 variable 6 real potential parameter see Table 6 13 variable 7 real potential parameter see Table 6 13 variable 8 real potential parameter see Table 6 13 variable 9 real potential parameter see Table 6 13 The variables pertaining to each potential are described in Table 6 13 Table 6 13 Metal Potential key potential type Variables 1 5 6 9 functional form eam EAM tabulated potential eeam EEAM tabulated potential 2bea 2BEAM tabulated potential 2bee 2BEEAM
346. nge in box size requires the SHAKE algorithm to be called each iteration The VV and LFV flavours of the Nos Hoover barostat and thermostat are implemented in the DL_POLY_4 routines NPT_HO_VV and NPT_HO_LFV respectively The routines NPT_H1_VV and NPT_H1_LFV implement the same but also incorporate RB dynamics Cell size and shape variation The isotropic algorithms VV and LFV may be extended to allowing the cell shape to vary by defining 7 as a tensor 7 The equations of motion are written in the same fashion as is in the isotropic algorithm with slight Me as now the equations with 7 are extended to matrix forms Et w t 10 El Bolt Zu Lx 1 90 20 d En t Pmass T r n t nt 20 3 kg Text ax 2 as mass 20 1 3 155 zo DATE ont Pmass res kp Text TR HO 10 50 Sva TO VO where is the stress tensor equation 3 96 and 1 is the identity matrix The VV and LFV algorithmic equations are therefore written in the same fashion as above with slight modifications in i the equations for the thermostat and barostat frictions and ii the equations for the system volume and cell parameters The modifications in i for the VV couched algorithm are of the following sort At 2 Ekin Pmass Tr n t nt 20 3 kB Text 8 dmass x t ZA E x07 1 A u t exp n t4 74 gt v t 3 156 1 At a t Pet V t 1 n t ZAt e a t 5 al A a whereas fo
347. not safe Call error message number In this example it is assumed that the logical operation test_condition will result in the answer true if it is safe for the program to proceed and false otherwise The call to ERROR requires the user to state the message number is an integer which used to identify the appropriate message to be printed A full list of the DL_POLY_4 error messages and the appropriate user action can be found in Appendix D of this document 116 Chapter 6 Data Files Scope of Chapter This chapter describes all the input and output files for DL_POLY 4 examples of which are to be found in the data sub directory 117 STFC Section 6 1 6 1 The INPUT Files REVCON CONFIG CFGMIN REFERENCE OUTPUT HISTOR HISTORY HISTORF DEFECTS CONTROL STATIS FIELD Dm RSDDAT oe TABLE gt 4 O ka VAFDAT_ ao TABEAM ef ER a H BNDDAT BNDPMF BNDTAB TABBND ANGDAT ANGPMF ANGTAB TABANG DIHDAT DIHPMF DIHTAB TABDIH INVDAT INVPMF INVTAB TABINV RDFDAT VDWPMF VDWTAB REVOLD ZDNDAT I REVIVE Figure 6 1 DL_POLY_4 input left and output right files Note files marked with an asterisk are non mandatory
348. nstraints and PMF constraints The indices i 7 and k n appearing in the intermolecular interactions non bonded terms indicate the atoms involved in the interaction There is normally a very large number of these and they are therefore specified globally according to the atom types involved rather than indices In DL_POLY_4 it is assumed that the pure two body terms arise from van der Waals interactions regarded as short ranged and electrostatic interactions coulombic also regarded as long ranged Long ranged forces require special techniques to evaluate accurately see Section 2 4 The metal terms are many body interactions which are functionally presented in an expansion of many two body contributions augmented by a function of the local density which again is derived from the two body spatial distribution and these are therefore evaluated in the two body routines In DL POLY 4 the three body terms are restricted to valence angle and H bond forms Throughout this chapter the description of the force field assumes the simulated system is described as an assembly of atoms This is for convenience only and readers should understand that DL_POLY_4 does recognize molecular entities defined through constraint bonds and rigid bodies In the case of rigid bodies the atomic forces are resolved into molecular forces and torques These matters are discussed in greater detail in Sections 3 2 and 3 6 2 2 The Intramolecular Potential Fu
349. ny atoms in REFERENCE file Action See Message 45 Message 557 error undefined direction passed to defects_reference_export Action See Message 42 Message 558 error outgoing transfer buffer exceeded in defects_reference_export Action See Message 54 Message 559 error coordinate array exceeded in defects_reference_export Action See Message 56 Message 560 error rdef found to be gt half the shortest interatomic distance in REFERENCE The defect detection option relies on a cutoff rdef to define the vicinity around a site defined in REF ERENCES in which a particle can claim to occupy the site Evidently rdef MUST be lt half the shortest interatomic distance in REFERENCE Action 280 STFC Appendix D Decrease the value of rdef at directive defect in CONTROL Message 570 error unsupported image convention 0 for system expansion option nfold System expansion is possible only for system with periodicity on their boundaries Action Change the image convention in CONFIG to any other suitable periodic boundary condition Message 580 error replay HISTORY option can only be used for structural property recalculation No structural property has been specified for this option to activate itself Action In CONTROL specify properties for recalculation RDFs z density profiles defect detection or alternatively remove the option Message 585 error end of file encountered in HISTORY file
350. o domains_module o io_module o kinds_f90 o parse_module o setup_module o site_module o defects_reference_read_parallel o comms_module o domains_module o io_module o kinds_f90 o parse_module o setup_module o defects_reference_set_halo o comms_module o config_module o domains_module o kinds_f90 0 setup_module o defects_reference_write o comms_module o config_module o io_module o kinds_f90 o setup_module o defects_write o comms_module o config_module o defects1_module o defects_module o io_module o kinds_f90 o parse_module o setup_module o site_module o deport_atomic_data o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o domains_module o ewald_module o greenkubo_module o inversions_module o kinds_f90 o langevin_module o minimise_module o A msd_module o pmf_module o rigid_bodies_module o setup_module o statistics_module o tethers_module o development_module o comms_module o kinds_f90 o parse_module o setup_module o dihedrals_14_check o comms_module o kinds_f90 o setup_module o dihedrals_14_vdw o kinds_f90 o setup_module o vdw_module o dihedrals_compute o comms_module o config_module o dihedrals_module o kinds_f90 o setup_module o site_module o dihedrals_forces o comms_module o config_module o dihedrals_module o kinds_f90 o setup_module o vdw_module o dihedrals_module o kinds_f90 o setup_module o dihedrals_table_read o comms_module o dih
351. o find a CONFIG file in your directory Action Supply a valid CONFIG file before you start a simulation Message 126 error CONTROL file not found DL_POLY_4 failed to find a CONTROL file in your directory Action Supply a valid CONTROL file before you start a simulation Message 128 error chemical bond unit separation gt rcut the system cutoff This could only happen if FIELD and CONFIG do not match each other or if the instantaneous configuration is ill defined because of generation of large forces on bonded particles This may be due to having a badly defined force field and or starting form a configuration which is too much away from equilibrium Action Regenerate CONFIG and FIELD and resubmit Try topology verification by using nfold 1 1 1 in CON TROL Try using options as scale cap zero and optimise Try using smaller SHAKE tolerance if constraints are present in the system You may as well try using the variable timestep option Message 130 error bond angle unit diameter gt rcut the system cutoff See Message 128 Action See Message 128 Message 132 error dihedral angle unit diameter gt rcut the system cutoff See Message 128 Action See Message 128 Message 134 error inversion angle unit diameter gt rcut the system cutoff See Message 128 Action See Message 128 264 STFC Appendix D Message 138 error incorrect atom totals in refresh_halo_positions This sho
352. o nvt_al_vv o nvt_b1_vv o nvt_hi_vv o nvt_gi_vv o npt_11_vv o npt_b1_vv o npt_h1_vv o npt_mi_vv o nst_li_vv o nst_b1_vv o nst_hi_vv o nst_mi_vv o pseudo_lfv o constraints_shake_lfv o pmf_shake_lfv o nve_0_lfv o nvt_e0_lfv o nvt_l0_lfv o nvt_a0_lfv o nvt_bO_lfv o nvt_h0_lfv o nvt_g0_lfv o npt_10_lfv o npt_bO_lfv o npt_h0_lfv o npt_m0_lfv o nst_10_lfv o nst_bO_lfv o nst_h0_1lfv o nst_m0_lfv o A nve_1_lfv o nvt_el_lfv o nvt_11_1fv o nvt_al_lfv o nvt_b1_lfv o nvt_hi_lfv o nvt_g1_lfv o npt_11_1fv o npt_b1_lfv o npt_hi_lfv o npt_mi_lfv o nst_li_lfv o nst_b1_lfv o nst_hi_lfv o nst_m1_lfv o A xscale o core_shell_kinetic o regauss_temperature o z_density_collect o statistics_collect o statistics_connect_set o statistics_connect_spread o statistics_connect_frames o system_revive o rdf_compute o z_density_compute o vaf_compute o bonds_compute o angles_compute o dihedrals_compute o inversions_compute o statistics_result o dl_poly o Define Velocity Verlet files FILES_VV 207 STFC Appendix C pseudo_vv f90 constraints_shake_vv f90 pmf_shake_vv f90 constraints_rattle f90 pmf_rattle f90 nvt_h0_sc1 f90 nvt_gO_scl f 90 npt_h0_sc1 f90 nst_h0_sc1 f90 nve_0_vv f90 nvt_e0_vv f90 nvt_10_vv f90 nvt_a0_vv f90 nvt_b0_vv f90 nvt_h0_vv f90 nvt_g0_vv f90 npt_10_vv f90 npt_b0_vv f90 npt_h0_vv f90 npt_m0_vv f90 nst_10_vv f90 nst_b0_vv f90 nst_h0_vv f90 nst_m0_vv f90 nvt_h1
353. odification of the standard Ewald method DL_POLY_4 implements the SPME method of Essmann et al 66 Formally this method is capable of treating van der Waals forces also but in DL_POLY 4 it is confined to electrostatic forces only The main difference from the standard Ewald method is in its treatment of the reciprocal space terms By means of an interpolation procedure involving complex B splines the sum in reciprocal space is represented on a three dimensional rectangular grid In this form the Fast Fourier Transform FFT may be used to perform the primary mathematical operation which is a 3D convolution The efficiency of these procedures greatly reduces the cost of the reciprocal space sum when the range of k vectors is large The method briefly is as follows for full details see 66 1 Interpolation of the exp i k r terms given here for one dimension exp 27i ujk L b k gt gt M uj exp 27i k K 2 218 L 00 in which k is the integer index of the k vector in a principal direction K is the total number of grid points in the same direction and uj is the fractional coordinate of ion j scaled by a factor K i e Ks Note that the definition of the B splines implies a dependence on the integer K which limits the formally infinite sum over The coefficients M u are B splines of order n and the factor b k is a constant computable from the formula n 2 1 b k exp 2mi n 1 k K Y M
354. odule o npt_h0_1fv o comms_module o config_module o kinds_f90 o kinetic_module o A setup_module o site_module o npt_h0_scl o config_module o kinds_f90 o setup_module o npt_h0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o npt_hi_lfv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o rigid_bodies_module o setup_module o site_module o npt_hi_scl o config_module o kinds_f90 o rigid_bodies_module o setup_module o npt_hi_vv o comms_module o config_module o domains_module o kinds_f90 o0 kinetic_module o rigid_bodies_module o setup_module o site_module o npt_10_lfv o comms_module o config_module o kinds_f90 o kinetic_module o A langevin_module o setup_module o site_module o npt_10_vv o comms_module o config_module o kinds_f90 o kinetic_module o langevin_module o setup_module o site_module o npt_11_1fv o comms_module o config_module o domains_module o kinds_f90 o0 A kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o npt_li_vv o comms_module o config_module o domains_module o kinds_f90 0 kinetic_module o langevin_module o rigid_bodies_module o setup_module o site_module o npt_m0_1fv o comms_module o config_module o kinds_f90 o kinetic_module o A setup_module o site_module o npt_m0_vv o comms_module o config_module o kinds_f90 o kinetic_module o setup_module o site_module o 217 STFC Appendix C npt_m
355. oes not recognise Action The error arises because the integer key keyfrc has an inappropriate value which should not happen in the standard version of DL_POLY_4 Check that the FIELD file correctly specifies the potential Make sure the version of DIHEDRAL_FORCES does contain the potential you are specifying Report the error to the authors if these checks are correct Action To prevent this error occurring again increase rvdw Message 447 error only one shells directive per molecule is allowed DL_POLY_4 has found more than one shells entry per molecule in FIELD Action Correct the erroneous part in FIELD and resubmit Message 448 error undefined dihedral potential A form of dihedral potential has been requested which DL_POLY _4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY_4 if this is reasonable Alternatively you may consider defining the required potential in the code yourself Amendments to subroutines READ_FIELD and DIHEDRAL_FORCES and its variants will be required 271 STFC Appendix D Message 449 error undefined inversion potential A form of inversion potential has been encountered which DL_POLY 4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY 4 if this is reasonable Alternatively you may consider defining the required potential
356. of bins for all PDFs cutoff real cutoff in A for bonds and RDFs or degrees for angular intramolecular interactions types integer number of unique types of these interactions record 4 al a hash symbol record 5 info 1 al00 information to follow string record 6 al a hash symbol The subsequent records define each PDF potential in turn in the order indicated by the specification in the FIELD file Each potential is defined by a header record and a set of data records with the potential like and force like tables empty record id record info a25 information to follow string atom 1 a8 first atom type atom 2 a8 second atom type atom 3 a8 third atom type only available in ANG files atom 4 a8 forth atom type only available in DIH amp INV files index integer unique index of PDF in file instances integer instances of this unique type of PDF interaction data records 1 bins abscissa real consecutive value over the full cutoff range in A for BNDTAB amp VDWTAB and degrees for ANGTAB DIHTAB amp INVTAB potential real potential at the abscissa grid point in units as specified in FIELD force real complementary force virial for BNDTAB VDWTAB value 6 2 13 The STATIS File The file is formatted with integers as i10 and reals as el4 6 It is written by the subroutine STATIS TICS_COLLECT It consists of two header records followed by many data records of statistical data record 1 cfgname a72 configurat
357. of extra memory but if used wisely it could improve time to solution from 10 to 100 depending on force field complexity If it is too large or too small that is why the f gt Min 0 05 0 5 rcut A limit it will lead to performace degradation It is recomended that Tpad is set up at a value of 1 5 of the cutoff reut as long as the major link cell algorithm uses a link cell decomposition that not worse than 4 amp 4 Q 4 per domain For such setups in practice one may expect average compute speedups of the order of 10 30 for force fields involving the Ewald summation methodology and 60 100 for force fields without electrostatics evaluations involving the Ewald summation methodology Users are advised to study the example CONTROL files appearing in the data sub directory to see how different files are constructed 6 1 2 The CONFIG File The CONFIG file contains the dimensions of the unit cell the key for periodic boundary conditions and the atomic labels coordinates velocities and forces This file is read by the subroutine READ_CONFIG optionally by SCAN_CONFIG in the SET_BOUNDS routine The first few records of a typical CONFIG file are shown below Icel structure 6x6x6 unit cells with proton disorder 26 988000000000000 13 494000000000000 O 000000000000000 2 OW 2 505228382 0 5446573999 3515 939287 HW 1 622622646 1 507099154 7455 527553 HW 3 258494716 2 413871957 7896 278327 OW 0 9720599243
358. ome atoms with a new momentum drawn from the correct Boltzmann distribution at the desired temperature The strength of the thermostat can be adjusted by setting the average time interval over which the interactions occur and by setting the magnitude of the interaction The collisions are best described as a random Poisson process so that the probability that a collision occurs in a time step At is At Pomelo 1 exp gt 3 45 TT where Tr is the thermostat relaxation time The hardest collision is to completely reset the momentum of the Poisson selected atoms in the system with a new one selected from the Boltzmann distribution 3 2 mi Mi Vs k Text Flv ____ _ t G 0 1 3 46 u T ep et am SEBO ad where subscripts denote particle indices kg is the Boltzmann constant Text the target temperature and m the particle s mass The thermostat can be made softer by mixing the new momentum v7 drawn from F v with the old momentum v914 v ave VJV1 a2 of 3 47 where a 0 lt a lt 1 is the softness of the thermostat In practice a uniform distribution random number uni i is generated for each particle in the system which is compared to the collision probability If uni i lt 1 exp 22 the particle momentum is changed as described above The VV implementation of the Andersen algorithm is as follows 1 VV1 ue lan e a 20 r t At e rit At u t 5AM 3 48 2 RATTLE VV1
359. on is 9 1 o O Tij Lik Bre A Gi E D A a rij ik gt 2 35 with NR ri rij a enta 60 a E er 60 Ore Tijfik Tijfik TijTik col 8 dei J ek 004 2 36 T Tij Tik The atomic forces are then completely specified by the derivatives of the particular functions A 0 and S r The contribution to be added to the atomic virial is given by W Ari f rpd o 2 37 It is worth noting that in the absence of screening terms S r the virial is zero 42 The contribution to be added to the atomic stress tensor is given by ae 00 pra 2 38 and the stress tensor is symmetric In DL_POLY_4 valence forces are handled by the routine ANGLES_FORCES 2 2 4 Angular Restraints In DL_POLY_4 angle restraints in which the angle subtended by a triplet of atoms is maintained around some preset value o is handled as a special case of angle potentials As a consequence angle restraints may be applied only between atoms in the same molecule Unlike with application of the pure angle potentials the electrostatic and van der Waals interactions between the pair of atoms are still evaluated when distance restraints are applied All the potential forms of the previous section are avaliable as angular restraints although they have different key words 1 Harmonic hrm 2 Quartic qur 3 Truncated harmonic thm 4 Screened harmonic shm 5 Screened Vessal 37 b
360. on of bond constraints can be made to constrain a system to some point along a reaction coordinate A simple example of such a reaction coordinate would be the distance between two ions in solution If a number of simulations are conducted with the system constrained to different points along the reaction coordinate then the mean constraint force may be plotted as a function of reaction coordinate and the function integrated to obtain the free energy for the overall process 74 The PMF constraint force virial and contributions to the stress tensor are obtained in a manner analagous to that for a bond constraint see previous section The only difference is that the constraint is now applied between the centres of two groups which need not be atoms alone DL_POLY_4 reports the PMF constraint virial Wpmpr for each simulation Users can convert this to the PMF constraint force from W GPMF ae 3 22 where is dpmr the constraint distance between the two groups used to define the reaction coordinate The routines PMF_SHAKE and PMF_RATTLE are called to apply corrections to the atomic positions and respectively the atomic velocities of all particles constituting PMF units In presence of both bond constraints and PMF constraints The constraint procedures i e SHAKE or RATTLE for both types of constraineds are applied iteratively in order bonds PMF s until convergence of Wemr reached The number of iteration cycles is limited by the same limit as f
361. on to be added to the atomic stress tensor is given by te 2 199 where a 8 are x y z components The atomic stress tensor is symmetric In DL_POLY 4 these forces are handled by the routine COUL_FSCP_FORCES 2 4 3 Coulomb Sum with Distance Dependent Dielectric This potential attempts to address the difficulties of applying the direct Coulomb sum without the brutal truncation of the previous case It hinges on the assumption that the electrostatic forces are effectively screened in real systems an effect which is approximated by introducing a dielectric term that increases with distance The interatomic potential for two charged ions is 1 Gd U rij z 7 Arege Tij Tij j 2 200 with qe the charge on an atom labelled and rj the magnitude of the separation vector r r 1 e r is the distance dependent dielectric function In DL POLY_4 it is assumed that this function has the form er er 2 201 where e is a constant Inclusion of this term effectively accelerates the rate of convergence of the Coulomb sum The force on an atom j derived from this potential is i Es rigs 2 202 with the force on atom i the negative of this The contribution to the atomic virial is W 5 pe 2 203 which is 2 times the potential term The contribution to be added to the atomic stress tensor is given by ted a 2 204 where a 8 are x y z components The atomic stress tensor is symmetric
362. onal energy due to chemical bond potentials eng_ang configurational energy due to valence angle and three body potentials eng dih configurational energy due to dihedral inversion and four body potentials eng tet configurational energy due to tethering potentials line 2 time ps elapsed simulation time in pico seconds since the beginning of the job eng_pv enthalpy of system temp_rot rotational temperature in Kelvin vir_cfg total configurational contribution to the virial vir_src short range potential contribution to the virial vir_cou electrostatic potential contribution to the virial vir_bnd chemical bond contribution to the virial vir_ang angular and three body potentials contribution to the virial vir_con constraint bond contribution to the virial vir_tet tethering potential contribution to the virial line 3 cpu s elapsed cpu time in seconds since the beginning of the job volume system volume in AS temp_shl core shell temperature in Kelvin eng_shl configurational energy due to core shell potentials vir_shl core shell potential contribution to the virial alpha angle between b and c cell vectors in degrees beta angle between c and a cell vectors in degrees gamma angle between a and b cell vectors in degrees vir_pmf PMF constraint contribution to the virial press pressure in kilo atmospheres Note The total internal energy of the system variable tot_energy includes all contributions to the energy including system extensions
363. onfig_module o kinds_f90 0 A setup_module o 213 STFC Appendix C bonds_module o kinds_f90 o setup_module o bonds_table_read o bonds_module o comms_module o kinds_f90 o parse_module o setup_module o site_module o build_book_intra o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o inversions_module o pmf_module o rigid_bodies_module o setup_module o site_module o tethers_module o build_excl_intra o angles_module o bonds_module o comms_module o config_module o constraints_module o core_shell_module o dihedrals_module o inversions_module o kinds_f90 o0 rigid_bodies_module o setup_module o check_config o comms_module o config_module o kinds_f90 o setup_module o site_module o comms_module o kinds_f90 o compress_book_intra o comms_module o config_module o kinds_f90 0 setup_module o config_module o kinds_f90 o setup_module o constraints_module o kinds_f90 o setup_module o constraints_pseudo_bonds o comms_module o config_module o constraints_module o kinds_f90 o setup_module o constraints_quench o comms_module o config_module o constraints_module o kinds_f90 0 setup_module o constraints_rattle o comms_module o config_module o constraints_module o kinds_f90 0 setup_module o constraints_shake_lfv o comms_module o config_module o constraints_module o kinds_f90 0 setup_module o constraints_shake_vv o comms_module o config_mod
364. oo large are used the results will be correct but the calculation will consume unnecessary amounts of cpu time The amount of cpu time increases proportionally to kmaxa x kmaxb x kmaxc It is worth noting that the working values of the k vectors may be larger than their original values de pending on the actual processor decomposition This is to satisfy the requirement that the k vector FFT transform down each direction per domain is a multiple of 2 3 and 5 only which is due to the GPFA code single 1D FFT which the DaFT implementation relies on This allowes for greater flexiblity than the power of 2 multiple restriction in DL_POLY_4 predicessor DL_POLY_3 As a consequence however execution on different processor decompositions may lead to different working lengths of the k vectors FFT transforms and therefore slightly different SPME forces energies whithin the same level of SPME Ewald precision accuracy specified Note that although the number of processors along a dimension of the DD grid may be any number numbers that have a large prime as a factor will lead to inefficient performance 115 STFC Section 5 4 5 4 Warning and Error Processing 5 4 1 The DL POLY 4 Internal Warning Facility DL_POLY_4 contains a number of various in built checks scattered throughout the package which detect a range of possible inconsistencies or errors In all cases such a check fails the subroutine WARNING is called resulting in an appropriate message
365. options 137 STFC Section 6 1 26 27 28 With action set to write the io command controls how the writing of large files is performed method controls how the disk is accessed Possible values are mpiio in which case MPI I O is used direct which uses parallel FORTRAN direct access files and master which performs all I O through a master processor or netcdf for netCDF I O provided DL POLY_4 is compiled in a netCDF enabled mode mpiio is the recommended method and for large systems master should be avoided and also THE DIRECT OPTION IS NOT STRICTLY PORTABLE and so may cause problems on some machines rp is an optional specification only applicable to netcdf method for opting the binary precision for real numbers It only takes 32bit or amber for 32 bit float precision otherwise 64 bit double precision is defaulted type controls the ordering of the particles on output Possible values are sorted and unsorted sorted ensures that the ordering of the particles the default sequential ascending Whereas unsorted uses the natural internal ordering of DL_POLY_4 which changes during the simulation The recommended and default value is sorted If none is specified DL_POLY_4 defaultes to the sorted type of I O It should be noted that the overhead of the sorted otion compared to the unsorted is usually very small Available options depend on which method is to be used and all are optional in each case Where numerical values are to
366. or bonded pairs that this cutoff needs specifying whereas for angles the possible ranges are known a priory by definition If no cutoff is supplied for bonds then it defaults to 2 A It is worth noting that for EDT cutofl max the sake of accuracy the number of bins per PDF must be larger than or equal to Nmin nint where the max bin size Amax is defined internally for each type of PDF see setup_module f90 Otherwise it will default to max Nmin Niap where Niap is the number of bins on the grid defined in the corresponding tabulated force field data file TAB if it is provided otherwise Niap 0 In particular for bonds Amax is 0 01 A and for angles it is 0 27 180 i e 0 2 degree If analyse all option is used in conjunction with any specific directive then it triggers the analysis on all PDFs while enforcing on the individually targeted PDF s the following parameters i its sampling interval frames only if it is smaller than and ii its grid number only if it is larger than those specified for the targeted PDFs In the case of bonds it will also enforce the grid range rmax only if it is larger than that specified in the analyse bonds directive Hence the analyse all directive allows to quickly override and or unify the sampling frequencies and max grid numbers for all PDF s provided its parameters improve on the accuracy of the collected data compared to the specifications for the individually targeted PDF s
367. or the bond constraints procedures SHAKE RATTLE 3 4 Thermostats The system may be coupled to a heat bath to ensure that the average system temperature is maintained close to the requested temperature Text When this is done the equations of motion are modified and the system no longer samples the microcanonical ensemble Instead trajectories in the canonical NVT ensemble or something close to it are generated DL POLY 4 comes with six different thermostats Evans Gaussian constraints 26 Langevin 27 75 Andersen 28 Berendsen 29 Nos Hoover 30 and the gentle stochastic thermostat 71 76 Of these only the gentle stochastic thermostat Nos Hoover and Langevin algorithms generate trajectories in the canonical NVT ensemble The rest will produce properties that typically differ from canonical averages by O 1 N 22 where M is the number of particles in the system as the Evans algorithm generates trajectories in the NVE in ensemble 63 STFC Section 3 4 3 4 1 Evans Thermostat Gaussian Constraints Kinetic temperature can be made a constant of the equations of motion by imposing an additional constraint on the system If one writes the equations of motion as dr t a 20 L 9 _ eu an the kinetic temperature constraint x can be found as follows d d 1 y do ae x 7 Ema Emos Su 0 Y miuilt E x t to 0 3 24 Di walt f t Dima t where 7 is the instantaneous t
368. ore details or further information please consult the DL_FIELD manual and website http www ccp5 ac uk DL_FIELD 5 3 3 Adding Solvent to a Structure The utility WATERADD adds water from an equilibrated configuration of 256 SPC water molecules at 300 K to fill out the MD cell The utility SOLVADD fills out the MD box with single site solvent molecules from a fcc lattice The FIELD files will then need to be edited to account for the solvent molecules added to the file Hint to save yourself some work in entering the non bonded interactions variables involving solvent sites to the FIELD file put two bogus atoms of each solvent type at the end of the CONNECT_DAT file for AMBER force fields the utility AMBFORCE will then evaluate all the non bonded variables required by DL_POLY 4 Remember to delete the bogus entries from the CONFIG file before running DL_POLY_4 113 STFC Section 5 3 5 3 4 Analysing Results DL_POLY_4 is not designed to calculate every conceivable property you might wish from a simulation Apart from some obvious thermodynamic quantities and radial distribution functions it does not calculate anything beyond the atomic trajectories You must therefore be prepared to post process the HISTORY file if you want other information There are some utilities in the DL _POLY_4 package to help with this but the list is far from exhaustive In time we hope to have many more Our users are invited to submit code to the DL_POLY_4
369. ory_write o system_expand o rigid_bodies_tags o rigid_bodies_coms o rigid_bodies_widths o rigid_bodies_setup o init_intra o tag_legend o report_topology o pass_shared_units o build_book_intra o build_excl_intra o scale_temperature o update_shared_units o core_shell_quench o constraints_tags o constraints_quench o pmf_coms o pmf_tags o pmf_vcoms o pmf_quench o rigid_bodies_quench o set_temperature o vdw_lrc o metal_lrc o system_init o vnl_check o export_atomic_data o set_halo_particles o export_atomic_positions o refresh_halo_positions o rigid_bodies_stress o read_history o defects_reference_read o defects_reference_read_parallel o defects_reference_write o defects_reference_export o defects_reference_set_halo o defects_link_cells o defectsi_write o defects_write o msd_write o rsd_write o vaf_write o impact o core_shell_on_top o deport_atomic_data o pmf_units_set o compress_book_intra o relocate_particles o link_cell_pairs o metal_ld_collect_eam o metal_1d_collect_fst o A metal_ld_export o metal_ld_set_halo o metal_1d_compute o exchange_grid o ewald_spme_forces o metal_forces o vdw_forces o ewald_real_forces o coul_dddp_forces o coul_cp_forces o coul_fscp_forces o coul_rfp_forces o rdf_collect o rdf_excl_collect o rdf_frzn_collect o ewald_excl_forces o ewald_frzn_forces o two_body_forces o tersoff_forces o three_body_forces o four_body_forces o core_shell_forces o te
370. p o deport_atomic_data o pmf_units_set o compress_book_intra o relocate_particles o link_cell_pairs o metal_ld_collect_eam o metal_1d_collect_fst o metal_ld_export o metal_ld_set_halo o metal_ld_compute o exchange_grid o ewald_spme_forces o metal_forces o vdw_forces o ewald_real_forces o coul_dddp_forces o coul_cp_forces o coul_fscp_forces o 206 STFC Appendix C coul_rfp_forces o rdf_collect o rdf_excl_collect o rdf_frzn_collect o ewald_excl_forces o ewald_frzn_forces o two_body_forces o tersoff_forces o three_body_forces o four_body_forces o core_shell_forces o tethers_forces o intra_coul o bonds_forces o angles_forces o dihedrals_14_vdw o dihedrals_forces o inversions_forces o external_field_apply o external_field_correct o langevin_forces o constraints_pseudo_bonds o pmf_pseudo_bonds o rigid_bodies_split_torque o rigid_bodies_move o minimise_relax o core_shell_relax o zero_k_optimise o vaf_collect o nvt_e0_scl o nvt_el_scl o nvt_b0_scl o nvt_b1_scl o A pseudo_vv o constraints_shake_vv o pmf_shake_vv o constraints_rattle o pmf_rattle o nvt_h0_scl o nvt_g0_scl o npt_h0_scl o nst_h0_scl o A nve_0_vv o nvt_e0_vv o nvt_10_vv o nvt_a0_vv o nvt_b0_vv o nvt_h0_vv o nvt_g0_vv o npt_10_vv o npt_b0_vv o npt_h0_vv o npt_m0_vv o nst_10_vv o nst_b0_vv o nst_h0_vv o nst_m0_vv o nvt_hi_scl o nvt_g1_scl o npt_hi_scl o nst_hi_scl o A nve_1_vv o nvt_el_vv o nvt_11_vv
371. pe of Chapter This chapter describes the coarse graining functionality available in DL_POLY_4 96 STFC Section 4 2 4 1 User Defined Coarse Grain Models with Tabulated Force Fields One can use DL_POLY_4 for preparing and running simulations of numerically coarse grained CG models by using tabulated effective force fields FF derived from either i potentials of mean force PMF or ii iteratively optimised CG models In outline systematic coarse graining SCG of an atomistic system implies the application of a geometrical projection or mapping of the original system onto a considerably reduced set of degrees of freedom DoF whence referred to as a coarse grained model The procedure is to recover the average configurational often termed physical and topological often termed chemical force field related properties of the original full atom FA model Integrating out degrees of freedom ultimately leads to loss of information However if this is done selectively and consistently the intrinsic information pertaining to the dominating interactions within the FA system that govern its behaviour towards phenomena of interest and the most important thermodynamic properties are retained Then the greatly reduced phase space of the CG model system allows for efficient access to much longer length and time scales for investigating microscopic phenomena using of the well established classical MD machinery T
372. pen if too few or too many data records are included Action Locate the erroneous directive in the FIELD file and correct error and resubmit Message 5 error unknown energy unit requested The DL_POLY_4 FIELD file permits a choice of units for input of energy parameters These may be electron Volts eV k calories per mol kcal mol k Joules per mol kJ mol Kelvin per Boltzmann Kelvin Boltzmann or the DL POLY 4 internal units 10 Joules per mol internal There is no default value Failure to specify any of these correctly or reference to other energy units will result in this error message See documentation of the FIELD file Action Correct energy keyword on units directive in FIELD file and resubmit Message 6 error energy unit not specified A units directive is mandatory in the FIELD file This error indicates that DL POLY 4 has failed to find the required record Action Add units directive to FIELD file and resubmit Message 7 error selected external field incompatible with selected ensemble NVE only Action Change the external field directive in FIELD file and or the type of ensemble in CONTROL and resubmit Message 8 error ewald precision must be a POSITIVE real number Ewald precision must be a positive non zero real number For example 10e 5 is accepted as a standard Action 246 STFC Appendix D Put a correct number at the ewald precision directive in the CONTROL file and r
373. perature not specified or lt 1 K DL_POLY_4 has failed to find a temp directive in the CONTROL file Action Place a temp directive in the CONTROL file with the required temperature specified Message 381 error simulation timestep not specified DL_POLY 4 has failed to find a timestep directive in the CONTROL file Action Place a timestep directive in the CONTROL file with the required timestep specified Message 382 error simulation cutoff not specified DL_POLY 4 has failed to find a cutoff directive in the CONTROL file Action Place a cutoff directive in the CONTROL file with the required forces cutoff specified Message 387 error system pressure not specified The target system pressure has not been specified in the CONTROL file Applies to NPT simulations only 268 STFC Appendix D Action Insert a press directive in the CONTROL file specifying the required system pressure Message 390 error npt nst ensemble requested in non periodic system A non periodic system has no defined volume hence the NPT algorithm cannot be applied Action Either simulate the system with a periodic boundary or use another ensemble Message 392 error too many link cells requested The number of link cells required for a given simulation exceeds the number allowed for by the DL_POLY_4 arrays Probable cause your system has expanded unacceptably much to DL POLY_4 This may not be physically sensible Action
374. pfbp mxpfld mxstak mxnstk mxlist mxcell mxatms mxatdm mxbfdp mxb ss mxbfxp mxbfsh mxbuff zero_plus half_plus half minus engunit variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable max number of grid points in potential arrays gt 1004 max number of PDFs per type max number of grid points for PDFs arrays max number of grid points for chemical bonds PDFs max number of grid points for bond angles PDFs max number of grid points for dihedral angles PDFs max number of grid points for inversion angles PDFs max number of three body potentials in system array dimension of three body potential parameters max number of three body potential parameters 5 max number of four body potentials in system array dimension of four body potential parameters max number of four body potential parameters 3 max number of external field parameters 5 dimension of stack arrays for rolling averages max number of stacked variables max number of atoms in the Verlet list on a node max number of link cells per node max number of local halo atoms per node max number of local atoms per node max dimension of the transfer buffer for deport functions max dimension of the transfer buffer for statistics f
375. ping arrays in SET_BOUNDS The division of the configuration data in this way is based on the location of the atoms in the simulation cell such a geometric allocation of system data is the hallmark of DD algorithms Note that in order for this strategy to work efficiently the simulated system must possess a reasonably uniform density so that each processor is allocated almost an equal portion of atom data as much as possible Through this approach the forces computation and integration of the equations of motion are shared reasonably equally between processors and to a large extent can be computed independently on each processor The method is conceptually simple though tricky to program and is particularly suited to large scale simulations where efficiency is highest The DD strategy underpinning DL_POLY_4 is based on the link cell algorithm of Hockney and Eastwood 82 as implemented by various authors e g Pinches et al 9 and Rapaport 10 This requires that the cutoff applied to the interatomic potentials is relatively short ranged In DL_POLY_4 the link cell list is build by the routine LINK_CELL_PAIRS As with all DD algorithms there is a need for the processors to exchange halo data which in the context of link cells means sending the contents of the link cells at the boundaries of each domain to the neighbouring processors so that each may have all necessary information to compute the pair forces acting on the atoms belonging to
376. port to authors Message 83 error too many three body angles potentials specified This should never happen Action Report to authors Message 84 error unidentified atom in three body angles potential list This shows that DL_POLY_4 has encountered and erroneous entry at three body or angles definitions in FIELD Action Correct FIELD and resubmit Message 85 error required velocities not in CONFIG file If the user attempts to start up a DL POLY 4 simulation with any type of restart directive see description of CONTROL file the program will expect the CONFIG file to contain atomic velocities as well as positions Termination results if these are not present Action Either replace the CONFIG file with one containing the velocities or if not available remove the restart directive altogether and let DL_POLY_4 create the velocities for itself 258 STFC Appendix D Message 86 error calculated three body potential index too large This should never happen DL_POLY 4 has a permitted maximum for the calculated index for any three body potential in the system i e as defined in the FIELD file If there are m distinct types of atom in the system the index can possibly range from 1 to m m 1 2 If the internally calculated index exceeds this number this error report results Action Report to authors Message 87 error too many link cells required in four_body forces This should not
377. presumed a general interstitial If a site s is claimed and another particle p is located within the sphere around it then p becomes an interstitial associated with s After all particles and all sites are considered it is clear which sites are vacancies Finally for every claimed site distances between the site and its first hand claimee and interstitials are compared and the particle with the shortest one becomes the real claimee If a first hand claimee of s is not the real claimee it becomes an interstitial associated with s At this stage it is clear which particles are interstitials The sum of interstitials and vacancies gives the total number of defects in the simulated MD cell Frozen particles and particles detected to be shells of polarisable ions are not considered in the defect detection Note that the algorithm cannot be applied safely if Racy is larger than half the shortest interatomic distance within the reference MD cell since a particle may i claim more than one site ii be an interstitial associated with more than one site or both i and ii On the other hand low values of Raef are likely to lead to slight overestimation of defects If the simulation and reference MD cell have the same number of atoms then the total number of interstitials is always equal to the total number of defects 135 STFC Section 6 1 13 14 15 16 17 18 19 20 21 The displacements option will tri
378. public library to help with this The utilities available are described in the DL POLY Classic User Manual Users should also be aware that many of these utilities are incorporated into the DL POLY GUI 21 5 3 5 Choosing Ewald Sum Variables 5 3 5 1 Ewald sum and SPME This section outlines how to optimise the accuracy of the Smoothed Particle Mesh Ewald sum parameters for a given simulation As a guide to beginners DL_POLY_4 will calculate reasonable parameters if the ewald precision directive is used in the CONTROL file see Section 6 1 1 A relative error see below of 107 is normally sufficient so the directive ewald precision 1d 6 will make DL_POLY_4 evaluate its best guess at the Ewald parameters a kmaxa kmaxb and kmaxc or their doubles if ewald rather than spme is specified The user should note that this represents an estimate and there are sometimes circumstances where the estimate can be improved upon This is especially the case when the system contains a strong directional anisotropy such as a surface These four parameters may also be set explicitly by the ewald sum directive in the CONTROL file For example the directive ewald sum 0 35 6 6 8 which is equvalent to spme sum 0 35 12 12 16 would set a 0 35 A kmaxa 12 kmaxb 12 and kmaxc 16 The quickest check on the accuracy of the Ewald sum is to compare the coulombic energy U and virial W in a short simulation Adherence to the relationship U W
379. r deallocation failure in core shell module gt deallocate_core_shell_arrays Action See Message 1002 287 STFC Appendix D Message 1031 error deallocation failure in tethers_module gt deallocate_tethers_arrays Action See Message 1002 Message 1032 error deallocation failure in constraints module gt deallocate_constraints_arrays Action See Message 1002 Message 1033 error deallocation failure in dihedrals_module gt deallocate_dihedrals_arrays Action See Message 1002 Message 1034 error deallocation failure in inversions_module gt deallocate_inversions_arrays Action See Message 1002 Message 1035 error allocation failure in defects_module gt allocate_defects_arrays Action See Message 1001 Message 1036 error allocation failure in pmf_module gt allocate_pmf_arrays Action See Message 1001 Message 1037 error deallocation failure in pmf_module gt deallocate_pmf_arrays Action See Message 1002 Message 1038 error allocation failure in minimise_module gt allocate_minimise_arrays Action See Message 1001 288 STFC Appendix D Message 1039 error deallocation failure in minimise_module gt deallocate_minimise_arrays Action See Message 1002 Message 1040 error allocation failure in ewald_module gt ewald_allocate_kall_arrays Action See Messag
380. r p thm shrm Screened harmonic k 00 pi pe U 0 0 bo exp rij p1 riz p2 shm bvs1 Screened Vessal 37 k 00 pr pe U 0 Hoon my 0 my x bv1 exp rij p1 Tik p2 bvs2 Truncated Vessal 38 kl a p U 0 k 0 00 0 0 Op 27 bv2 51 99 m9 exp ri 1 0 hcos Harmonic Cosine k 0 U 0 E cos cos Gp hcs cos Cosine Alim U 0 A 1 cos m 8 COS mmsb MM3 stretch bend 39 A 00 ri 75 U 0 A 0 00 rij r rik TH msb stst Compass 40 Al Tk U 0 A rij r3 rik Tik sts stretch stretch stbe Compass 40 A 00 ri U 0 A 0 00 rij r stb stretch bend cmps Compass 40 A B s C 4 U 0 A rij r3 rik 7 0 00 x cmp all terms rij Tk B rij ri C rik rip amoe AMOEBA 36 k 0 U 0 k A 1 1 4 1072A 5 6 1075A amo FF angle 70 10 AP 2 2 107844 A 0 bo kky KKY 36 fe 8 Gr Te U 0 fk sin 2 0 00 Kij Kix kky Kij 1 exp gr rij ro 10 is the i j k angle Note valence angle potentials with a dash as the first character of the keyword do not contribute to the excluded atoms list see Section 2 In this case DL_POLY_4 will calculate the non bonded pair potentials between the described atoms 149 STFC Section 6 1 Table 6 10 Dihedral Angle Potentials
381. r version is required to run the GUI select select is a macro enabling easy selection of one of the test cases It invokes the UNIX commands cp data TEST 1 CONTROL CONTROL cp data TEST 1 FIELD FIELD cp data TEST 1 CONFIG CONFIG cp data TEST 1 TABLE TABLE cp data TEST 1 TABEAM TABEAM cp data TEST 1 REFERENCE REFERENCE select requires one argument an integer to be specified select n where n is test case number which ranges from 1 to 18 This macro sets up the required input files in the execute sub directory to run the n th test case The last three copy commands may not be necessary in most cases store The store macro provides a convenient way of moving data back from the execute sub directory to the data sub directory It invokes the UNIX commands mkdir data TEST 1 cp CONTROL data TEST 1 CONTROL cp FIELD data TEST 1 FIELD cp CONFIG data TEST 1 CONFIG cp TABLE data TEST 1 TABLE cp TABEAM data TEST 1 TABEAM cp REFERENCE data TEST 1 REFERENCE mv OUTPUT data TEST 1 OUTPUT mv STATIS data TEST 1 STATIS mv REVCON data TEST 1 REVCON mv REVIVE data TEST 1 REVIVE mv HISTORY data TEST 1 HISTORY mv DEFECTS data TEST 1 DEFECTS mv RSDDAT data TEST 1 RSDDAT mv RDFDAT data TEST 1 RDFDAT mv ZDNDAT data TEST 1 ZDNDAT chmod R a w data TEST 1 which first creates a new DL_POLY data TEST sub directory and then moves the standard DL_POLY_4 output
382. r domain in given direction A useful rule of thumb is that parallelisation speed up inefficiency is expected when the ratio My My Mz Mz 2 My 2 M 2 Mz My Mz R 5 2 is close to or drops below one In such cases there are three strategies for improving the situation that can be used singly or in combination As obvious from equation 5 1 these are i decrease the number of nodes used in parallel ii decrease the cutoff and iii increase system size It is crucial to note that increased parallelisation efficiency remains even when the link cell algorithm is used inefficiently However DL_POLY_4 will issue an error message and cease execution if it detects it cannot fit a link cell per domain as this is the minimum the DL POLY 4 link cell algorithm can work with 1 1 1 corresponding to ratio R 1 2 It is worth outlining in terms of the O computation communication function what the rough scaling performance is like of the most computation and communication intensive parts of DL POLY_4 in an MD timestep a Domain hallo re construction in SET_HALO_PARTICLES METAL_LD_SET_HALO and DEFECTS_REFERENCE_SET_HALO O N P N R b Verlet neighbourlist construction by link cells in LINK_CELL_PAIRS O N P 0 may take up to 40 of the time per timestep c Calculation of k space contributions to energy and forces from SMPE by EWALD_SPME_FORCES depends on PARALLEL_FFT which depends on GPFA_MODULE O N lo
383. r system then create your own echo using the advice in generic target template provided echo in this Makefile under the entry uknown_platform echo Fetch MPI SERIAL subroutines FILES_SERIAL MAKE links_serial links_serial for file in FILES_SERIAL do echo linking to file rm f file ln s SERIAL file file done 236 STFC Appendix C Fetch the Velocity Verlet subroutines FILES_VV MAKE links_vv links_vv for file in FILES_VV do echo linking to file rm f file ln s VV file file A done Fetch the LeapFrog Verlet subroutines FILES_LFV MAKE links_lfv links_lfv for file in FILES_LFV do echo linking to file rm f file ln s LFV file file done Clean up the source directory clean rm f OBJ_MOD OBJ_ALL FILES_VV FILES_LFV FILES_SERIAL mod Generic target template uknown_platform MAKE LD path to FORTRAN9O Linker loaDer LDFLAGS appropriate flags for LD FC path to FORTRAN9O compiler FCFLAGS appropriate flags for FC EX EX BINROOT BINROOT TYPE System specific targets follow win MAKE LD f95 o LDFLAGS 03 FC 95 c FCFLAGS 03 EX EX BINROOT BINROOT TYPE 237 Appendix C win debug MAKE LD 95 o LDFLAGS 00 C all C undefined FC 95 c FCFLAGS 00 C all
384. r the LFV couched algorithm they are 2Exin t Dmass Tr n t ty 20 3 ke La x t At y t At At At At E x t L n t 70 3 157 Nl nr NI ple At v t 1 1 n t At exp x t At n t At At The modifications in ii are the same for both the VV and LFV couched algorithms H t At exp ut sat At H t 86 STFC Section 3 5 VEL ap E hae 340 At V t 3 158 It is worth noting DL_POLY_4 uses Taylor expansion truncated to the quadratic term to approximate exponentials of tensorial terms The conserved quantity is to within a constant the Gibbs free energy of the system mass X t 2 Pmass Tr N 17 t HNot Hnve E x t 4 Pera V t f 3 kp Text J x s ds 3 159 2 2 where f is the system s degrees of freedom equation 3 11 This ensemble is optionally extending to constant normal pressure and constant surface area NP AT 72 by semi isotropic constraining of the barostat equation of motion and slight amending the thermostat equation of motion and the conserved quantity to UES i OP VO _ Cenad a B 2 a 0 5 Naa 0 0 a8 2 2Ekin t Pmass Trintt no 20 kg Tex EAr E 0 nt 1 3 160 dt mass mass t 2 Pmass Trin 17 t HNp AT HNVE E A 5 Port V t F f 1 kB Text I x s ds Similarly this ensemble is optionally extending to constant normal pressure and constant surface tension
385. rallelisation that DL POLY Classic adopts and thus it can also accept truncated octahedral and rhombic dodecahedral periodic boundaries Subsequent records consists of blocks of between 2 and 4 records depending on the value of the levcfg variable Each block refers to one atom The atoms do not need to be listed sequentially in order of increasing index Within each block the data are as follows record i atmnam a8 atom name index integer atom index record ii XXX real x coordinate in A yyy real y coordinate in A ZZZ real z coordinate in record iii included only if levcfg gt 0 VXX real x component of velocity vyy real y component of velocity VZZ real x component of velocity record iv included only if levcfg gt 1 fxx real x component of force fyy real y component of force fzz real z component of force 140 STFC Section 6 1 Note that on record i only the atom name is strictly mandatory any other items are not read by DL_POLY_Classic but may be added to aid alternative uses of the file for example alike DL _POLY GUI 21 DL_POLY_Classic assume that the atoms indices are in a sequentially ascending order starting form 1 However DL POLY_4 needs the index or the no index option needs to be specified in the CONTROL file It is worth mentioning that DL_POLY 4 as well as DL POLY Classic assumes that the origin of Cartesian system with respect to which the particle positions are specified is the middle of MD cell Also as both
386. ranged corrections apply beyond ret 5 Finnis Sinclair energy correction No long ranged corrections apply beyond cutoffs c and d 6 Extended Finnis Sinclair energy correction No long ranged corrections apply beyond cutoffs c and d 7 Sutton Chen energy correction SU Qn N pea a a n 3 rmet ao m 3 U oat a va 2 139 m Tmet 2 p 36 STFC Section 2 3 8 Gupta energy correction ATNGA 2 U TAREN e 2rnet 2 2 42 2 2 x Pp p p Tmet ro exp pha 2 215 U2 rezo TZ et 27 met a 2 ay x qij qij dij exp 2q 2 ij no 2 0 9 Many body perturbation component energy correction dU1 0 e Amp a x Ne m 3 rin Die 2 p 2 140 2 141 To estimate the virial correction we assume the corrected local densities are constants i e independent of distance at least beyond the range rmet This allows the virial correction to be computed by the methods used in the short ranged potentials OV rij US D ae ij i 1 jAti N T j lt Tmet V r N rij2rmet y ri maS y PO y Y a wt 400 i 1 ae i 1 jf ij OVi JW Np A Tmet Tij OF pi Opi Tij ci gt Opi 3 Orij Fi ke lt Tmet Tij 2Tmet Ppa r pi Opia lri p 2 e ae Y aa a Or i 1 Ai i l a Ai ij N l Arp L ag 1 1 Evaluating the integral part of the above equations yields 1 EAM virial correction No long ranged corrections apply
387. rather than a single program which means that users are to be able to construct a working simulation program of their own design from the subroutines available which is capable of performing a specific simulation However we recognise that many perhaps most users will be content with creating a standard version that covers all of the possible applications and for this reason we have only provided the necessary tools to assemble such a version The method of creating the standard version is described in detail in this chapter however a brief step by step description follows 1 DL POLY_4 is supplied as a UNIX compressed file tarred and gzipped This must uncompressed and un tared to create the DL_POLY_4 directory Section 1 4 2 In the build subdirectory you will find the required DL_POLY_4 makefiles see Section 5 2 1 and Appendix C where the main Makefiles are listed This must be copied into the subdirectory containing the relevant source code In most cases this will be the source subdirectory 3 The chosen makefile is executed with an appropriate keyword Section 5 2 1 which is selected for specific platforms For DL POLY_4 compilation in parallel mode a FORTRAN90 compiler and an MPI implementation for the specific machine architecture are required in many cases the user sometimes with help from the administrator of their platform will have to create their own keyword entry in the makefile due to the large variety of i software nee
388. rease mxinv alternatively increase it by hand in SET_BOUNDS and recompile and resubmit Message 78 error too many link cells required in tersoff_forces This should not happen The calculation of Tersoff forces in DL_POLY_4 is handled by the link cell algorithm This error arises if the required number of link cells exceeds the permitted array dimension in the code Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxcell in SET_BOUNDS recompile and resubmit Message 79 error tersoff potential cutoff undefined This shows that DL_POLY_4 has encountered and erroneous entry for Tersoff potentials in FIELD Action Correct FIELD and resubmit 257 STFC Appendix D Message 80 error too many pair potentials specified This should never happen Action Report to authors Message 81 error unidentified atom in pair potential list This shows that DL_POLY_4 has encountered and erroneous entry for vdw or metal potentials in FIELD or cited TABle file Action Correct FIELD and or cited TABle file Message 82 error calculated pair potential index too large This should never happen In checking the vdw and metal potentials specified in the FIELD file DL POLY 4 calculates a unique integer indices that henceforth identify every specific potential within the program If this index becomes too large termination of the program results Action Re
389. rective Further to the full restart option there is an alternative restart scale directive that will reset the tem perature at start or restart noscale that will keep the current kinetics intact bf Note that these two options are not correct restarts but rather modified starts as they make no use of REVOLD file and will reset internal accumulators to zero at start 108 STFC Section 5 2 Note that all these options are mutually exclusive If none of the restart options is specified velocities are generated anew with Gaussian distribution of the target kinetic energy based on the provided temperature in the CONTROL file 5 2 5 Optimising the Starting Structure The preparation of the initial structure of a system for a molecular dynamics simulation can be difficult It is quite likely that the structure created does not correspond to one typical of the equilibrium state for the required state point for the given force field employed This can make the simulation unstable in the initial stages and can even prevent it from proceeding For this reason DL_POLY_4 has available a selection of structure relaxation methods Broadly speaking these are energy minimisation algorithms but their role in DL_POLY 4 is not to provide users with true structural optimisation procedures capable of finding the ground state structure They are simply intended to help users improve the quality of the starting structure prior to a statistical dynamical sim
390. ressure in a system 2 Ekin t Watomic t a Weonstram t gt At WPMF t gt At 3V t P t 3 95 is a function of the system volume kinetic energy and virial W Note that when bond constraints or and PMF constraints are present in the system P will not converge to the exact value of P x during equilibration in NPT and NoT simulations This is due to iterative nature of the constrained motion in which the virials Weonstrain and Wpmr are calculated retrospectively to the forcefield virial Watomic The instantaneous stress tensor in a system a t pin t alr T atomic 2 ae E At T Lpur t E At 2 3 96 is a sum of the forcefield a tomio constrain Constrain and PMF Gpyp stresses a Note that when bond constraints or and PMF constraints are present in the system the quantity r will not converge to the exact value of Pax during equilibration in NPT and NoT simulations This is due to iterative nature of the constrained motion in which the constraint and PMF stresses are calculated retrospectively to the forcefield stress 3 5 2 Langevin Barostat DL_POLY_4 implements a Langevin barostat 31 for isotropic and anisotropic cell fluctuations Cell size variations 74 STFC Section 3 5 For isotropic fluctuations the equations of motion are CO w t NO Sut EPIRO 4 142 no ae Eno sve O es de nt E an _ f 3 kp Text Pmass 27 Xp CH 100 80 vit BOVE
391. rgy E mo lo to is 1 6605402 x 1072 Joules 10 J mol e The unit of pressure P Eol is 1 6605402 x 107 Pascals 163 882576 atmospheres e Planck s constant A which is 6 350780668 x Eoto In addition the following conversion factors are used 7 STFC Section 1 4 e The coulombic conversion factor yo is 1 _ _ _ 1389354885 P T rra i such that Uukxs EoYoUtnternal where U represents the configuration energy e The Boltzmann factor kg is 0 831451115 E K such that T Exin kp represents the conversion from kinetic energy in internal units to temperature in Kelvin Note In the DL POLY_4 OUTPUT file the print out of pressure is in units of katms kilo atmospheres at all times The unit of energy is either DL_POLY units specified above or in other units specified by the user at run time see Section 6 1 3 The default is the DL POLY unit Externally DL_POLY_4 accepts information in its own specific formatting as described in Section 6 1 Irrespective of formatting rules all values provided to define input entities are read in DL POLY units except otherwise specified as in the case of energy units or their composite mixture representing the corresponding entity physically i e velocities components are in Angsroms picosecond 1 3 8 Error Messages All errors detected by DL_POLY_4 during run time initiate a call to the subroutine ERROR which prints an error message in the s
392. rned on for the correct application of stochastic dynamics via the langevin temperature control NVT Langevin If the option is not applied then the dynamics will lead to peculiar thermalisation of different atomic species to mass and system size dependent temperatures The replay force option will attempt to open a renamed HISTORY as HISTORF and instead fol lowing any integration scheme specified in CONTROL read the positions as integration outcomes and proceed with the usual MD cycle There are a couple of restrictions that may lead to failures of this feature s application e The CONFIG file at re start must be the same as the frame in HISTORF that CONTROL REVOLD attempts to re start from e If any two HISTROF consecutive frames are too far apart in time from each other then domain information reallocation follow up may break when the feature is used in parallel The rpad pad option will add extra distance paa if larger than f gt Min 0 05 0 5 reut A to the major cutoff reut to construct a larger link cell width rink Teut paa Which will trigger a construction of a larger Verlet neighbour list VNL while at the same time facilitate its conditional update rather at every timestpe The VNL conditaional update is check at the end of each tiemstep 138 OS TFC Section 6 1 and triggered only when the most travelled particle has moved a distance larger than rpaq 2 It is worth noting that padding is at expense
393. rog Verlet subroutines FILES_LFV MAKE links_lfv links_lfv for file in FILES_LFV do echo linking to file rm f file ln s LFV file file done Clean up the source directory clean rm f OBJ_MOD OBJ_ALL FILES_VV FILES_LFV mod Generic target template uknown_platform MAKE LD path to FORTRAN9O Linker loaDer LDFLAGS appropriate flags for LD MPI libraries FC path to FORTRAN90 compiler FCFLAGS appropriate flags for FC MPI include EX EX BINROOT BINROOT TYPE System specific targets follow f s 5 5 Cambridge HPC darwin Woodcrest hpc MAKE LD mpif90 o LDFLAGS 03 FC mpif90 c FCFLAGS 03 EX EX BINROOT BINROOT TYPE hpcd MAKE LD mpif90 o LDFLAGS 00 g C FC mpif90 c FCFLAGS 00 g C EX EX BINROOT BINROOT TYPE lake MAKE LD opt intel compiler70 ia32 bin ifc v o LDFLAGS 03 xW prec_div L opt mpich intel lib lmpich L opt intel compiler70 ia32 lib 1PEPCF90 FC opt intel compiler70 ia32 bin ifc c FCFLAGS 03 xW prec_div I opt mpich intel include EX EX BINROOT BINROOT TYPE 228 STFC Appendix C Linux efc SGI ALTIX parallel FFT newton MAKE LD ifort o LDFLAGS tpp2 ip 03 lmpi lguide FC ifort c FCFLAGS 03 tpp2 ip w EX EX BINROOT BI
394. rs CB PMF RATTLE VV versus SHAKE LFV are involved and or ii RB dynamics is integrated The LFV integration may take less cpu time than the VV one for the certain ensembles type of system CB PMF RB and type of ensemble dependent Usually LFV is slightly faster than VV when CB PMF RB are present in the system The relative performance between the LVF and VV integration per timestep is observed to vary in the limits ek LFV t VV t VV t 5 5 However the VV algorithms treat CB PMF RB entities in a more precise symplectic manner than the LFV ones and thus not only have better numerical stability but also produce more accurate dynamics Makefiles amp compilation From within the source directory the user may compile the code by selecting the appropriate Makefile from the build directory and copying it across by typing at the command line cp build Makefile_MPI Makefile intended for parallel execution on multi processor platforms an MPI implementation is needed or cp build Makefile_SRLx Makefile intended for serial execution no MPI required followed by lt Enter gt Note that in comms_module f90 it is crucial that line 13 reads as Use mpi_module for serial compilation or as Use mpi for parallel compilation which is the default If the parallel OS environment one is compiling on is not fully F90 compatible then the Use mpi entry in the comms_module f90
395. s described above DL POLY 4 routine EXCHANGE_PARTICLES Once the neighbour list has been constructed each node of the parallel computer may proceed independently to calculate the pair force contributions to the atomic forces see routine TWO_BODY_FORCES 181 STFC Section 7 1 The potential energy and forces arising from the non bonded interactions as well as metal and Ter soff interactions are calculated using interpolation tables These are generated in the following routines VDW_GENERATE METAL_GENERATE METAL_TABLE_DERIVATIVES and TERSOFF_GENERATE 7 1 4 Modifications for the Ewald Sum For systems with periodic boundary conditions DL_POLY_4 employs the Ewald Sum to calculate the coulom bic interactions see Section 2 4 5 It should be noted that DL POLY_4 uses only the Smoothed Particle Mesh SPME form of the Ewald sum Calculation of the real space component in DL_POLY_4 employs the algorithm for the calculation of the non bonded interactions outlined above since the real space interactions are now short ranged implemented in EWALD_REAL_FORCES routine The reciprocal space component is calculated using Fast Fourier Transform FFT scheme of the SMPE method 66 85 as discussed in Section 2 4 5 The parallelisation of this scheme is entirely handled within the DL_POLY _4 by the 3D FFT routine PARALLEL_FFT using GPFA_MODULE which is known as the Daresbury advanced Fourier Transform due to I J Bush 86 This routine
396. s maxdis 0 10 Angstroms mxstep 0 005 pico seconds SUMULATION amp EQUILIBRATION LENGTH steps 10000 steps equilibration 1000 steps EQUILIBRATION DIRECTIVES Zero cap 2000 kT Angstrom scale 5 steps regauss 3 steps minimise force 20 1 0 optimise energy 0 001 STATISTICS collect 120 STFC Section 6 1 stack 50 deep stats 10 steps OUTPUT print 2 steps HISTORY replay trajectory 20 30 0 DEFECTS TRAJECTORY DEFECTS defects 40 15 0 75 DISPLACEMENTS TRAJECTORY RSDDAT displacements 70 10 0 25 MSDTMP msdtmp 1000 100 INTRAMOLECULAR PDF ANALYSIS BY TYPE IF PRESENT analyse bonds sample every 100 nbins 250 rmax 5 0 analyse angles sample every 100 nbins 360 0 pi analyse diherals sample every 100 nbins 720 pi pi analyse inversions sample every 100 nbins 360 0 pil INTRAMOLECULAR PDF ANALYSIS FOR ALL TYPES PRESENT analyse all sample every 100 nbins 1000 rmax 5 0 PRINT ANY DEFINED INTER RDF gt VDW INTRA bonded MOLECULAR PDF ANALYSIS print analysis RDF amp Z DENSITY binsize 0 05 Angstroms rdf 7 steps print rdf zden 7 steps print zden EXECUTION TIME job time 1000 seconds close time 10 seconds FINISH finish 6 1 1 1 The CONTROL File Format The file is free formatted and not case sensitive Every line is treated as a command sentence record Commented records beginning with a and blank lines are not processed and may be added to aid leg
397. s and remove inappropriate specifications Message 432 error undefined tersoff potential This shows that DL _POLY_4 has encountered an unfamiliar entry for Tersoff potentials in FIELD Action Correct FIELD and resubmit Message 433 error rcut must be specified for the Ewald sum precision When specifying the desired precision for the Ewald sum in the CONTROL file it is also necessary to specify the real space cutoff rcut Action Place the cut directive before the ewald precision directive in the CONTROL file and rerun Message 436 error unrecognised ensemble An unknown ensemble option has been specified in the CONTROL file Action Locate ensemble directive in the CONTROL file and amend appropriately Message 440 error undefined angular potential A form of angular potential has been requested which DL_POLY 4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL_POLY 4 if this is possible Alternatively you may consider defining the required potential in the code yourself Amendments to subroutines READ_FIELD and ANGLES_FORCES will be required Message 442 error undefined three body potential A form of three body potential has been requested which DL_POLY 4 does not recognise Action Locate the offending potential in the FIELD file and remove Replace with one acceptable to DL POLY_4 if this is reasonable Alternatively you may consid
398. s applied to complex molecular systems as follows 1 Using the atomic coordinates r each processor calculates the forces acting between the atoms in its domain this requires additional information in the form of the halo data which must be passed from the neighbouring processors beforehand The forces are usually comprised of 179 STFC Section 7 1 All common forms of non bonded atom atom van der Waals forces Atom atom and site site coulombic forces Metal metal local density dependent forces Tersoff local density dependent forces for hydro carbons 17 Three body valence angle and hydrogen bond forces Four body inversion forces Tether forces Chemical bond forces Valence angle forces Dihedral angle and improper dihedral angle forces Inversion angle forces Ion core shell polarasation External field forces 2 The computed forces are accumulated in atomic force arrays f independently on each processor 3 The force arrays are used to update the atomic velocities and positions of all the atoms in the domain 4 Any atom which effectively moves from one domain to another is relocated to the neighbouring processor responsible for that domain It is important to note that load balancing i e equal and concurrent use of all processors is an essential requirement of the overall algorithm In DL_POLY 4 this is accomplished quite naturally through the DD partitioning of the si
399. sation routine in the DL_POLY_4 scope It depends on KINDS_F90 and its allocation method on SETUP_MODULE e ewald module EWALD_MODULE This module defines all variables and arrays needed for the refreshment of SPME k space driven properties in the DL_POLY_4 scope when an infrequent SPME option is opted for in CONTROL It depends on KINDS_F90 and its allocation method on SETUP_MODULE e msd module MSD_MODULE This module globalises a CONTROL variable e statistics module STATISTICS_MODULE This module defines all variables and arrays needed for the statistical accountancy of a simula tion in DL_POLY_4 It depends on KINDS_F90 and its allocation methods on SETUP_MODULE and COMMS_MODULE e greenkubo module GREENKUBO_MODULE This module defines all variables and arrays needed for calculation of Green Kubo relations during a simulation in DL_POLY_4 It depends on KINDS_F90 and its allocation methods on SETUP_MODULE e kinetic module KINETIC_MODULE The kinetic module contains a collection of routines for the calculation of various kinetic properties It is dependent on KINDS_F90 7 2 2 File Structure Generally the DL_POLY_4 file structure can be divided into four groups as follows e module files in the source directory KINDS_F90 COMMS_MODULE SETUP_MODULE PARSE_MODULE DEVELOPMENT_MODULE IO_MODULE DOMAINS_MODULE SITE_MODULE CONFIG_MODULE VNL_MODULE DEFECTS_MODULE DEFECTS1_MODULE VDW_MODULE METAL_MODULE TERSOFF_MODULE TH
400. se co 26444585 a aa a Pee ER A E 6 13 0 Memory Management s re ear ar be Bb ao eee RA a e a E a g 6 134 Target Plstlorms s ss saga ee ee a a a ae ae ae ee a 7 1 35 Internal Documentation lt v2 4 sootaga a ee PE eee a ee a 7 1 3 6 FORTRAN9O Parameters and Arithmetic Precision 4 7 len TUS coo 2 GR Geek See e OS He eee Eas 7 13 8 Terror Messages ecce cora eo waa Se eee a a GE ee ES 8 STFC Contents LA Directory Structure 2 243 4 444 42 68 4858 8h FA eed EASES EGG REE eS 8 LAL The source Subsditectary Lisa add he ew eS a Se ee ee 9 14 2 Theunhty sule directory 2 4 a oxen ee ea be EA ee ee ge ee 9 1 43 The data Sub directory 08 Bee aR REE HOA Ee REG ee a 9 LAA Thesbeneh Sub directory sa cea ado dee a a ee a le DE ee ee 9 L amp S The exerute Sub direeiory s sos ec Se Ree es ee Boe a gow ee Bee oe ye Bee 9 Ao The build Sub directory hop mr eh eae A EEO eS 9 14 7 The public Subsdirectory cese ici ee Pe wee Ee a ee 9 LACS The paca Sub direchOry nois ee eee ek a ey a ee Be eee oe eg ee 10 Lb Obtaining the Source Code 1 2 2k 4s deb ea bee ede ee we hee Rae 10 1 6 OS and Hardware Specific Ports lt o seo sarea 4 e342 be RRR ERE Ge ee ee ee 10 LT Other Information ee ee ey ees 10 2 Force Field Interactions 11 2 1 Introduction to the DL_POLY_4 Force Field o o aas 12 2 2 The Intramolecular Potential Functions se s sa s saas gt a rese eee eee 13 221 Bond Potenti
401. simulations There may however be some difficulty with array sizes DL_POLY_4 contains features which allocate arrays after scanning the input files for a simulation Sometimes these initial estimates are insufficient for a long simulation when for example the system volume changes markedly during the simulation or when a system is artificially constructed to have a non uniform density Usually simply restarting the program will cure the problem but sometimes especially when the local atom density is somewhat higher than the global one or the system undergoes some form of clustering and the distribution of bonded like interactions is far from uniform it may be necessary to amend the array sizes in accordance with the error message obtained To trigger lengthening of the density dependent global arrays the user may use the densvar option in the CONTROL Section 6 1 1 file However lengthening these arrays will require a larger amount of memory from the 103 STFC Section 5 1 execution machine for the simulation which it may not be able to provide See Section 7 2 2 for more insight on the DL POLY_4 source code structure 5 1 2 Constructing Non standard Versions In constructing a non standard DL_POLY_4 simulation program the first requirement is for the user to write a program to function as the root segment The root segment VV DL_POLY is placed in the source directory and contains the set up and close down calls for a molecular dynami
402. sive from one another If none is specified then none is applied 2 Some directives are optional If not specified DL_POLY_4 may give default values if necessary Some but not all defaults are specified above in the list of directives However fail safe DL_POLY_4 is not 131 STFC Section 6 1 always will it assume a default value for certain parameters To enable DL_POLY_4 to be even more liberal in the fail safe features users are recommended to use no strict option 3 The steps and equilibration directives have a default of zero If not used or used with their de fault values a dry run is performed This includes force generation and system dump REVCON and REVIVE and depending on the rest of the options may include velocity generation force capping application of the CGM minimiser application of the pseudo thermostat and dumps of HIS TORY DEFECTS RDFDAT ZDNDAT and MSDTMP Note that since no actual dynamics is to be performed the temperature and pressure directives do not play any role and are therefore not necessary 4 If the CGM minimiser minimise is specified with zero frequency it is only applied at timestep zero if equilibration gt steps i e optimise structure at start only This is equvalent to using the optimise directive In this way it can be used as a configuration optimiser at the beginning of the equilibration period or when a dry run steps 0 is performed i e equilibrate without any
403. specify the sides of a cube not a radius of convergence 114 STFC Section 5 4 sum are negligible for terms with r gt reut The relative error e in the real space sum truncated at reut is given approximately by ex erfe reut Teut E eXP Teut 7 Teut 5 3 The recommended value for is 3 2 r u or greater too large a value will make the reciprocal space sum very slowly convergent This gives a relative error in the energy of no greater than e 4 x 107 in the real space sum When using the directive ewald precision DL_POLY_4 makes use of a more sophisticated approximation erfc x 0 56 exp 2x x 5 4 to solve recursively for a using equation 5 3 to give the first guess The relative error in the reciprocal space term is approximately EX exp Kira 400 Kira 5 5 where de T max kmar 5 6 La 5 6 is largest k vector considered in reciprocal space L is the width of the cell in the specified direction and kmax is an integer For a relative error of 4 x 1075 this means using kmar 6 2 a kmax is then kmax gt 6 4 L reut 5 7 In a cubic system Teut L 2 implies kmax 14 In practice the above equation slightly over estimates the value of kmax required so optimal values need to be found experimentally In the above example kmax 10 or 12 would be adequate If you wish to set the Ewald parameters manually via the ewald sum or spme sum directives the recommended approach is as follows
404. spectively corrects the bond velocities c After the correction equation 3 18 has been applied to all bonds every bond velocity is checked against the above condition If the largest deviation found exceeds the desired tolerance the correction calculation is repeated d Steps b and c are repeated until all bonds satisfy the convergence criterion this iteration constitutes stage 2 of the RATTLE_VV2 algorithm The parallel version of the RATTLE algorithm as implemented in DL_POLY_4 is derived from the RD_SHAKE algorithm 8 although its implementation in the Domain Decomposition framework requires no global merging operations and is consequently significantly more efficient The routine CONSTRAINTS_SHAKE is called to apply corrections to the atomic positions and the routine CONSTRAINTS_RATTLE to apply cor rections to the atomic velocities of constrained particles 62 STFC Section 3 4 It should be noted that the fully converged constraint forces Gj make a contribution to the system virial and the stress tensor The contribution to be added to the atomic virial for each constrained bond is The contribution to be added to the atomic stress tensor for each constrained bond is given by or dG 3 21 where a and indicate the x y z components The atomic stress tensor derived from the pair forces is symmetric 3 3 Potential of Mean Force PMF Constraints and the Evaluation of Free Energy A generalizati
405. stem CONTROL FIELD CONFIG andi alternatively HISTORY 4 2 Intramolecular Probability Distribution Function PDF Analysis Albeit the distribution analysis can be performed on the fly in the course of a simulation run for CG purposes it has to be done on an existing CG mapped trajectory by invoking the replay history and analysis directives see Section 6 1 1 To trigger the PDF collection and subsequent output of PMF s for any of the following intarmolecular interactions bonds angles dihedrals and or inversions the CONTROL file must contain any combination of the options demonstrated in the example below TITLE EXAMPLE OF DL_POLY_4 PDF ANALYSIS DIRECTIVES SNIPPET DIRECTIVES TO INVOKE INTRAMOLECULAR PDF ANALYSIS BY TYPE analyse bonds sample every 100 nbins 250 rmax 5 0 analyse angles sample every 100 nbins 360 0 pi analyse diherals sample every 100 nbins 720 pi pil 97 STFC Section 4 2 analyse inversions sample every 100 nbins 360 0 pil DIRECTIVES TO INVOKE INTRAMOLECULAR PDF ANALYSIS FOR ALL TYPES analyse all sample every 100 nbins 1000 rmax 5 0 DIRECTIVES TO INVOKE PRINTING FOR ANY DEFINED INTER RDF gt VDW amp INTRA bonded MOLECULAR PDF ANALYSIS print analysis The analyse directive acts in a similar manner to that of the rdf directive outlining i the frequency of sampling in steps frames and ii the number of bins over the cutoff interval of the specified interaction It is only f
406. t At 3 32 5 Thermostat Dult f t X00 to 3 33 Several iterations are required to obtain self consistency In DL POLY 4 the number of iterations is set to 8 9 if bond constraints are present The conserved quantity by these algorithms is the system kinetic energy The VV and LFV flavours of the Gaussian constraints algorithm are implemented in the DL_POLY 4 routines NVT_EO_VV and NVT_EO_LFV respectively The routines NVT_El_VV and NVT_El_LFV implement the same but also incorporate RB dynamics 3 4 2 Langevin Thermostat The Langevin thermostat works by coupling every particle to a viscous background and a stochastic heath bath Brownian dynamics such that drj t dt v t A di A ai P where x is the user defined constant positive in units of ps7 specifying the thermostat friction parameter and R t is stochastic force with zero mean that satisfies the fluctuation dissipation theorem REE REW 2 x mi kBT sij bog lt t 3 35 where superscripts denote Cartesian indices subscripts particle indices kg is the Boltzmann constant T the target temperature and m the particle s mass The Stokes Einstein relation for the diffusion coefficient can then be used to show that the average value of R t over a time step in thermal equilibrium should be a random deviate drawn from a Gaussian distribution of zero mean and unit variance Gauss 0 1 scaled 2x mi kgT by y 74 65 STFC Section 3 4
407. t access to source code for modification and inspection In the spirit of the enterprise contributions in the form of working code are welcome provided the code is compatible with DL_POLY_4 in regard to its interfaces and programming style and it is adequately documented STFC Preface DISCLAIMER Neither the STFC EPSRC NERC CCP5 nor any of the authors of the DL_POLY_4 package or its derivatives guarantee that the package is free from error Neither do they accept responsibility for any loss or damage that results from its use STFC Preface ACKNOWLEDGEMENTS DL_POLY_4 was developed at Daresbury Laboratory DL http www dl ac uk the Science and Tech nology Facilities Council STFC http www stfc ac uk UK with support from the Engineering and Physical Sciences Research Council EPSRC http www epsrc ac uk and the Natural Environment Re search Council NERC http www nerc ac uk Advice assistance and encouragement in the development of DL_POLY_4 has been given by many peo ple We gratefully acknowledge the following T R Forester I J Bush M Leslie M F Guest R J Allan D Tildesley M Pinches D Rapaport the UK s Materials Chemistry Consortium under C R A Catlow and the eMinerals project under M T Dove This document is produced with BIFX amp hdvipdfm iii STFC Preface Manual Notation In the DL_POLY manuals specific fonts are used to convey specific meanings 1
408. t consists of 7 sections Header Simulation control specifications Force field specification System specification Summary of the initial configuration Simulation progress Sample of the final configu ration Summary of statistical data and Radial distribution functions and Z density profile These sections are written by different subroutines at various stages of a job Creation of the OUTPUT file always results from running DL_POLY_4 It is meant to be a human readable file destined for hardcopy output 169 STFC Section 6 2 6 2 6 1 Header Gives the DL POLY_4 version number the number of processors in use the link cell algorithm in use and a title for the job as given in the header line of the input file CONTROL This part of the file is written from the subroutines DL_POLY_ SET_BOUNDS and READ_CONTROL 6 2 6 2 Simulation Control Specifications Echoes the input from the CONTROL file Some variables may be reset if illegal values were specified in the CONTROL file This part of the file is written from the subroutine READ CONTROL 6 2 6 3 Force Field Specification Echoes the FIELD file A warning line will be printed if the system is not electrically neutral This warning will appear immediately before the non bonded short range potential specifications This part of the file is written from the subroutine READ_FIELD 6 2 6 4 System Specification Echoes system name periodic boundary specification the cell vectors and vol
409. t equation of motion and the conserved quantity to Taa t Pext Yext hz t Vit 2Exin t 1 d Pmass f Pmass X t Naa t a b T y Pre t o 2 get za D Pasi VO y 22800 9 4 a Pr O i mpl0 0 a B w 4 2 89 STFC Section 3 6 d 2E kin t Pmass Tr n t n t 20 3 kp Text y t 3 170 qe dmass dmass x t Pmass Trin 1 t HNPayT HNVE Pox V t f 3 kp Text x s ds gt 2 2 where Yext is the user defined external surface tension and h t V t Azy t is the instantaneous hight of the MD box or MD box volume over area One defines the instantaneous surface tension as given in equation 3 120 The case Yext 0 generates the NPT anisotropic ensemble for the orthorhombic cell imcon 2 in CONFIG see Appendix A This can be considered as an orthorhombic constraint on the NoT ensemble The constraint can be strengthened further to a semi orthorhombic one by imposing that the MD cell change isotropically in the x y plane which leads to the following changes in the equations above al orn t T Tyy t 2 Pext Yext hz t V t ae 2 Exin t x t Naa t dt Pmass f Pmass cda P 23 3 171 2 mass T d 1 t Hypayaor Huye E XU Pms EE Pow V 1 F 2 be Tow ads Although the Martyna Tuckerman Klein equations of motion have same conserved quantities as the Nos Hoover s ones they are proven to generate ensembles t
410. t_b0_vv f90 nvt_h0_vv f90 nvt_g0_vv f90 npt_10_vv f90 npt_b0_vv f90 npt_h0_vv f90 npt_m0_vv f90 nst_10_vv f90 nst_b0_vv f90 nst_h0_vv f90 nst_m0_vv f90 nvt_hi_scl f90 nvt_g1_sc1 f90 npt_h1_sc1 f90 nst_h1_sc1 f90 235 STFC Appendix C nve_1_vv f90 nvt_el_vv f90 nvt_11_vv f90 nvt_al_vv f90 nvt_b1_vv f90 nvt_h1_vv f90 nvt_gi_vv f90 npt_11_vv f90 npt_b1_vv f90 npt_h1_vv f90 npt_mi_vv f90 nst_11_vv f90 nst_b1_vv f90 nst_h1_vv f90 nst_m1_vv f90 w_at_start_vv f90 w_integrate_vv f90 w_md_vv f90 Define LeapFrog Verlet files FILES_LFV pseudo_lfv f90 constraints_shake_lfv f90 pmf_shake_lfv f90 nve_O_lfv f90 nvt_e0_lfv f90 nvt_10_1fv f90 nvt_a0_1fv f90 nvt_bO_lfv f90 nvt_h0_1fv f90 nvt_g0_1fv f90 npt_10_1fv f90 npt_b0_1fv f90 npt_h0_1fv f90 npt_m0_1fv f90 nst_10_1fv f90 nst_b0_1fv f90 nst_h0_1fv f90 nst_m0_1fv f90 nve_1_lfv f90 nvt_e1_lfv f90 nvt_11_1fv f90 nvt_al_1fv f90 nvt_b1_lfv f90 nvt_h1_1fv f90 nvt_g1_1fv f90 npt_11_1fv f90 npt_b1_1fv f90 npt_h1_1fv f90 npt_m1_1fv f90 nst_li_lfv f90 nst_b1_1fv f90 nst_h1_1fv f90 nst_m1_1fv f90 w_at_start_lfv f90 w_integrate_lfv f90 w_md_1fv f90 Examine targets manually all echo echo You MUST specify or choose a permissive target platform echo echo The available permissive targets are displayed below echo echo win win debug echo echo Please examine this Makefile s targets for details echo If no target suits you
411. t_m0_vv o nvt_hi_scl o nvt_g1_scl o npt_hi_scl o nst_hi_scl o A nve_1_vv o nvt_el_vv o A nvt_li_vv o nvt_al_vv o nvt_b1_vv o nvt_hi_vv o nvt_gi_vv o npt_li_vv o npt_b1_vv o npt_h1_vv o npt_mi_vv o nst_li_vv o nst_b1_vv o nst_hi_vv o nst_mi_vv o pseudo_lfv o constraints_shake_lfv o pmf_shake_lfv o nve_0_lfv o nvt_e0_lfv o nvt_10_1fv o nvt_a0_lfv o nvt_bO_lfv o nvt_h0_lfv o nvt_g0_lfv o npt_10_lfv o npt_bO_lfv o npt_h0_1lfv o npt_m0_lfv o nst_10_lfv o nst_bO_lfv o nst_hO_lfv o nst_m0_lfv o nve_1_lfv o nvt_el_lfv o nvt_li_lfv o nvt_al_lfv o nvt_b1_lfv o nvt_h1_lfv o nvt_gi_lfv o npt_11_1fv o npt_b1_lfv o npt_hi_lfv o npt_mi_lfv o A nst_li_lfv o nst_b1_l1lfv o nst_hi_lfv o nst_m1_lfv o xscale o core_shell_kinetic o regauss_temperature o z_density_collect o statistics_collect o statistics_connect_set o statistics_connect_spread o statistics_connect_frames o system_revive o rdf_compute o z_density_compute o vaf_compute o bonds_compute o angles_compute o dihedrals_compute o inversions_compute o statistics_result o dl_poly o Define MPI SERIAL files FILES_SERIAL mpi_module f90 mpif h ewald_spme_forc s f90 Define Velocity Verlet files FILES VV pseudo_vv f90 constraints_shake_vv f90 pmf_shake_vv f90 constraints_rattle f90 pmf_rattle f90 nvt_h0_sc1 f90 nvt_g0_scl f90 npt_h0_sc1 f90 nst_h0_sc1 f90 nve_0_vv f90 nvt_e0_vv f90 nvt_10_vv f90 nvt_a0_vv f90 nv
412. tabulated potential fnsc Finnis Sinclair co ceca A U r 5 2 rij c co Cerri car Api 3 A Lo 3 d B p dv Oris d 4 pois j i exfs Extended co c ca cg ca U r 5 p gt rij c co crrij cari car cari Finnis Sinclair c A d B AVE 2 ri d B ri d JA en l uP stch Sutton Chen e la n m ec Uri Se E i 5 c g Pi gt 4 JA IAA gupt Gupta Alro p B a Lt can p EP 2 exp 2 go mbpc MBPC clalm cid U r e Ppi pi DV a r j i 3 rdf n where n is the number of RDF pairs to be entered It is followed by n records each specifying a particular RDF pair in the following manner atmnam 1 a8 first atom type atmnam 2 a8 second atom type By default in DL POLY Classic and DL_POLY_4 every vdw and met potential specifies an RDF pair If the control option rdf f is specified in the CONTROL file then all pairs defined in vdw and or met potentials sections will also have their RDF calculated The user has two choices to enable the calculation of RDFs in systems with force fields that do not have vdw and or met potentials i to define fictitious potentials with zero contributions or ii to use rdf n option which not only provides a neater way for specification of RDF pairs but also better memory efficiency since DL_POLY_4 will 153 STFC Section 6 1 not allocate additional potential arrays for fictitious interactions that
413. tandard output file and terminates the program All terminations of the program are global i e every node of the parallel computer will be informed of the termination condition and stop executing In addition to terminal error messages DL POLY_4 will sometimes print warning messages These indicate that the code has detected something that is unusual or inconsistent The detection is non fatal but the user should make sure that the warning does represent a harmless condition 1 4 Directory Structure The entire DL_POLY_4 package is stored in a UNIX directory structure The topmost directory is named dl_poly_4 nn where nn is a generation number Beneath this directory are several sub directories named source utility data bench execute build public and java Briefly the content of each sub directory is as follows sub directory contents source primary subroutines for the DL_POLY_4 package utility subroutines programs and example data for all utilities data example input and output files for DL_POLY_4 bench large test cases suitable for benchmarking execute the DL_POLY_4 run time directory build makefiles to assemble and compile DL POLY_4 programs public directory of routines donated by DL_POLY_4 users java directory of Java and FORTRAN routines for the Java GUI A more detailed description of each sub directory follows STFC Section 1 4 1 4 1 The source Sub directory In this sub directory all the essential sourc
414. te with an array allocation failure message As a default DL_POLY_4 does not store statistical data during the equilibration period If the directive collect is used equilibration data will be incorporated into the overall statistics The vaf directive switches on velocity autocorrelation function VAF calculations for individual atomic species in DL_POLY 4 after equilibration or immediately at start if the directive collect is used It controls how often VAF profiles are started what the size of each profile in timesteps Overlapping profiles are possible and require more memory to store them and initial velocities while they are being calculated By default DL_POLY_4 will report time averaged VAF profiles This can be overridden using the no vafaveraging directive which will instead report individual instantaneous VAF profiles io action options controls how I O is performed by DL_POLY_4 The options can help the perfor mance of I O operations within DL_POLY 4 for potentially large files during the run The form of the command depends on the value of action which may take the value either read or write In general this command should only be used for tuning the I O subsystem in DL_POLY 4 for large runs For small to average sized systems the built in defaults usually suffice a io read method options With action set to read the io command controls how the reading of large files is performed method controls how the disk is a
415. ted data records need not be specified if the molecule contains no flexible chemical bonds See the note on the atomic indices appearing under the shell directive above Table 6 8 Chemical Bond Potentials key potential type Variables 1 4 functional form harm Harmonic k ro U r 5 k rij roy hrm mors Morse Eo ro k U r Eo 1 exp k rij r0 1 mrs 12 6 12 6 A B U r 4 4 ij ij 126 12 6 lj Lennard Jones e o U r 4e 5 2 lj rhrm Restraint k ro Ire U r 5 k rij ro rij rol lt re rhm U r kr k rellrij rol Te rij rol gt re quar Quartic k ro k k U r k rij ro E r ro qur E rij ro buck Buckingham Al p C U r A exp 7 GS ij bck ectrostatics _k itj coul Coulomb k U r kr 42 cul AN2 fene Shifted FENE k Ro A U r 0 5 k Ry In 1 z 2 Ee TRN fne 33 34 35 U r rij gt Ro A amoe AMOEBA 36 k ro U r k 8 1 2 55 6 7 12 2 55 9 6 r ro amo FF bond Note A defaults to zero if A gt 0 5 Ro or if it is not specified in the FIELD file Note Bond potentials with a dash as the first character of the keyword do not contribute to the excluded atoms list see Section 2 In this case DL_POLY_4 will also calculate the non bonded pair potentials between the described atoms unless these are deactivate
416. ted in the same manner as for the conventional Ewald sum The DL_POLY_4 subroutines required to calculate the SPME contributions are 1 SPME_CONTAINER containing a BSPGEN which calculates the B splines b BSPCOE which calculates B spline coefficients c SPL_CEXP which calculates the FFT and B spline complex exponentials 2 PARALLEL_FFT and GPFA MODULE native DL POLY_4 subroutines that respect the domain decom position concept which calculate the 3D complex fast Fourier transforms 3 EWALD_SPME_FORCES which calculates the reciprocal space contributions uncorrected 4 EWALD_REAL_FORCES which calculates the real space contributions corrected 5 EWALD_EXCL_FORCES which calculates the reciprocal space corrections due to the coulombic exclusions in intramolecular interactions 6 EWALD_FRZN_FORCES which calculates the reciprocal space corrections due to the exclusion interac tions between frozen atoms 7 TWO_BODY_FORCES in which all of the above subroutines are called sequentially and also the Fuchs correction 65 for electrically non neutral MD cells is applied if needed ol STFC Section 2 5 2 5 Polarisation Shell Models An atom or ion is polarisable if it develops a dipole moment when placed in an electric field It is commonly expressed by the equation p aE 2 226 where yz is the induced dipole and E is the electric field The constant a is the polarisability In the static shell model a polarisable ato
417. teractions in the FIELD file are processed Various other subroutines are then called to calculate specific contributions by different interactions For example VDW_FORCES for the short range van der Waals forces Section 2 3 1 METAL_LRC METAL_LD COMPUTE and METAL_FORCES for the metal interactions Section 2 3 2 and EWALD_SPME_FORCES EWALD_REAL_FORCES EWALD_FRZN_FORCES and EWALD_EXCL_FORCES for the Coulombic forces Section 2 4 Higher order intermolecular site related and intramolecular forces require the routines TERSOFF_FORCES THREE_BODY_FORCES FOUR_BODY_FORCES CORE_SHELL_FORCES or CORE_SHELL_RELAX TETHERS_FORCES BONDS_FORCES ANGLES_FORCES DIHEDRALS_FORCES and INVERSIONS_FORCES The routines EXTERNAL_FIELD_APPLY and EXTERNAL_FIELD_CORRECT are required if the simulated system has an ex ternal force field e g electrostatic field operating To help with equilibration simulations routines such as CAP_FORCES ZERO_K_OPTIMISE and MINIMISE_RELAX are sometimes required to reduce the magnitude of badly equilibrated forces and to steer the MD system towards an equilibrium state Integration of the equations of motion is handled by one of the routines listed and described in Chapter 3 As mentioned elsewhere DL_POLY_4 does not contain many routines for computing system properties dur ing a simulation Radial distributions may be calculated however by using the routines RDF_COLLECT RDF_EXCL_COLLECT RDF_FRZN_COLLECT a and RDF
418. teratomic bond vector sace aci aee eae ae A ea a es 13 The valence angle and associated vectors aooo ea a ee 16 The dihedral angle and associated vectors 1 osoa a ee 19 The L and D enantiomers and defining vectors 2 2 2 e eee eee eee 22 The inversion angle and associated vectors 6 e 22 The vectors of the calcite potential e 25 The SHAKE RATTLE_VV1 schematics and associated vectors o o 61 DLPOLY A input left and output right Dl y is ed a e Soe aes 118 Thevcubie MD cell 2 ios a wh roa aria a oai aoa Re Pw RE ee eS ae ia 199 The orthorhomie MD cell css es amaa ORE Re ee ea BR ee ee OS 199 The parallelepiped MD cell o ee 199 xii Chapter 0 Quick Word INSTALL amp RUN For the experienced and quick minded this is a very brief resume of how to INSTALL amp RUN DL_POLY 4 which is no excuse for skipping the Introduction Chapter 1 For the rest of us it sketches out how to start running DL_POLY_4 jobs and where one should look to obtain more detailed information if need be If you have followed the procedure for obtaining and downloading the DL POLY_4 package see Obtain ing the Source Code Section 7 have successfully unpacked it and are ready to compile the source code then jump to the Makefiles section of the DL_POLY_4 README Appendix E or alternatively view the README TXT in source and follow the instructions within If you have compiled su
419. that imcon MUST BE 4 0 REFERENCE may contain more or less particles than CONFIG does and may have particles with identities that are not defined in FIELD see Section 6 1 3 The positions of these particles are used to define the crystalline lattice sites to whitch the particles in CONFIG compare during simulation when the defect detection option defects is used REFERENCE is read by the subroutine DEFECTS_REFERENCE_READ 6 1 5 The REVOLD File This file contains statistics arrays from a previous job It is not required if the current job is not a con tinuation of a previous run i e if the restart directive is not present in the CONTROL file see above The file is unformatted and therefore not human readable DL_POLY_4 normally produces the file REVIVE see Section 6 2 8 at the end of a job which contains the statistics data REVIVE should be copied to REVOLD before a continuation run commences This may be done by the copy macro supplied in the execute sub directory of DL_POLY_4 6 1 5 1 Format The REVOLD file is unformatted All variables appearing are written in native working precision see Section 5 3 5 real representation Nominally integer quantities e g the timestep number nstep are represented by the nearest real number The contents are as follows the dimensions of array variables are given in brackets in terms of parameters from the SETUP_MODULE file see Section 7 2 8 159 STFC Section 6 1 record 1 nstep
420. the ASCII lines of output files human readable to a constant length Printing scrambled outputs is optional Note that these too have blanks aligned records The parallel I O ensures i writing speeds of 1075 to 1076 particle per second with optimal number of writers and ii reading speeds of 10 4 to 10 5 particles per second per reader For more information on I O options consult the user manual 2 REVIVE files produced by different versions are not compatible Furthermore restarting runs across different sub versions may not be possible 3 The DL_POLY_4 parallel performance and efficiency are considered very good to excellent as long as i all CPU cores are loaded with no less than 500 particles each and ii the major linked cells algorithm has no dimension less than 4 4 Although DL_POLY_4 can be compiled in a serial mode users are advised to consider DL_POLY_Classic as a suitable alternative to DL_POLY_4 when simulations are likely to be serial jobs for systems containing lt 500 particles per processor In such circumstances with both codes compiled in serial mode the difference in performance measured by the time per timestep ratio DL_POLY_Classic t DL_POLY_4 t DL_POLY_Classic t varies in the range 5 5 This variation depends strongly on the system force field complexity and very weakly on the system size 5 The rpad no strict CONTROL options should be used with care especially in conjunction
421. the bond bending terms between the specified atoms They should not be confused with the three body potentials described later which are defined by atom types rather than indices 15 STFC Section 2 2 i Figure 2 2 The valence angle and associated vectors 1 Harmonic harm k U Ojik 5 jik 6 2 16 2 Quartic quar k 2 k 3 k 4 U 0jix 5 jik 90 Ojin 00 q Oir 00 2 17 3 Truncated harmonic thrm k 2 81 831 8 U Ojik 5 Ojik 00 expl ri rir P 2 18 4 Screened harmonic shrm k 2 U Ojik 5 Ojik 90 exp rij P1 rir p2 2 19 5 Screened Vessal 37 bvs1 k 5 212 U Ojik 8 ik T 0 Tr Ojik Tr x exp rij pi rik P2 2 20 6 Truncated Vessal 38 bvs2 U Ojix k Ojik 90 OF n Ojir O0 2m M1 expl r rh 6 2 21 7 Harmonic cosine hcos k U Ojik z cos 0jir cos 00 2 22 8 Cosine cos U Ojik A 1 cos m Ojik 2 23 9 MM3 stretch bend 39 mmsb U Ojik A Ojik 00 rij rij Tik THe 2 24 16 STFC Section 2 2 10 Compass stretch stretch 40 stst U Ojik A rig rij rik Tie 2 25 11 Compass stretch bend 40 stbe U Ojik A Ojik 00 rig r 2 26 12 Compass all terms 40 emps U Ojik A rig rij ik THe Ojik 00 B rig ri C rik 7 2 27 13 AMOEBA force field angl
422. the program Action Contact authors 255 STFC Appendix D Message 66 error coincidence of particles in bond angle unit DL_POLY_4 has found a fault in the definition of a bond angle in the FIELD file Action Correct the erroneous entry in FIELD and resubmit Message 67 error coincidence of particles in dihedral unit DL_POLY 4 has found a fault in the definition of a dihedral unit in the FIELD file Action Correct the erroneous entry in FIELD and resubmit Message 68 error coincidence of particles in inversion unit DL_POLY 4 has found a fault in the definition of a inversion unit in the FIELD file Action Correct the erroneous entry in FIELD and resubmit Message 69 error too many link cells required in three_body_forces This should not happen The calculation of three body forces in DL_POLY_4 is handled by the link cell algorithm This error arises if the required number of link cells exceeds the permitted array dimension in the code Action Consider using densvar option in CONTROL for extremely non equilibrium simulations Alternatively increase mxcell in SET_BOUNDS recompile and resubmit Message 70 error constraint_quench failure When a simulation with bond constraints is started DL_POLY_4 attempts to extract the kinetic energy of the constrained atom atom bonds arising from the assignment of initial random velocities If this procedure fails the program will terminate The likely ca
423. the thermostat buffer layer is coupled to a viscous background and a stochastic heat bath such that dr w v t oT gt LOIRO A ult 6 2 where x t is the friction parameter from the dynamics in the the MD cell and R t is stochastic force with zero mean that satisfies the fluctuation dissipation theorem REE RIY 2 x t mi kBT di das St t 6 3 where superscripts denote Cartesian indices subscripts particle indices kg is the Boltzmann constant T the bath temperature and m the particle s mass The algorithm is implemented in routine PSEUDO and has two stages Generate random forces on all particles within the thermostat Here care must be exercised to prevent introduction of non zero net force when the random forces are added to the system force field Rescale the kinetic energy of the thermostat bath so that particles within have Gaussian dis tributed kinetic energy with respect to the target temperature and determine the Gaussian constraint friction within the thermostat Dilfi t RH 2 a 3 6 4 2 x t Maz o Care must be exercised to prevent introduction of non zero net momentum Users are reminded to use for target temperature the temperature at which the original system was equilibrated in order to avoid simulation instabilities The effect of this algorithm is to relax the buffer region of the system on a local scale and to effectively dissipate the incoming excess kinetic
424. ther 4 12 26 171 180 255 272 tethered 55 three body 4 12 13 15 26 43 44 112 151 156 171 180 248 256 259 272 valence angle 4 12 13 15 17 21 22 43 44 112 148 149 171 180 181 253 van der Waals 13 15 18 21 105 106 136 148 151 269 quaternions 5 93 reaction field 48 49 128 136 rigid body 3 5 59 90 91 180 181 282 rigid bond see constraints bond stress tensor 15 18 21 24 26 28 35 43 47 49 52 55 63 74 sub directory 201 203 bench 8 build 8 data 8 execute 8 java 8 public 8 source 8 utility 8 thermostat 5 55 94 123 124 273 Nos Hoover 82 88 units DL_POLY 7 172 energy 143 pressure 7 8 83 127 171 172 temperature 130 user registration 10 Verlet neighbour list 104 181 182 261 WWW iii 3 10 97 112 113 197 304
425. thers_forces o intra_coul o bonds_forces o angles_forces o dihedrals_14_vdw o dihedrals_forces o inversions_forces o external_field_apply o external_field_correct o langevin_forces o constraints_pseudo_bonds o pmf_pseudo_bonds o rigid_bodies_split_torque o rigid_bodies_move o minimise_relax o core_shell_relax o zero_k_optimise o vaf_collect o nvt_e0_scl o nvt_el_scl o nvt_b0_scl o nvt_b1_scl o A pseudo_vv o 225 STFC Appendix C constraints_shake_vv o pmf_shake_vv o constraints_rattle o pmf_rattle o nvt_h0_scl o nvt_g0_scl o npt_h0_scl o nst_h0_scl o nve_0_vv o nvt_e0_vv o nvt_10_vv o nvt_a0_vv o nvt_b0_vv o nvt_h0_vv o nvt_g0_vv o npt_10_vv o npt_b0_vv o npt_h0_vv o npt_m0_vv o nst_10_vv o nst_b0_vv o nst_h0_vv o nst_m0_vv o nvt_hi_scl o nvt_g1_scl o npt_h1_scl o nst_hi_scl o nve_1_vv o nvt_el_vv o nvt_11_vv o nvt_al_vv o nvt_b1_vv o nvt_hi_vv o nvt_g1l_vv o npt_11_vv o npt_b1_vv o npt_hi_vv o npt_mi_vv o nst_11_vv o nst_b1_vv o nst_hi_vv o nst_mi_vv o A pseudo_lfv o constraints_shake_lfv o pmf_shake_lfv o nve_0_lfv o nvt_e0_lfv o nvt_10_1fv o nvt_a0_lfv o nvt_b0_lfv o nvt_h0_lfv o nvt_g0_lfv o npt_10_1fv o npt_bO_lfv o npt_hO_lfv o npt_m0_lfv o nst_10_1fv o nst_bO_lfv o nst_hO_lfv o nst_m0_lfv o nve_1_1lfv o nvt_el_lfv o nvt_li_lfv o nvt_al_lfv o nvt_b1_lfv o nvt_hi_lfv o nvt_g1i_lfv o npt_11_1fv o npt_b1_lfv o npt_hi_lfv o npt_m1_lfv o nst_11_1fv
426. tic energy too and Eo are respectively the kinetic and rotational energies of the system Pmass is the barostat mass and 7 and 7 are the barostat friction coefficient or matrix of coefficients respectively There are two slight technicalities with the Evans and Andersen ensembles that are worth mentioning Since both the translational and rotational velocities contribute towards temperature equation 3 24 show ing the derivation of the thermostat friction in the Evans ensemble by imposing a Gaussian constraint on the system s instantaneous temperature changes to d d 1 FP E 1 EB r 1 2B Ta i g x ai ee To 0 FP Eno DAX VO La t oh wont EM VA E FOI 3 207 J j of ut LO DF VA Bj DF ae 2 x t 2 Exin t Eroi where where TJ is the instantaneous temperature defined in equation 3 10 and Egin in the final expression contains both the kinetic contribution form the free particles and the RBs COMs In the case of the Andersen ensemble if a Poisson selected particle constitutes a RB then the whole RB is Poisson selected Poisson selected RBs translational and angular velocities together with Poisson selected FPs velocities sample the same Gaussian distribution isokinetically Boltzmann distribution where the isokineticity to target temperature is dependent upon the total of the Poisson selected FPs and RBs degrees of freedom 95 Chapter 4 Coarse Graining Functionality Sco
427. timestep of final configuration numacc number of configurations used in averages numrdf number of configurations used in RDF averages numzdn number of configurations used in Z density averages time elapsed simulation time tmst elapsed simulation before averages were switched on chit thermostat related quantity first chip barostat related quantity cint thermostat related quantity second record 2 eta scaling factors for simulation cell matrix elements 9 record 3 stpval instantaneous values of thermodynamic variables mxnstk record 4 sumval average values of thermodynamic variables mxnstk record 5 ssqval fluctuation squared of thermodynamic variables mxnstk record 6 zumval running totals of thermodynamic variables mxnstk record 7 ravval rolling averages of thermodynamic variables mxnstk record 8 stkval stacked values of thermodynamic variables mxstakxmxnstk record 9 strcon constraint bond stress 9 record 10 strpmf PMF constraint stress 9 record 11 stress atomic stress 9 record 12 Optional rdf RDF array mxgrdf xmxrdf record 13 Optional zdens Z density array mxgrdf xmxatyp record 14 Optional vaf VAF arrays sizes dependent on sampling frequency and VAF bin size 6 1 5 2 Further Comments Note that different versions of DL_POLY_4 may have a different order of the above parameters or include more or less such Therefore different versions of DL_POLY_4 may render any existing
428. timise option has been used during an equilibration simulation or a dry run 6 1 3 The FIELD File The FIELD file contains the force field information defining the nature of the molecular forces This infor mation explicitly includes the site topology of the system which sequence must be matched implicitly in the crystallographic description of the system in the CONFIG file The FIELD file is read by the subroutine READ FIELD It is also read by the subroutine SCAN_FIELD in the SET_BOUNDS routine Excerpts from a force field file are shown below The example is the antibiotic Valinomycin in a cluster of 146 water molecules Valinomycin Molecule with 146 SPC Waters UNITS kcal 141 STEC Section 6 1 MOLECULES 2 Valinomycin NUMMOLS 1 ATOMS 168 0 16 0000 0 4160 1 Os 16 0000 0 4550 1 HC 1 0080 0 0580 1 C 12 0100 0 4770 1 BONDS 78 harm 31 19 674 000 1 44900 harm 33 31 620 000 1 52600 harm 168 19 980 000 1 33500 harm 168 162 634 000 1 52200 CONSTRAINTS 90 20 19 1 000017 22 21 1 000032 166 164 1 000087 167 164 0 999968 ANGLES 312 harm 43 2 44 200 00 116 40 harm 69 5 70 200 00 116 40 harm 18 168 162 160 00 120 40 harm 19 168 162 140 00 116 60 DIHEDRALS 371 harm 1 43 2 44 2 3000 180 00 harm 31 43 2 44 2 3000 180 00 cos 149 17 161 16 10 500 180 00 cos 162 19 168 18 10 500 180 00 FINISH SPC Water NUMMOLS 146 ATOMS 3 OW 16 0000 0 8200 HW 1 0080 0 4100 HW 1 0080 0 4100 CONSTRAINTS 3 1 2 1 00
429. tine BONDS_FORCES The most significant consequence of the introduction of the BSM is that by coupling the repulsive interac tions via common shell radii it creates a many body effect that is able to reproduce the Cauchy violation C44 C12 for rock salt structured materials 53 STFC Section 2 6 2 5 4 Further Notes In DL_POLY_4 the core shell forces of the rigid shell model are handled by the routine CORE_SHELL_FORCES In case of the adiabatic shell model the kinetic energy is calculated by CORE_SHELL_KINETIC and temperature scaling applied by routine CORE_SHELL_QUENCH In case of the relaxed shell model shell are relaxed to zero force by CORE_SHELL_RELAXED All shell models can be used in conjunction with the methods for long ranged forces described above Note that DL_POLY_4 determines which shell model to use by scanning shell weights provided the FIELD file see Section 6 1 3 If all shells have zero weight the DL POLY_4 will choose the relaxed shell model If no shell has zero weight then DL_POLY 4 will choose the dynamical one In case when some shells are massless and some are not DL_POLY_4 will terminate execution controllably and provide information about the error and possible possible choices of action in the OUTPUT file see Section 6 2 6 2 6 External Fields In addition to the molecular force field DL_POLY_4 allows the use of an external force field Examples of fields available include 1 Electric field ele
430. tion 2 3 n functional forms of the density dependence i e the embedding function F p in equation 2 109 The matter is further complicated when the 2BEAM type of potential is used with the extra specification of n embedding functions and n n 1 2 density functions for the s band Similarly in the 2BEEAM an extra n embedding functions and n density functions for the s band are required It is worth noting that in the 2BEAM and 2BEEAM the s band contribution is usually only for the alloy component so that local concentrations of a single element revert to the standard EAM or EEAM In such case the densities functions must be zeroed in the DL_POLY_4 TABEAM file For EAM EEAM 2BEAM and 2BEEAM potentials all the functions are supplied in tabular form via the table file TABEAM see section 6 1 7 to which DL_POLY 4 is redirected by the FIELD file data The FS potentials are defined via the necessary parameters in the FIELD file 2 3 3 Tersoff Potentials The Tersoff 17 potential is is a bond order potential developed to be used in multi component covalent systems by an effective coupling of two body and higher many body correlations into one model The central idea is that in real systems the strength of each bond depends on the local environment i e an atom with many neighbors forms weaker bonds than an atom with few neighbors Effectively it is a pair potential the strength of which depends on the environment At the present there
431. tion 6 1 5 which is an exact copy of the previous REVIVE file If you attempt to restart DL_POLY_4 without this additional file available the job will most probably fail Note that DL_POLY_4 will append new data to the existing STATIS and HISTORY files if the run is restarted other output files will be overwritten In the event of machine failure you should be able to restart the job in the same way from the surviving REVCON and REVIVE files which are dumped at regular intervals to meet just such an emergency In this case check carefully that the input files are intact and use the HISTORY and STATIS files with caution there may be duplicated or missing records The reprieve processing capabilities of DL_POLY_4 are not foolproof the job may crash while these files are being written for example but they can help a great deal You are advised to keep backup copies of these files noting the times they were written to help you avoid going right back to the start of a simulation You can also extend a simulation beyond its initial allocation of timesteps provided you still have the REVCON and REVIVE files These should be copied to the CONFIG and REVOLD files respectively and the directive timesteps adjusted in the CONTROL file to the new total number of steps required for the simulation For example if you wish to extend a 10000 step simulation by a further 5000 steps use the directive timesteps 15000 in the CONTROL file and include the restart di
432. tively corrects the bond length 3 After the correction equation 3 16 has been applied to all bonds every bondlength is checked If the largest deviation found exceeds the desired tolerance the correction calculation is repeated 4 Steps 2 and 3 are repeated until all bondlengths satisfy the convergence criterion this iteration con stitutes stage 2 of the SHAKE algorithm The RATTLE procedures may be summarised as follows 1 RATTLE stage 1 a All atoms in the system are moved using the VV algorithm assuming an absence of rigid bonds constraint forces This is stage 1 of the RATTLE_VV1 algorithm b The deviation in each bondlength is used to calculate the corresponding constraint force equa tion 3 17 that retrospectively corrects the bond length c After the correction equation 3 17 has been applied to all bonds every bondlength is checked If the largest deviation found exceeds the desired tolerance the correction calculation is repeated d Steps b and c are repeated until all bondlengths satisfy the convergence criterion this iteration constitutes stage 2 of the RATTLE_VV1 algorithm 2 Forces calculated afresh 3 RATTLE stage 2 a All atom velocities are updated to a full step assuming an absence of rigid bonds This is stage 1 of the RATTLE _VV2 algorithm b The deviation of d v d in each bond is used to calculate the corresponding constraint force that retro
433. tma J P M van Gunsteren W F DiNola A and Haak J R 1984 J Chem Phys 81 3684 5 60 63 74 Hoover W G 1985 Phys Rev A31 1695 5 60 63 70 72 74 Quigley D and Probert M I J 2004 J Chem Phys 120 11432 5 60 74 Martyna G M Tuckerman M E Tobias D J and Klein M L 1996 Molec Phys 87 1117 5 60 74 88 94 Warner H R J 1972 ind Eng Chem Fundam 11 379 14 147 Bird R B e a 1977 Dynamics of Polymeric Liquids volume 1 and 2 Wiley New York 14 147 Grest G S and Kremer K 1986 Phys Rev A 33 3628 14 147 Ponder J W Wu C Ren P Pande V S Chodera J D Schnieders M J Haque I Mobley D L Lambrecht D S DiStasio Jr R A Head Gordon M Clark G N I Johnson M E and Head Gordon T 2010 J Phys Chem B 114 2549 2564 14 15 17 19 28 147 149 152 Vessal B 1994 J Non Cryst Solids 177 103 16 18 44 149 156 Smith W Greaves G N and Gillan M J 1995 J Chem Phys 103 3091 16 18 44 149 156 Allinger N L Yuh Y H and Lii J H 1998 J Am Chem Soc 111 8551 16 18 149 Sun H 1998 J Phys Chem B 102 38 7338 7364 17 18 19 149 Kumagai N Kawamura K and Yokokawa T 1994 Mol Simul 12 3 9 177 17 19 Smith W 1993 CCP5 Information Quarterly 39 14 18 21 24 Ryckaert J P and Bellemans A 1975 Chem Phys Lett 30 123 19 150 Schmidt M E
434. to the Verlet neighbour list nor the excluded atoms list It follows that atoms involved these interactions can interact via non bonded pair forces and ionic forces also Note that contributions from frozen pairs of atoms to these potentials are excluded The calculation of the Tersoff three body and four body terms is distributed over processors on the basis of the domain of the central atom in them DL_POLY_4 implements these potentials in the following routines TERSOFF_FORCES TERSOFF_GENERATE THREE_BODY_FORCES and FOUR_BODY_FORCES 7 1 7 Globally Summed Properties The final stage in the DD strategy is the global summation of different by terms of potentials contributions to energy virial and stress which must be obtained as a global sum of the contributing terms calculated on all nodes 182 STFC Section 7 1 The DD strategy does not require a global summation of the forces unlike the Replicated Data method used in DL POLY_ Classic which limits communication overheads and provides smooth parallelisation to large processor counts 7 1 8 The Parallel DD tailored SHAKE and RATTLE Algorithms The essentials of the DD tailored SHAKE and RATTLE algorithms see Section 3 2 are as follows 1 The bond constraints acting in the simulated system are allocated between the processors based on the location i e domain of the atoms involved 2 Each processor makes a list of the atoms bonded by constraints it must process Entries
435. tom labelled and rj the magnitude of the separation vector r r f The force on an atom j derived from this force is ES 2 190 with the force on atom 7 the negative of this The contribution to the atomic virial is we 2 191 which is simply the negative of the potential term The contribution to be added to the atomic stress tensor is ett 2 192 where a 8 are x y z components The atomic stress tensor is symmetric In DL_POLY_4 these forces are handled by the subroutine COUL_CP_FORCES 2 4 2 Force Shifted Coulomb Sum This form of the Coulomb sum has the advantage that it drastically reduces the range of electrostatic interactions without giving rise to a violent step in the potential energy at the cutoff Its main use is for preliminary preparation of systems and it is not recommended for realistic models The form of the simple truncated and shifted potential function is U rij 2 E 2 193 A4mege Tig Tout with qe the charge on an atom labelled reut the cutoff radius and r the magnitude of the separation vector Ke S lee Ty A further refinement of this approach is to truncate the 1 r potential at reut and add a linear term to the potential in order to make both the energy and the force zero at the cutoff This removes the heating effects that arise from the discontinuity in the forces at the cutoff in the simple truncated and shifted potential the formula above The physics of this potential
436. tor cell 3 real z component of a cell vector record iv cell 4 real x component of b cell vector cell 5 real y component of b cell vector cell 6 real z component of b cell vector record v cell 7 real x component of c cell vector cell 8 real y component of c cell vector cell 9 real z component of c cell vector This is followed by the nrsd displacements for the current timestep as each atom has the following data lines record a atmnam al0 atomic label from CONFIG iatm integer atom index from CONFIG ratm real atom displacement from its position att 0 record b XXX real x coordinate yyy real y coordinate ZZZ real z coordinate 6 2 5 The CFGMIN File The CFGMIN file only appears if the user has selected the programmed minimisation option directive minimise or optimise in the CONTROL file Its contents have the same format as the CONFIG file see Section 6 1 2 but contains only atomic position data and will never contain either velocity or force data i e parameter levcfg is always zero In addition three extra numbers appear on the end of the second line of the file 1 an integer indicating the number of minimisation cycles required to obtain the structure 2 the configuration energy of the minimised configuration expressed in DL_POLY_4 units Section 1 3 7 and 3 the configuration energy of the initial structure expressed in DL POLY_4 units Section 1 3 7 6 2 6 The OUTPUT File The job outpu
437. tude greater than r0 Alternatively adjust the value of r0 in the FIELD file Check that the FIELD file is correctly formatted Message 470 error n lt m in definition of n m potential The specification of a n m potential in the FIELD file implies that the exponent m is larger than exponent n Not all versions of DL_ POLY_4 are affected by this Action Locate the n m potential in the FIELD file and reverse the order of the exponents Resubmit the job Message 471 error rcut lt 2 rctbp maximum cutoff for three body potentials The cutoff for the pair interactions is smaller than twice that for the three body interactions This is a bookkeeping requirement for DL_POLY 4 Action Either use a smaller three body cutoff or a larger pair potential cutoff Message 472 error rcut lt 2 rcfbp maximum cutoff for four body potentials The cutoff for the pair interactions is smaller than twice that for the four body interactions This is a bookkeeping requirement for DL_POLY_4 Action Either use a smaller four body cutoff or a larger pair potential cutoff Message 474 error conjugate gradient mimimiser cycle limit exceeded The conjugate gradient minimiser exceeded the iteration limit 100 for the relaxed shell model 1000 for the configuration minimiser Action Decrease the respective convergence criterion Alternatively you may try to increase the limit by hand in CORE_SHELL_RELAX or in MINIMISE_RELAX respe
438. tzmann s constant and f the number of degrees of freedom in the system f 3N 3N Frozen 3N shells Neonsrants P 3 11 Here NFrozen indicates the number of frozen atoms in the system Nsheis number of core shell units and Neonstraints number of bond and PMF constraints Three degrees of freedom are subtracted for the centre of mass zero net momentum which we impose and p is zero for periodic or three for non periodic systems where it accounts for fixing angular momentum about origin which we impose In the case of rigid bodies see Section 3 6 the first part of equation 3 11 fl 3N 3N frozen 3 12 splits into fr NFP 3N FB aN BBE BOLT BN RBGOH gy ROO 3 13 or fra fEP 4 pRBltra y pRB rot 3 14 Here FP stands for a free particle i e a particle not participating in the constitution of a rigid body and RB for a rigid body In general a rigid body has 3 translational tra degrees of freedom corresponding to its centre of mass being allowed to move in the 3 general direction of space and 3 rotational rot corresponding to the RB being allowed to rotate around the 3 general axis in space It is not far removed to see that for a not fully frozen rigid body one must assign 0 translational degrees of freedom but depending on the frozenness of the RB one may assign 1 rotational degrees of freedom when all the frozen sites are in line i e rotation around one axis only or 3 when just on
439. ulation which implies usage during the equilibration period only The available algorithms are 1 Zero temperature molecular dynamics This is equivalent to a dynamical simulation at low tempera ture At each time step the molecules move in the direction of the computed forces and torques but are not allowed to acquire a velocity larger than that corresponding to a temperature of 10 Kelvin The subroutine that performs this procedure is ZERO_K_OPTIMISE 2 Conjugate Gradients Method CGM minimisation This is nominally a simple minimisation of the system configuration energy using the conjugate gradients method 69 The algorithm coded into DL_POLY _4 is an adaptation that allows for rotation and translation of rigid bodies Rigid constraint bonds however are treated as stiff harmonic springs a strategy which we find does allow the bonds to converge within the accuracy required by SHAKE The subroutine that performs this procedure is MINIMISE_RELAX which makes use of MINIMISE_MODULE 3 Programmed energy minimisation involving both MD and CGM This method combines the two as minimisation is invoked by user defined intervals of usually low temperature dynamics in a cycle of minimisation dynamics minimisation etc which is intended to help the structure relax from overstrained conditions see Section 6 1 1 When using the programmed minimisation DL POLY_4 writes and rewrites the file CFGMIN 6 2 5 which represents th
440. ulation may fail prematurely since a constraint algorithm failed to converge In such cases directives mxshak to increase and shake to decrease may be used to decrease the strain in the system and stablise the simulation numerics until equilibration is achieved 136 STFC Section 6 1 22 23 24 25 DL_POLY_4 s DD strategy assumes that the local per domain node or link cell density of various system entities i e atoms bonds angles etc does not vary much during a simulation and some limits for these are assumed empirically This may not the case in extremely non equilibrium simulations where the assumed limits are prone to be exceeded or in some specific systems where these do not hold from the start A way to tackle such circumstances and avoid simulations crash by controlled termination is to use the densvar f option In the SET_BOUNDS subroutine DL_POLY_4 makes assumptions at the beginning of the simulation and corrects the lengths of bonded like interaction lists arrays mxshl mxcons mxrgd mxteth mxbond mxangl mxdihd mxinv as well as the lengths of link cell mxlist and domain mxatms mxatdm lists arrays when the option is activated with f gt 0 Greater values of f will correspond to allocation bigger global arrays and larger memory consumption by DL POLY_4 during the simulation Note that this option may demand more memory than available on the computer architecture In such cases DL_POLY_4 will termina
441. ulation time number of array elements to follow total extended system energy i e the conserved quantity system temperature configurational energy short range potential energy electrostatic energy chemical bond energy valence angle and 3 body potential energy dihedral inversion and 4 body potential energy tethering energy enthalpy total energy PV rotational temperature total virial short range virial electrostatic virial bond virial valence angle and 3 body virial constraint bond virial tethering virial volume core shell temperature core shell potential energy core shell virial MD cell angle a MD cell angle 8 MD cell angle y PMF constraint virial pressure mean squared displacement of first atom types 176 2 mxatdm if msdtmp option is used STFC Section 6 2 amsd 2 real mean squared displacement of second atom types amsd ntpatm real mean squared displacement of last atom types the next 9 entries for the stress tensor stress 1 real xx component of stress tensor stress 2 real xy component of stress tensor stress 3 real xz component of stress tensor stress 4 real yx component of stress tensor bes real dE stress 9 real zz component of stress tensor the next 9 entries if a NPT or NoT simulation is undertaken cell 1 real x component of a cell vector cell 2 real y component of a cell vector cell 3 real z component of a cell vector cell 4 real x component of b cel
442. uld never happen although sometimes it could due to ill defined force field and or and or starting form a configuration which is too much away from equilibrium Action Try using the variable timestep option and or running in serial to determine if particles gain too much speed and leave domains See Message 128 Message 141 error duplicate metal potential specified During reading of metal potentials pairs of atom types in FIELD DL_POLY_4 has found a duplicate pair of atoms in the list Action Delete one of the duplicate entries and resubmit Message 145 error no two body like forces specified This error arises when there are no two body like interactions specified in FIELD and CONTROL Le none of the following interactions exists or if does it has been switched off any coulombic vdw metal tersoff In DL_POLY_4 expects that particles will be kept apparat stay separated and never go through each other due to one of the fore specified interactions Action Users must alone take measures to prevent such outcome Message 150 error unknown van der waals potential selected DL_POLY_4 checks when constructing the interpolation tables for the short ranged potentials that the potential function requested is one which is of a form known to the program If the requested potential form is unknown termination of the program results The most probable cause of this is the incorrect choice of the potential keyword in the FIEL
443. ule o constraints_module o kinds_f90 0 setup_module o constraints_tags o comms_module o config_module o constraints_module o kinds_f90 0 setup_module o core_shell_forces o comms_module o config_module o core_shell_module o kinds_f90 0 setup_module o core_shell_kinetic o comms_module o config_module o core_shell_module o kinds_f90 0 core_shell_module o kinds_f90 0 setup_module o core_shell_on_top o comms_module o config_module o core_shell_module o setup_module o core_shell_quench o comms_module o config_module o core_shell_module o kinds_f90 0 setup_module o core_shell_relax o comms_module o config_module o core_shell_module o kinds_f90 0 kinetic_module o parse_module o setup_module o coul_cp_forces o config_module o kinds_f90 o setup_module o coul_dddp_forces o config_module o kinds_f90 o setup_module o coul_fscp_forces o comms_module o config_module o kinds_f90 o setup_module o coul_rfp_forces o comms_module o config_module o kinds_f90 o setup_module o defects1_module o kinds_f90 o setup_module o defectsi_write o comms_module o config_module o defects1_module o io_module o kinds_f90 0 parse_module o setup_module o site_module o defects_link_cells o domains_module o kinds_f90 o setup_module o defects_module o kinds_f90 o setup_module o defects_reference_export o comms_module o domains_module o kinds_f90 0 setup_module o 214 STFC Appendix C defects_reference_read o comms_module o config_module
444. ume some initial estimates of long ranged corrections the energy and pressure if appropriate some concise information on topology and degrees of freedom break down list This part of the file is written from the subroutines SCAN_CONFIG CHECK_CONFIG SYSTEM_INIT REPORT_TOPOLOGY and SET_TEMPERATURE 6 2 6 5 Summary of the Initial Configuration This part of the file is written from the main subroutine DL_POLY_ It states the initial configuration of a maximum of 20 atoms in the system The configuration information given is based on the value of levcfg in the CONFIG file If levcfg is 0 or 1 positions and velocities of the 20 atoms are listed If levcfg is 2 forces are also written out 6 2 6 6 Simulation Progress This part of the file is written by the DL_POLY_4 root segment DL_POLY_ The header line is printed at the top of each page as step eng_tot temp_tot eng_cfg eng_src eng_cou eng_bnd eng_ang eng_dih eng_tet time ps eng_pv temp_rot vir_cfg vir_src vir_cou vir_bnd vir_ang vir_con vir_tet cpu s volume temp_shl eng_shl vir_shl alpha beta gamma vir_pmf press The labels refer to line 1 step MD step number eng tot total internal energy of the system temp_tot system temperature in Kelvin eng cfg configurational energy of the system eng src configurational energy due to short range potential contributions 170 STFC Section 6 2 eng_cou configurational energy due to electrostatic potential eng_bnd configurati
445. unctions max dimension of the transfer buffer for export functions max dimension of the transfer buffer for shared units functions max dimension of the principle transfer buffer the machine representation of 0 at working precision the machine representation of 0 5 at working precision the machine representation of 0 5 at working precision the system energy unit 192 Chapter 8 Examples Scope of Chapter This chapter describes the standard test cases for DL POLY_4 the input and output files for which are in the data sub directory 193 STFC Section 8 1 8 1 Test Cases Because of the size of the data files for the DL_POLY 4 standard test cases they are not shipped in the standard download of the DL_POLY_4 source Instead users are requested to download them from the CCP5 FTP server as follows FTP site ftp dl ac uk Username anonymous Password your email address Directory ccp5 DL_POLY DL_POLY_4 0 DATA Files test_X tar gz where _X stands for the test case number Remember to use the BINARY data option when transferring these files Unpack the files in the data subdirectory using firstly gunzip to uncompress them and then tar xf to create the TEST_X directory These are provided so that you may check that your version of DL_POLY_4 is working correctly All the jobs are of a size suitable to test the code in parallel execution They not not be suitable for a single pro
446. une 440 EX EX BINROOT BINROOT TYPE 229 STFC Appendix C MAKE LD bgsys drivers ppcfloor comm bin mpixlf2003_r o LDFLAGS 03 qhot qarch 450d qtune 450 qmaxmem 128000 FC bgsys drivers ppcfloor comm bin mpix1lf2003_r c FCFLAGS 03 qhot qarch 450d qtune 450 qmaxmem 128000 EX EX BINROOT BINROOT TYPE archer MAKE LD ftn o A LDFLAGS 03 FC ftn c FCFLAGS 03 EX EX BINROOT BINROOT TYPE archer pgi debug MAKE LD ftn o LDFLAGS 00 W Wall pedantic std f2003 g fbounds check fbacktrace finit real nan finit integer 999999 FC ftn c FCFLAGS 00 W Wall pedantic std f2003 g fbounds check fbacktrace finit real nan finit integer 999999 EX EX BINROOT BINROOT TYPE archer gnu MAKE LD ftn o LDFLAGS 03 Wall pedantic g FC ftn c FCFLAGS 03 Wall pedantic g EX EX BINROOT BINROOT TYPE archer gnu debug MAKE LD ftn o LDFLAGS 03 Wall Wextra pedantic g fbounds check fbacktrace finit integer 9999 finit real nan std f2003 ffpe trap invalid zero overflow fdump core FC ftn c FCFLAGS 03 Wall Wextra pedantic g fbounds check fbacktrace finit integer 9999 finit real nan std f2003 ffpe trap invalid zero overflow fdump core EX EX BINROOT BINROOT TYPE archer cray MAKE LD ftn o LDFLAGS 03 en
447. upta metal Potentials 195 8 1 11 Test Case 21 and 22 Cu with EAM metal Potentials 195 8 1 12 Test Case 23 and 24 Al with Sutton Chen metal Potentials 195 8 1 13 Test Case 25 and 26 Al with EAM metal Potentials 196 8 1 14 Test Case 27 and 28 NiAl alloy with EAM metal Potentials 196 8 1 15 Test Case 29 and 30 Fe with Finnis Sincair metal Potentials 196 8 1 16 Test Case 31 and 32 Ni with EAM metal Potentials 196 STFC Contents 8 1 17 Test Case 33 and 34 SPC IceVII water with constraints 196 8 1 18 Test Case 35 and 36 NaCl molecules in SPC water represented as CBs RBs 196 8 1 19 Test Case 37 and 38 TIP4P water RBs with a massless charged site 196 8 1 20 Test Case 39 and 40 Ionic liquid dimethylimidazolium chloride 196 8 1 21 Test Case 41 and 42 Calcite nano particles in TIP3P water 196 8 1 22 Test Case 43 and 44 Iron Carbon alloy with EEAM 197 8 1 23 Test Case 45 and 46 Iron Cromium alloy with 2BEAM 197 8 1 24 Test Case 47 and 48 Hexane and methanol melts full atomistic and coarse grained SUMA LIOHS iros a Boece E ers Be bat ow EE a 197 8 2 Benchmark Gases lt s sepu pads la we ew a ee a a ee be we Re a 197 Appendices 197 A DL_POLY 4 Periodic Boundary Conditions 198 B DL_POLY_4 Macros 201 C DL_POLY 4 Makefiles
448. use is a badly generated initial configuration Action Some help may be gained from increasing the cycle limit by using the directive mxshak in the CONTROL file You may also consider reducing the tolerance of the SHAKE iteration using the directive shake in the CONTROL file However it is probably better to take a good look at the starting conditions Message 71 error too many metal potentials specified This should never happen Action Report to authors Message 72 error too many tersoff potentials specified This should never happen 256 STFC Appendix D Action Report to authors Message 73 error too many inversion potentials specified This should never happen Action Report to authors Message 74 error unidentified atom in tersoff potential list This shows that DL_POLY_4 has encountered and erroneous entry for Tersoff potentials in FIELD Action Correct FIELD and resubmit Message 76 error duplicate tersoff potential specified This shows that DL _POLY_4 has encountered and erroneous entry for Tersoff potentials in FIELD Action Correct FIELD and resubmit Message 77 error too many inversion angles per domain DL_POLY_4 limits the number of inversion units in the system to be simulated actually the number to be processed by each node and checks for the violation of this Termination will result if the condition is violated Action Use densvar option in CONTROL to inc
449. v f90 nst_li_lfv f90 nst_b1_1fv f90 nst_h1_1fv f90 nst_m1_1fv f90 w_at_start_lfv f90 w_integrate_lfv f90 w_md_1fv f90 Examine targets manually all echo echo You MUST specify or choose a permissive target platform echo echo The available permissive targets are displayed below echo echo win win debug echo echo Please examine this Makefile s targets for details echo If no target suits your system then create your own echo using the advice in generic target template provided echo in this Makefile under the entry uknown_platform echo Fetch MPI SERIAL subroutines FILES_SERIAL MAKE links_serial links_serial for file in FILES_SERIAL do echo linking to file rm f file ln s SERIAL file file done 242 STFC Appendix C Fetch the Velocity Verlet subroutines FILES_VV MAKE links_vv links_vv for file in FILES_VV do echo linking to file rm f file ln s VV file file A done Fetch the LeapFrog Verlet subroutines FILES_LFV MAKE links_lfv links_lfv for file in FILES_LFV do echo linking to file rm f file ln s LFV file file done Clean up the source directory clean rm f OBJ_MOD OBJ_ALL FILES_VV FILES_LFV FILES_SERIAL mod Generic target template uknown_platform MAKE LD path to FORTRAN9O Linker loaDer LDF
450. v1 6 Truncated Vessal 38 bv2 7 Harmonic cosine hes 8 Cosine cos 9 MMB stretch bend 39 msb 10 Compass stretch stretch 40 sts 11 Compass stretch bend 40 stb 18 STFC Section 2 2 12 Compass all terms 40 cmp 13 AMOEBA force field angle 36 amo 14 KKY 41 kky 15 Tabulated potential tab The potential is defined numerically in TABANG see Section 4 3 and Section 6 1 8 In DL POLY_4 angular restraints are handled by the routine ANGLES_FORCES 2 2 5 Dihedral Angle Potentials Figure 2 3 The dihedral angle and associated vectors The dihedral angle potentials describe the interaction arising from torsional forces in molecules They are sometimes referred to as torsion potentials They require the specification of four atomic positions The potential functions available in DL_POLY_4 are as follows 1 Cosine potential cos U dijkn A 1 cos mdijzn 9 Harmonic harm k Uae 5 dijkn 90 Harmonic cosine hcos cos Pijen cos dp Triple cosine cos3 U d 5 41 1 cos Az 1 cos 2 As 1 cos 39 Ryckaert Bellemans 43 with fixed constants a f ryck U A a b cos c cos p d cos e cos f cos Fluorinated Ryckaert Bellemans 44 with fixed constants a h rbf U A a b cos c cos d cos e cos f cos g exp h d 7
451. ver this help comes at a price as larger batches and buffers also requires more memory So at smaller processor counts the job will abort at the point of trying to use some of the allocated arrays responsible for these More information about DL_POLY 4 parallel I O can be found in the following references 79 80 81 5 2 4 Restarting The best approach to running DL_POLY_4 is to define from the outset precisely the simulation you wish to perform and create the input files specific to this requirement The program will then perform the requested simulation but may terminate prematurely through error inadequate time allocation or computer failure Errors in input data are your responsibility but DL POLY_4 will usually give diagnostic messages to help you sort out the trouble Running out of job time is common and provided you have correctly specified the job time variables using the close time and job time directives see Section 6 1 1 in the CONTROL file DL_POLY_4 will stop in a controlled manner allowing you to restart the job as if it had not been interrupted To restart a simulation after normal termination you will again require the original CONTROL file augment it to include the restart directive and or extend the length and duration of the new targeted MD run the FIELD and TABLE and or TABEAM file and a CONFIG file which is the exact copy of the REVCON file created by the previous job You will also require a new file REVOLD Sec
452. weg vis Wed The X Tha gt 2 74 We also define the quantity y u as y u 24u 4Bu 2 75 The forces on the individual atoms due to the calcite potential are then given by fa y u Wea de Tia X Tab UD yu Wed La TeX rs uw eq y u Wed 2 76 fy E PEA where Wed Weq and Weg Weq Wea The virial contribution Pabcalu is given by Wabea u 2Au 4Bu 2 77 and the stress tensor contribution acid q u by u y u Orbea Ut 3 WY why 2 78 cd In DL_POLY 4 the calcite forces are handled by the routine INVERSIONS_FORCES which is a convenient intramolecular four body force routine However it is manifestly not an inversion potential as such 25 STFC Section 2 3 2 2 9 Tethering Forces DL_POLY 4 also allows atomic sites to be tethered to a fixed point in space r taken as their position at the beginning of the simulation t 0 This is also known as position restraining The specification which comes as part of the molecular description requires a tether potential type and the associated interaction parameters Note firstly that application of tethering potentials means that the momentum will no longer be a conserved quantity of the simulation Secondly in constant pressure simulations where the MD cell changes size or shape the tethers reference positions are scaled with the cell vectors The tethering potential functions available in DL_POLY_4 are as
453. where go l kn Tea 8 57 is the target thermostat energy depending on the external temperature and the system total degrees of freedom f equation 3 11 and 77 a specified time constant for temperature fluctuations normally in the range 0 5 2 ps The VV implementation of the Berendsen algorithm is straight forward A conventional VV1 and VV2 thermally unconstrained steps are carried out At the end of VV2 velocities are scaled by a factor of x in the following manner 1 VVI 1 At f t u t 4 At v t ae 1 r t At r t At u t At 3 58 2 RATTLE_VV1 3 FF f t At f t 3 59 4 VV2 At f t A 1 t f t At v t At v t 5 At ES PA 3 60 5 RATTLE _VV2 6 Thermostat At o 1 2 t At 1 1 eras ras Ut At vt At x 3 61 The LFV implementation of the Berendsen algorithm is iterative as an initial estimate of x t at full step is calculated using an unconstrained estimate of the velocity at full step v t 1 FF f t f t At 3 62 2 LFV The iterative part is as follows 1 1 u t 5At lolt At At HELA HOE RCE At 3 63 3 SHAKE 69 STFC Section 3 4 4 Full step velocity 1 1 Ec At u t 7 0 3 64 5 Thermostat x t lt 1 ae a yy 3 65 Several iterations are required to obtain self consistency In DLLPOLY_4 the number of iterations is set to 3 4 if bond constraints are present Note that the MD cell s centre of m
454. xexcl variable max number of excluded interactions per atom mxspl variable SPME FFT B spline order mxspl1 variable SPME FFT B spline possible extension when pad gt 0 kmaxa variable SPME FFT amended array dimension a direction kmaxb variable SPME FFT amended array dimension b direction kmaxc variable SPME FFT amended array dimension c direction kmaxal variable SPME FFT original array dimension a direction kmaxb1 variable SPME FFT original array dimension b direction kmaxc1 variable SPME FFT original array dimension c direction mxtshl variable max number of specified core shell unit types in system mxshl variable max number of core shell units per node 190 STFC Section 7 2 mxfshl mxtcon mxcons mxfcon mx1shp mxproc mxtpmf 1 2 mxpmf mxfpmf mxtrgd mxrgd mxlrgd mxfrgd mxtteth mxteth mxftet mxpteth mxtbnd mxbond mxfbnd mxpbnd mxgbnd mxtang mxangl mxfang mxpang mxgang mxtdih mxdihd mxfdih mxpdih mxgdih mxtinv mxinv mxfinv mxpinv mxginv mxrdf mxgrdf mxgele mxvdw mxpvdw mxgvdw mxmet mxmed mxmds mxpmet mxgmet mxter mxpter mxgter variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable variable vari
455. y on geometric considerations it is not practical to arrange for a strict load balancing of the DD SHAKE and DD RATTLE algorithms For many systems however this deficiency has little practical impact on performance 7 1 9 The Parallel Rigid Body Implementation The essentials of the DD tailored RB algorithms see Section 3 6 are as follows 1 Every processor works out a list of all local and halo atoms that are qualified as free zero entry or as members of a RB unit entry 2 The rigid body units in the simulated system are allocated between the processors based on the location i e domain of the atoms involved 3 Each processor makes a list of the RB and their constituting atoms that are fully or partially owned by the processors domain 183 STFC Section 7 2 4 Each processor passes a copy of the array to the neighbouring processors which manage the domains in contact with its own The receiving processor compares the incoming list with its own and keeps a record of the shared RBs and RBs constituent atoms and the processors which share them Note that a RB can be shared between up to eight domains 5 The dynamics of each RB is calculated in full on each domain but domains only update r v f of RB atoms which they own Note that a site atom belongs to one and only one domain at a time no sharing 6 Strict bookkeeping is necessary to avoid multiple counting of kinetic properties r v v updates are necess
456. ype in the four body dihedrals inversions potential definition in the FIELD file and correct Make sure this atom type is specified by an atoms directive earlier in the file 259 STFC Appendix D Message 92 error specified metal potentials have different types The specified metal interactions in the FIELD file are referencing more than one generic type of metal potentials Only one such type is allowed in the system Action Locate the errant metal type in the metal potential definition in the FIELD file and correct Make sure only one metal type is specified for all relevan atom interactions in the file Message 93 error PMFs mixing with rigid bodies not allowed Action Correct FIELD and resubmit Message 95 error error rcut gt minimum of all half cell widths In order for the minimum image convention to work correctly within DL POLY 4 it is necessary to ensure that the major cutoff applied to the pair interactions does not exceed half the perpendicular width of the simulation cell The perpendicular width is the shortest distance between opposing cell faces Termination results if this is detected In NVE and NVT simulations this can only happen at the start of a simulation but in NPT and NaT it may occur at any time Action Supply a cutoff that is less than half the cell width If running constant pressure calculations use a cutoff that will accommodate the fluctuations in the simulation cell Study the
457. ypes a and b represented by the function Then r g r and n r are given in tabular form Output is given from 2 entries before the first non zero entry in the g r histogram n r is the average number of atoms of type b within a sphere of radius r around an atom of type a Note that a readable version of these data is provided by the RDFDAT file below 6 2 6 10 Z density Profile If both calculation and printing of Z density profiles have been requested by selecting directives zden and print zden in the CONTROL file Z density profiles are printed out as the last part of the OUTPUT file This is written by the subroutine Z_DENSITY_COMPUTE First the number of time steps used for the collection of the histograms is stated Then each function is given in turn For each function a header line states the atom type represented by the function Then z p z and n z are given in tabular form Output is given from Z L 2 L 2 where L is the length of the MD cell in the Z direction and p z is the mean number density n z is the running integral from 2 to z of xy cell area x p s ds Note that a readable version of these data is provided by the ZDNDAT file below 6 2 6 11 Velocity Autocorrelation Functions If both calculation and printing of velocity autocorrelation functions have been requested by selecting directives vaf and print vaf in the CONTROL file the velocity autocorrelation function for the system eit
458. z components The atomic stress tensor is symmetric In DL_POLY_4 the reaction field is handled by the subroutine COUL_RFP_FORCES 2 4 5 Smoothed Particle Mesh Ewald The Ewald sum 22 is the best technique for calculating electrostatic interactions in a periodic or pseudo periodic system The basic model for a neutral periodic system is a system of charged point ions mutually interacting via the Coulomb potential The Ewald method makes two amendments to this simple model Firstly each ion is effectively neutralised at long ranged by the superposition of a spherical Gaussian cloud of opposite charge centred on the ion The combined assembly of point ions and Gaussian charges becomes the Real Space part of the Ewald sum which is now short ranged and treatable by the methods described above Section 2 The second modification is to superimpose a second set of Gaussian charges this time with the same charges as the original point ions and again centred on the point ions so nullifying the effect of the first set of Gaussians The potential due to these Gaussians is obtained from Poisson s equation and is solved as a Fourier series in Reciprocal Space The complete Ewald sum requires an additional correction known as the self energy correction which arises from a Gaussian acting on its own site and is constant Ewald s method therefore replaces a potentially infinite sum in real space by two finite sums one in real space and one in recipro
459. ze The PDF histograms within a DAT file are separated by uncommented empty lines which makes it possible to directly import and plot all the data as separate lines in Xm Grace 2D plotter For clarity the data of each histogram are preceded by a commented out line specifying the type index and number of instances of the analysed interaction unit the latter being counted over the entire system In all DAT files the first column bears the bin centered abscissa values distance or angle the second column is the distribution histogram normalized to unity i e its integral equals 1 whereas the third column if any contains the PDF data corrected for the volumetric entropic degeneracy of the grid points Thus it is the data of the last column found that are used for calculating PMF In PDF The OUTPUT file will contain copies of the first and second columns of all collected PDF s but normalised so that the figures in the second column sum up to 1 which can be checked by examining the third column as it bears the running sum of a PDF histogram In addition to the PDF s DL_POLY_4 also calculates the respective PMF s and pairwise force dependencies virial for bonds which are stored in the PMF and upon resampling onto a bin edge grid TAB files It is important to note that unlike the PMF files containing the bare In PDF data converted to the requested energy units on the same grid as the PDF histograms the force field data
460. zmann e internal for DL _POLY internal units 10 Joules per mol If no units keyword is entered DL_POLY internal units are assumed for both input and output The units directive only affects the input and output interfaces all internal calculations are handled using DL_POLY units System input and output energies are read in units per MD cell Note that all energy bearing potential parameters are read in terms of the specified energy units If such a parameter depends on an angle then the dependence is read in terms of radians although the following angle in the parameter sequence is read in terms of degrees 143 STFC Section 6 1 Molecular details It is important for the user to understand that there is an organisational correspondence between the FIELD file and the CONFIG file described above It is required that the order of specification of molecular types and their atomic constituents in the FIELD file follows the order of indices in which they appear in the CONFIG file Failure to adhere to this common sequence will be detected by DL_POLY_4 and result in premature termination of the job It is therefore essential to work from the CONFIG file when constructing the FIELD file It is not as difficult as it sounds The entry of the molecular details begins with the mandatory directive molecules n where n is an integer specifying the number of different types of molecule appearing in the FIELD file Once this directive has been

Download Pdf Manuals

Related Search

Related Contents

クリップクランプツールセット（CCP2）取扱説明書  MR-100 FMモニタ受信機 [PDF：183KB]  Grandstream Networks GXP1200 2lines Wired handset Black  SP6000 Software Installation Manual  Bruger manual - UniRo 5000SW  USER MANUAL - Leo Bodnar  ポーチテラス カフェスタイル ポーチテラス カフェスタイル 腰壁タイプ 共 通  Guardian A6-6000 IP User Manual  iView X SDK Manual    

Copyright © All rights reserved. Failed to retrieve file