git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@16053 f3b2605a-c512-4ea7-a41b...
[lammps.git] / doc / src / compute_modify.txt
blobacf14526a71f64ca59755ac7060c9508fb613250
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 compute_modify command :h3
11 [Syntax:]
13 compute_modify compute-ID keyword value ... :pre
15 compute-ID = ID of the compute to modify :ulb,l
16 one or more keyword/value pairs may be listed :l
17 keyword = {extra} or {dynamic} :l
18   {extra} value = N
19     N = # of extra degrees of freedom to subtract
20   {dynamic} value = {yes} or {no}
21     yes/no = do or do not recompute the number of atoms contributing to the temperature :pre
22 :ule
24 [Examples:]
26 compute_modify myTemp extra 0
27 compute_modify newtemp dynamic yes extra 600 :pre
29 [Description:]
31 Modify one or more parameters of a previously defined compute.  Not
32 all compute styles support all parameters.
34 The {extra} keyword refers to how many degrees-of-freedom are
35 subtracted (typically from 3N) as a normalizing factor in a
36 temperature computation.  Only computes that compute a temperature use
37 this option.  The default is 2 or 3 for "2d or 3d
38 systems"_dimension.html which is a correction factor for an ensemble
39 of velocities with zero total linear momentum. For compute
40 temp/partial, if one or more velocity components are excluded, the
41 value used for {extra} is scaled accordingly. You can use a negative
42 number for the {extra} parameter if you need to add
43 degrees-of-freedom.  See the "compute
44 temp/asphere"_compute_temp_asphere.html command for an example.
46 The {dynamic} keyword determines whether the number of atoms N in the
47 compute group is re-computed each time a temperature is computed.
48 Only compute styles that calculate a temperature use this option.  By
49 default, N is assumed to be constant.  If you are adding atoms to the
50 system (see the "fix pour"_fix_pour.html or "fix
51 deposit"_fix_deposit.html commands) or expect atoms to be lost
52 (e.g. due to evaporation), then this option should be used to insure
53 the temperature is correctly normalized.
55 [Restrictions:] none
57 [Related commands:]
59 "compute"_compute.html
61 [Default:]
63 The option defaults are extra = 2 or 3 for 2d or 3d systems and
64 dynamic = no.