git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@16053 f3b2605a-c512-4ea7-a41b...
[lammps.git] / doc / src / newton.txt
bloba3e7f4fa91eec43b623a57f58be483f35ba982e1
1 "LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
3 :link(lws,http://lammps.sandia.gov)
4 :link(ld,Manual.html)
5 :link(lc,Section_commands.html#comm)
7 :line
9 newton command :h3
11 [Syntax:]
13 newton flag
14 newton flag1 flag2 :pre
16 flag = {on} or {off} for both pairwise and bonded interactions
17 flag1 = {on} or {off} for pairwise interactions
18 flag2 = {on} or {off} for bonded interactions :ul
20 [Examples:]
22 newton off
23 newton on off :pre
25 [Description:]
27 This command turns Newton's 3rd law {on} or {off} for pairwise and
28 bonded interactions.  For most problems, setting Newton's 3rd law to
29 {on} means a modest savings in computation at the cost of two times
30 more communication.  Whether this is faster depends on problem size,
31 force cutoff lengths, a machine's compute/communication ratio, and how
32 many processors are being used.
34 Setting the pairwise newton flag to {off} means that if two
35 interacting atoms are on different processors, both processors compute
36 their interaction and the resulting force information is not
37 communicated.  Similarly, for bonded interactions, newton {off} means
38 that if a bond, angle, dihedral, or improper interaction contains
39 atoms on 2 or more processors, the interaction is computed by each
40 processor.
42 LAMMPS should produce the same answers for any newton flag settings,
43 except for round-off issues.
45 With "run_style"_run_style.html {respa} and only bonded interactions
46 (bond, angle, etc) computed in the innermost timestep, it may be
47 faster to turn newton {off} for bonded interactions, to avoid extra
48 communication in the innermost loop.
50 [Restrictions:]
52 The newton bond setting cannot be changed after the simulation box is
53 defined by a "read_data"_read_data.html or
54 "create_box"_create_box.html command.
56 [Related commands:]
58 "run_style"_run_style.html respa
60 [Default:]
62 newton on :pre