git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@16053 f3b2605a-c512-4ea7-a41b...
[lammps.git] / doc / src / fix_drag.txt
blob235d3d38b5f97d91dae8a4fa3122e77486fbf7cd
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 fix drag command :h3
11 [Syntax:]
13 fix ID group-ID drag x y z fmag delta :pre
15 ID, group-ID are documented in "fix"_fix.html command
16 drag = style name of this fix command
17 x,y,z = coord to drag atoms towards
18 fmag = magnitude of force to apply to each atom (force units)
19 delta = cutoff distance inside of which force \
20         is not applied (distance units) :ul
22 [Examples:]
24 fix center small-molecule drag 0.0 10.0 0.0 5.0 2.0 :pre
26 [Description:]
28 Apply a force to each atom in a group to drag it towards the point
29 (x,y,z).  The magnitude of the force is specified by fmag.  If an atom
30 is closer than a distance delta to the point, then the force is not
31 applied.
33 Any of the x,y,z values can be specified as NULL which means do not
34 include that dimension in the distance calculation or force
35 application.
37 This command can be used to steer one or more atoms to a new location
38 in the simulation.
40 [Restart, fix_modify, output, run start/stop, minimize info:]
42 No information about this fix is written to "binary restart
43 files"_restart.html.
45 The "fix_modify"_fix_modify.html {respa} option is supported by this
46 fix. This allows to set at which level of the "r-RESPA"_run_style.html
47 integrator the fix is adding its forces. Default is the outermost level.
49 This fix computes a global 3-vector of forces, which can be accessed
50 by various "output commands"_Section_howto.html#howto_15.  This is the
51 total force on the group of atoms by the drag force.  The vector
52 values calculated by this fix are "extensive".
54 No parameter of this fix can be used with the {start/stop} keywords of
55 the "run"_run.html command.  This fix is not invoked during "energy
56 minimization"_minimize.html.
58 [Restrictions:] none
60 [Related commands:]
62 "fix spring"_fix_spring.html, "fix spring/self"_fix_spring_self.html,
63 "fix spring/rg"_fix_spring_rg.html, "fix smd"_fix_smd.html
65 [Default:] none