git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@15202 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
@ -543,15 +543,15 @@ KOKKOS, o = USER-OMP, t = OPT.
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`pair/local <compute_pair_local>` | :doc:`pe <compute_pe>` | :doc:`pe/atom <compute_pe_atom>` | :doc:`plasticity/atom <compute_plasticity_atom>` | :doc:`pressure <compute_pressure>` | :doc:`property/atom <compute_property_atom>` |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`property/local <compute_property_local>` | :doc:`property/chunk <compute_property_chunk>` | :doc:`rdf <compute_rdf>` | :doc:`reduce <compute_reduce>` | :doc:`reduce/region <compute_reduce>` | :doc:`slice <compute_slice>` |
|
||||
| :doc:`property/local <compute_property_local>` | :doc:`property/chunk <compute_property_chunk>` | :doc:`rdf <compute_rdf>` | :doc:`reduce <compute_reduce>` | :doc:`reduce/region <compute_reduce>` | :doc:`rigid/local <compute_rigid_local>` |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`sna/atom <compute_sna_atom>` | :doc:`snad/atom <compute_sna_atom>` | :doc:`snav/atom <compute_sna_atom>` | :doc:`stress/atom <compute_stress_atom>` | :doc:`temp (k) <compute_temp>` | :doc:`temp/asphere <compute_temp_asphere>` |
|
||||
| :doc:`slice <compute_slice>` | :doc:`sna/atom <compute_sna_atom>` | :doc:`snad/atom <compute_sna_atom>` | :doc:`snav/atom <compute_sna_atom>` | :doc:`stress/atom <compute_stress_atom>` | :doc:`temp (k) <compute_temp>` |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`temp/body <compute_temp_body>` | :doc:`temp/chunk <compute_temp_chunk>` | :doc:`temp/com <compute_temp_com>` | :doc:`temp/deform <compute_temp_deform>` | :doc:`temp/partial <compute_temp_partial>` | :doc:`temp/profile <compute_temp_profile>` |
|
||||
| :doc:`temp/asphere <compute_temp_asphere>` | :doc:`temp/body <compute_temp_body>` | :doc:`temp/chunk <compute_temp_chunk>` | :doc:`temp/com <compute_temp_com>` | :doc:`temp/deform <compute_temp_deform>` | :doc:`temp/partial <compute_temp_partial>` |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`temp/ramp <compute_temp_ramp>` | :doc:`temp/region <compute_temp_region>` | :doc:`temp/sphere <compute_temp_sphere>` | :doc:`ti <compute_ti>` | :doc:`torque/chunk <compute_torque_chunk>` | :doc:`vacf <compute_vacf>` |
|
||||
| :doc:`temp/profile <compute_temp_profile>` | :doc:`temp/ramp <compute_temp_ramp>` | :doc:`temp/region <compute_temp_region>` | :doc:`temp/sphere <compute_temp_sphere>` | :doc:`ti <compute_ti>` | :doc:`torque/chunk <compute_torque_chunk>` |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
| :doc:`vcm/chunk <compute_vcm_chunk>` | :doc:`voronoi/atom <compute_voronoi_atom>` | | | | |
|
||||
| :doc:`vacf <compute_vacf>` | :doc:`vcm/chunk <compute_vcm_chunk>` | :doc:`voronoi/atom <compute_voronoi_atom>` | | | |
|
||||
+------------------------------------------------+------------------------------------------------+--------------------------------------------------+--------------------------------------------------+----------------------------------------------------+----------------------------------------------------------+
|
||||
|
||||
These are additional compute styles in USER packages, which can be
|
||||
|
||||
@ -29,10 +29,10 @@ long-range Coulombics. It has the following general features:
|
||||
NVIDIA support as well as more general OpenCL support, so that the
|
||||
same functionality can eventually be supported on a variety of GPU
|
||||
hardware.
|
||||
Here is a quick overview of how to use the GPU package:
|
||||
Here is a quick overview of how to enable and use the GPU package:
|
||||
|
||||
* build the library in lib/gpu for your GPU hardware wity desired precision
|
||||
* include the GPU package and build LAMMPS
|
||||
* build the library in lib/gpu for your GPU hardware with the desired precision settings
|
||||
* install the GPU package and build LAMMPS as usual
|
||||
* use the mpirun command to set the number of MPI tasks/node which determines the number of MPI tasks/GPU
|
||||
* specify the # of GPUs per node
|
||||
* use GPU styles in your input script
|
||||
|
||||
@ -222,6 +222,7 @@ section of :ref:`this page <cmd_5>`.
|
||||
* :doc:`rdf <compute_rdf>` - radial distribution function g(r) histogram of group of atoms
|
||||
* :doc:`reduce <compute_reduce>` - combine per-atom quantities into a single global value
|
||||
* :doc:`reduce/region <compute_reduce>` - same as compute reduce, within a region
|
||||
* :doc:`rigid/local <compute_rigid_local>` - extract rigid body attributes
|
||||
* :doc:`slice <compute_slice>` - extract values from global vector or array
|
||||
* :doc:`sna/atom <compute_sna_atom>` - calculate bispectrum coefficients for each atom
|
||||
* :doc:`snad/atom <compute_sna_atom>` - derivative of bispectrum coefficients for each atom
|
||||
|
||||
@ -159,7 +159,10 @@ corresponding attribute is in:
|
||||
|
||||
Restrictions
|
||||
""""""""""""
|
||||
none
|
||||
|
||||
|
||||
This compute is part of the RIGID package. It is only enabled if
|
||||
LAMMPS was built with that package. See the :ref:`Making LAMMPS <start_3>` section for more info.
|
||||
|
||||
Related commands
|
||||
""""""""""""""""
|
||||
|
||||
@ -149,6 +149,10 @@ forces added by this fix in a consistent manner. I.e. there is a
|
||||
decrease in potential energy when atoms move in the direction of the
|
||||
added force.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by
|
||||
this fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar and a global 3-vector of forces,
|
||||
which can be accessed by various :ref:`output commands <howto_15>`. The scalar is the potential
|
||||
energy discussed above. The vector is the total force on the group of
|
||||
|
||||
@ -65,6 +65,10 @@ forces added by this fix in a consistent manner. I.e. there is a
|
||||
decrease in potential energy when atoms move in the direction of the
|
||||
added forces.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by
|
||||
this fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its torque. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar and a global 3-vector, which can be
|
||||
accessed by various :ref:`output commands <howto_15>`.
|
||||
The scalar is the potential energy discussed above. The vector is the
|
||||
|
||||
@ -97,8 +97,11 @@ more instructions on how to use the accelerated styles effectively.
|
||||
Restart, fix_modify, output, run start/stop, minimize info
|
||||
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
||||
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`. None of the :doc:`fix_modify <fix_modify>` options
|
||||
are relevant to this fix.
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global 3-vector of forces, which can be accessed
|
||||
by various :ref:`output commands <howto_15>`. This is the
|
||||
|
||||
@ -41,8 +41,11 @@ in the simulation.
|
||||
Restart, fix_modify, output, run start/stop, minimize info
|
||||
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
||||
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`. None of the :doc:`fix_modify <fix_modify>` options
|
||||
are relevant to this fix.
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global 3-vector of forces, which can be accessed
|
||||
by various :ref:`output commands <howto_15>`. This is the
|
||||
|
||||
@ -133,6 +133,10 @@ can include the forces added by this fix in a consistent manner.
|
||||
I.e. there is a decrease in potential energy when atoms move in the
|
||||
direction of the added force due to the electric field.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar and a global 3-vector of forces,
|
||||
which can be accessed by various :ref:`output commands <howto_15>`. The scalar is the potential
|
||||
energy discussed above. The vector is the total force added to the
|
||||
|
||||
@ -128,6 +128,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the gravitational potential energy of the system to the
|
||||
system's potential energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. This scalar is the
|
||||
gravitational potential energy of the particles in the defined field,
|
||||
|
||||
@ -187,6 +187,10 @@ fix to add the energy of interaction between atoms and the indenter to
|
||||
the system's potential energy as part of :doc:`thermodynamic output <thermo_style>`. The energy of each particle interacting
|
||||
with the indenter is K/3 (r - R)^3.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar energy and a global 3-vector of
|
||||
forces (on the indenter), which can be accessed by various :ref:`output commands <howto_15>`. The scalar and vector values
|
||||
calculated by this fix are "extensive".
|
||||
|
||||
@ -12,12 +12,13 @@ Syntax
|
||||
|
||||
* fix-ID = ID of the fix to modify
|
||||
* one or more keyword/value pairs may be appended
|
||||
* keyword = *temp* or *press* or *energy*
|
||||
* keyword = *temp* or *press* or *energy* or *respa*
|
||||
.. parsed-literal::
|
||||
|
||||
*temp* value = compute ID that calculates a temperature
|
||||
*press* value = compute ID that calculates a pressure
|
||||
*energy* value = *yes* or *no*
|
||||
*respa* value = *1* to *max respa level* or *0* (= outmost level)
|
||||
|
||||
|
||||
|
||||
@ -28,6 +29,7 @@ Examples
|
||||
|
||||
fix_modify 3 temp myTemp press myPress
|
||||
fix_modify 1 energy yes
|
||||
fix_modify tether respa 2
|
||||
|
||||
Description
|
||||
"""""""""""
|
||||
@ -63,6 +65,17 @@ fix-ID of the appropriate fix. Note that you must use this setting
|
||||
for a fix if you are using it when performing an :doc:`energy minimization <minimize>` and if you want the energy and forces it
|
||||
produces to be part of the optimization criteria.
|
||||
|
||||
For fixes that set or modify forces, it may be possible to select at
|
||||
which :doc:`r-RESPA <run_style>` level the fix operates via the *respa*
|
||||
keyword. The RESPA level at which the fix is active can be selected.
|
||||
This is a number ranging from 1 to the number of levels. If the RESPA
|
||||
level is larger than the current maximum, the outermost level will be
|
||||
used, which is also the default setting. This default can be restored
|
||||
using a value of *0* for the RESPA level. The affected fix has to be
|
||||
programmed to support this feature; if not, *fix_modify* will report
|
||||
an error. Active fixes with a custom RESPA level setting are reported
|
||||
with their specified level at the beginning of a r-RESPA run.
|
||||
|
||||
Restrictions
|
||||
""""""""""""
|
||||
none
|
||||
@ -76,7 +89,7 @@ Default
|
||||
"""""""
|
||||
|
||||
The option defaults are temp = ID defined by fix, press = ID defined
|
||||
by fix, energy = no.
|
||||
by fix, energy = no, respa = 0.
|
||||
|
||||
|
||||
.. _lws: http://lammps.sandia.gov
|
||||
|
||||
@ -134,6 +134,10 @@ fix to add the potential energy of atom interactions with the grain
|
||||
boundary driving force to the system's potential energy as part of
|
||||
:doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by these
|
||||
fixes. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator a fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix calculates a global scalar which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. The scalar is the
|
||||
potential energy change due to this fix. The scalar value calculated
|
||||
|
||||
@ -94,8 +94,12 @@ more instructions on how to use the accelerated styles effectively.
|
||||
Restart, fix_modify, output, run start/stop, minimize info
|
||||
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
||||
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`. None of the :doc:`fix_modify <fix_modify>` options
|
||||
are relevant to this fix.
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is performing charge equilibration. Default is
|
||||
the outermost level.
|
||||
|
||||
This fix produces a per-atom vector which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. The vector stores the
|
||||
|
||||
@ -180,6 +180,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the potential energy associated with this fix to the
|
||||
system's potential energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
.. note::
|
||||
|
||||
If you want the fictitious potential energy associated with the
|
||||
|
||||
@ -102,8 +102,14 @@ more instructions on how to use the accelerated styles effectively.
|
||||
Restart, fix_modify, output, run start/stop, minimize info
|
||||
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
|
||||
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`. None of the :doc:`fix_modify <fix_modify>` options
|
||||
are relevant to this fix.
|
||||
No information about this fix is written to :doc:`binary restart files <restart>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by
|
||||
this fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is setting the forces to the desired values; on all
|
||||
other levels, the force is set to 0.0 for the atoms in the fix group,
|
||||
so that setforce values are not counted multiple times. Default is to
|
||||
to override forces at the outermost level.
|
||||
|
||||
This fix computes a global 3-vector of forces, which can be accessed
|
||||
by various :ref:`output commands <howto_15>`. This is the
|
||||
|
||||
@ -70,6 +70,9 @@ lengths to be larger than twice the cutoff+skin. Generally, the
|
||||
domain decomposition is dependent on the number of processors
|
||||
requested.
|
||||
|
||||
This fix also requires :doc:`atom_style dpd <atom_style>` to be used
|
||||
due to shared data structures.
|
||||
|
||||
Related commands
|
||||
""""""""""""""""
|
||||
|
||||
|
||||
@ -108,8 +108,9 @@ See the :doc:`read_restart <read_restart>` command for info on how to
|
||||
re-specify a fix in an input script that reads a restart file, so that
|
||||
the operation of the fix continues in an uninterrupted fashion.
|
||||
|
||||
None of the :doc:`fix_modify <fix_modify>` options are relevant to this
|
||||
fix.
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by
|
||||
this fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a vector list of 7 quantities, which can be accessed
|
||||
by various :ref:`output commands <howto_15>`. The
|
||||
|
||||
@ -111,6 +111,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the energy stored in the spring to the system's potential
|
||||
energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. The scalar is the
|
||||
spring energy = 0.5 * K * r^2.
|
||||
|
||||
@ -57,6 +57,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the energy stored in all the springs to the system's potential
|
||||
energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. The scalar is the
|
||||
energy of all the springs, i.e. 0.5 * K * r^2 per-spring.
|
||||
|
||||
@ -61,6 +61,10 @@ by this fix for access by various :ref:`output commands <howto_15>`. No paramet
|
||||
be used with the *start/stop* keywords of the :doc:`run <run>` command.
|
||||
This fix is not invoked during :doc:`energy minimization <minimize>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
Restrictions
|
||||
""""""""""""
|
||||
none
|
||||
|
||||
@ -54,6 +54,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the energy stored in the per-atom springs to the system's
|
||||
potential energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by
|
||||
this fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar which can be accessed by various
|
||||
:ref:`output commands <howto_15>`. The scalar is an
|
||||
energy which is the sum of the spring energy for each atom, where the
|
||||
|
||||
@ -92,6 +92,10 @@ are relevant to this fix. No global or per-atom quantities are stored
|
||||
by this fix for access by various :ref:`output commands <howto_15>`. No parameter of this fix can
|
||||
be used with the *start/stop* keywords of the :doc:`run <run>` command.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is modifying forces. Default is the outermost level.
|
||||
|
||||
The forces due to this fix are imposed during an energy minimization,
|
||||
invoked by the :doc:`minimize <minimize>` command. This fix should only
|
||||
be used with damped dynamics minimizers that allow for
|
||||
|
||||
@ -289,6 +289,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the energy of interaction between atoms and each wall to
|
||||
the system's potential energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar energy and a global vector of
|
||||
forces, which can be accessed by various :ref:`output commands <howto_15>`. Note that the scalar energy is
|
||||
the sum of interactions with all defined walls. If you want the
|
||||
|
||||
@ -190,6 +190,10 @@ The :doc:`fix_modify <fix_modify>` *energy* option is supported by this
|
||||
fix to add the energy of interaction between atoms and the wall to the
|
||||
system's potential energy as part of :doc:`thermodynamic output <thermo_style>`.
|
||||
|
||||
The :doc:`fix_modify <fix_modify>` *respa* option is supported by this
|
||||
fix. This allows to set at which level of the :doc:`r-RESPA <run_style>`
|
||||
integrator the fix is adding its forces. Default is the outermost level.
|
||||
|
||||
This fix computes a global scalar energy and a global 3-length vector
|
||||
of forces, which can be accessed by various :ref:`output commands <howto_15>`. The scalar energy is the sum
|
||||
of energy interactions for all particles interacting with the wall
|
||||
|
||||
@ -135,6 +135,10 @@ Pair style *dpd/fdt/energy* requires :doc:`atom_style dpd <atom_style>`
|
||||
to be used in order to properly account for the particle internal
|
||||
energies and temperatures.
|
||||
|
||||
Pair style *dpd/fdt* currently also requires
|
||||
:doc:`atom_style dpd <atom_style>` to be used in conjunction with
|
||||
:doc:`fix shardlow <fix_shardlow>` due to shared data structures.
|
||||
|
||||
Related commands
|
||||
""""""""""""""""
|
||||
|
||||
|
||||
@ -246,7 +246,7 @@ These extra quantites can be accessed by the :doc:`compute pair/local <compute_p
|
||||
|
||||
Restrictions
|
||||
""""""""""""
|
||||
none
|
||||
|
||||
|
||||
All the granular pair styles are part of the GRANULAR package. It is
|
||||
only enabled if LAMMPS was built with that package. See the :ref:`Making LAMMPS <start_3>` section for more info.
|
||||
|
||||
@ -170,6 +170,9 @@ computed where dihedral forces are, pair forces are computed at the
|
||||
outermost level, and kspace forces are computed where pair forces are.
|
||||
The inner, middle, outer forces have no defaults.
|
||||
|
||||
For fixes that support it, the rRESPA level at which a given fix is
|
||||
active, can be selected through the :doc:`fix_modify <fix_modify>` command.
|
||||
|
||||
The *inner* and *middle* keywords take additional arguments for
|
||||
cutoffs that are used by the pairwise force computations. If the 2
|
||||
cutoffs for *inner* are 5.0 and 6.0, this means that all pairs up to
|
||||
|
||||
@ -10,7 +10,7 @@ Syntax
|
||||
|
||||
timer args
|
||||
|
||||
* *args* = one or more of *off* or *loop* or *normal* or *full* or *sync* or *nosync*
|
||||
* *args* = one or more of *off* or *loop* or *normal* or *full* or *sync* or *nosync* or *timeout* or *every*
|
||||
.. parsed-literal::
|
||||
|
||||
*off* = do not collect or print any timing information
|
||||
@ -19,6 +19,8 @@ Syntax
|
||||
*full* = like *normal* but also include CPU and thread utilzation
|
||||
*sync* = explicitly synchronize MPI tasks between sections
|
||||
*nosync* = do not synchronize MPI tasks between sections (default)
|
||||
*timeout* elapse = set walltime limit to *elapse*
|
||||
*every* Ncheck = perform timeout check every *Ncheck* steps
|
||||
|
||||
Examples
|
||||
""""""""
|
||||
@ -26,19 +28,19 @@ Examples
|
||||
.. parsed-literal::
|
||||
|
||||
timer full sync
|
||||
timer timeout 2:00:00 every 100
|
||||
timer loop
|
||||
|
||||
Description
|
||||
"""""""""""
|
||||
|
||||
Select the level of detail LAMMPS performs its CPU timings.
|
||||
Select the level of detail at which LAMMPS performs its CPU timings.
|
||||
|
||||
During a simulation run LAMMPS collects information about how much
|
||||
time is spent in different sections of the code and thus can provide
|
||||
valuable information for determining performance and load imbalance
|
||||
problems. This can be done at different levels of detail and
|
||||
accuracy. For more information about the timing output, see this
|
||||
:ref:`discussion of screen output <start_8>`.
|
||||
information for determining performance and load imbalance problems.
|
||||
This can be done at different levels of detail and accuracy. For more
|
||||
information about the timing output, see this :ref:`discussion of screen output <start_8>`.
|
||||
|
||||
The *off* setting will turn all time measurements off. The *loop*
|
||||
setting will only measure the total time for a run and not collect any
|
||||
@ -54,8 +56,29 @@ call which meaures load imbalance more accuractly, though it can also
|
||||
slow down the simulation. Using the *nosync* setting (which is the
|
||||
default) turns off this synchronization.
|
||||
|
||||
Multiple keywords can be specified. For keywords that are mutually
|
||||
exclusive, the last one specified takes effect.
|
||||
With the *timeout* keyword a walltime limit can be imposed that
|
||||
affects the :doc:`run <run>` and :doc:`minimize <minimize>` commands. If
|
||||
the time limit is reached, the run or energy minimization will exit on
|
||||
the next step or iteration that is a multiple of the *Ncheck* value
|
||||
specified with the *every* keyword. All subsequent run or minimize
|
||||
commands in the input script will be skipped until the timeout is
|
||||
reset or turned off by a new *timer* command. The timeout *elapse*
|
||||
value can be specified as *off* or *unlimited* to impose no timeout
|
||||
condition (which is the default). The *elapse* setting can be
|
||||
specified as a single number for seconds, two numbers separated by a
|
||||
colon (MM:SS) for minutes and seconds, or as three numbers separated
|
||||
by colons for hours, minutes, and seconds.
|
||||
|
||||
The *every* keyword sets how frequently during a run or energy
|
||||
minimization the wall clock will be checked. This check count applies
|
||||
to the outer iterations or time steps during minimizations or :doc:`r-RESPA runs <run_style>`, respectively. Checking for timeout too often,
|
||||
can slow a calculation down. Checking too infrequently can make the
|
||||
timeout measurement less accurate, with the run being stopped later
|
||||
than desired.
|
||||
|
||||
Multiple keywords can be specified with the *timer* command. For
|
||||
keywords that are mutually exclusive, the last one specified takes
|
||||
effect.
|
||||
|
||||
.. note::
|
||||
|
||||
@ -80,7 +103,11 @@ Related commands
|
||||
Default
|
||||
"""""""
|
||||
|
||||
timer normal nosync
|
||||
.. parsed-literal::
|
||||
|
||||
timer normal nosync
|
||||
timer timeout off
|
||||
timer every 10
|
||||
|
||||
|
||||
.. _lws: http://lammps.sandia.gov
|
||||
|
||||
Reference in New Issue
Block a user