← Back to branch summary

~ubuntu-branches/debian/sid/lammps/sid

« back to all changes in this revision

Viewing changes to tools/moltemplate/examples/all_atom_examples/force_field_AMBER/hexadecane/README.TXT

  • Committer: Package Import Robot
  • Author(s): Anton Gladky
  • Date: 2015-04-29 23:44:49 UTC
  • mfrom: (5.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20150429234449-mbhy9utku6hp6oq8
Tags: 0~20150313.gitfa668e1-1
Upload into unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/moltemplate/examples/all_atom_examples/force_field_AMBER/hexadecane/README.TXT
 
1
This example is a simple simulation of 288 hexadecane molecules in a box at
 
2
room temperature and atmospheric pressure.  Please read the WARNING.TXT file.
 
3
 
 
4
-------- REQUIREMENTS: ---------
 
5
This example requires building LAMMPS with the "USER-MISC" package.
 
6
(because it uses dihedral_style fourier)
 
7
To do this, type "make yes-user-misc" before compiling LAMMPS.
 
8
http://lammps.sandia.gov/doc/Section_start.html#start_3
 
9
 
 
10
More detailed instructions on how to build LAMMPS input files and 
 
11
run a short simulation are provided in other README files:
 
12
 
 
13
step 1) to setup the LAMMPS input files, run this file:
 
14
README_setup.sh
 
15
 
 
16
      (Currently there is a bug which makes this step slow.
 
17
       I'll fix it later -Andrew 2013-10-15.)
 
18
 
 
19
step 2) to run LAMMPS, follow the instructions in this file:
 
20
README_run.sh
 
21
 
 
22
------------ NOTE: There are two versions of this example. ----------------
 
23
 
 
24
Both examples use the same force-field parameters.
 
25
 
 
26
1)
 
27
In this version, the force-field parameters are loaded from the "gaff.lt" file
 
28
(located in the "common" subdirectory).
 
29
This frees the user from the drudgery of manually specifying all of these
 
30
force-field details for every molecule.  (However, the user must be careful
 
31
to choose @atom-type names which match AMBER GAFF conventions,
 
32
such as the "c3" and "h1" atoms, in this example.)
 
33
 
 
34
2)
 
35
Alternately, there is another "hexadecane" example in the "all_atom_examples"
 
36
directory.  In that example, force-field parameters are loaded from a file
 
37
named "alkanes.lt" (instead of "gaff.lt").  The "alkanes.lt" file contains 
 
38
only the excerpts from "gaff.lt" which are relevant to the hydrocarbon
 
39
molcules used in that example.  ("gaff.lt" contains parameters for most
 
40
small organic molecules, not just hydrocarbons.)
 
41
In this way, by editing "alkanes.lt", the user can manually control all of the
 
42
force-field details in the simulation.  (Without feeling as though they are 
 
43
relying on some kind of mysterious "black box" to do it for them.)
 
44