jianmu
/
lammps
forked from lijiext/lammps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@6267 f3b2605a-c512-4ea7-a41b-209d697bcdaa

This commit is contained in:
sjplimp 2011-05-31 23:17:17 +00:00
parent 1d7c1ff18b
commit 201628e11b
2 changed files with 60 additions and 96 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
doc/suffix.html
View File

@ -25,66 +25,49 @@ suffix gpu
</PRE> </PRE>
<P><B>Description:</B> <P><B>Description:</B>
</P> </P>
<P>This command allows you to set a suffix which will <P>This command allows you to use variants of various styles if they
be added exist. In that respect it operates the same as the <A HREF = "Section_start.html#2_6">-suffix
command-line switch</A>. It also has options to
turn off/on any suffix setting made via the command line.
</P> </P>
<P>Use variants of various styles if they exist. The specified style can <P>The specified style can be <I>opt</I> or <I>gpu</I> or <I>cuda</I>. These refer to
be <I>opt</I> or <I>gpu</I> or <I>cuda</I>. These refer to optional packages that optional packages that LAMMPS can be built with, as described in <A HREF = "Section_start.html#2_3">this
LAMMPS can be built with, as described above in <A HREF = "#2_3">Section 2.3</A>. section of the manual</A>. The "opt" style
The "opt" style corrsponds to the OPT package, the "gpu" style to the corrsponds to the OPT package, the "gpu" style to the GPU package, and
GPU package, and the "cuda" style to the USER-CUDA package. the "cuda" style to the USER-CUDA package.
</P> </P>
<P>As an example, all of the packages provide a <A HREF = "pair_lj.html">pair_style <P>These are the relevant packages and the variants they provide:
lj/cut</A> variant, with style names lj/cut/opt or
lj/cut/gpu or lj/cut/cuda. Any variant styles can be specified
explicitly in your input script, e.g. pair_style lj/cut/gpu. If the
-suffix switch is used, you do not need to modify your input script.
The specified suffix (opt,gpu,cuda) is automatically appended whenever
an input script command creates a new atom, pair, fix, compute, or
integrate style. If the variant version does not exist, the standard
version is created.
</P>
<P>The <A HREF = "suffix.html">suffix</A> command can also set the suffix. It can also
turn off/on the suffix associated with this command-line switch.
</P>
<P>Alter settings for use of accelerated versions of various styles.
LAMMPS can be built with optional packages which provide accelerated
versions of specific <A HREF = "atom_style.html">atom</A>, <A HREF = "pair_style.html">pair</A>,
<A HREF = "fix.html">fix</A>, <A HREF = "compute.html">compute</A>, and <A HREF = "run_style.html">integrate</A>
styles.
</P>
<P>These are the relevant packages:
</P> </P>
<UL><LI>OPT = a handful of pair styles, cache-optimized for faster CPU performance <UL><LI>OPT = a handful of pair styles, cache-optimized for faster CPU performance
<LI>GPU = a handful of pair styles and the PPPM kspace_style, optimized to run on one or more GPUs or multicore CPU/GPU nodes <LI>GPU = a handful of pair styles and the PPPM kspace_style, optimized to run on one or more GPUs or multicore CPU/GPU nodes
<LI>USER-CUDA = a collection of atom, pair, fix, compute, and intergrate styles, optimized to run on one or more NVIDIA GPUs <LI>USER-CUDA = a collection of atom, pair, fix, compute, and intergrate styles, optimized to run on one or more NVIDIA GPUs
</UL> </UL>
<P>See <A HREF = "Section_start.html#2_3">this section</A> of the manual for <P>As an example, all of the packages provide a <A HREF = "pair_lj.html">pair_style
instructions on how to build LAMMPS with any of these packages. lj/cut</A> variant, with style names lj/cut/opt or
lj/cut/gpu or lj/cut/cuda. Any variant styles can be specified
explicitly in your input script, e.g. pair_style lj/cut/gpu. If the
suffix command is used with the appropriate style, you do not need to
modify your input script. The specified suffix (opt,gpu,cuda) is
automatically appended whenever an input script command creates a new
<A HREF = "atom_style.html">atom</A>, <A HREF = "pair_style.html">pair</A>, <A HREF = "fix.html">fix</A>,
<A HREF = "compute.html">compute</A>, or <A HREF = "run_style.html">integrate</A> style. If the
variant version does not exist, the standard version is created.
</P> </P>
<P>These styles can be specified explicitly in your input script, <P>If the specified style is <I>off</I>, then any previously specified suffix
e.g. <A HREF = "pair_lj.html">pair_style lj/cut/gpu</A>. If the -accelerator is temporarily disabled, whether it was specified by a command-line
command-line switch is used, you do not need to modify your input switch or a previous suffix command. If the specified style is <I>on</I>,
script, as discussed in <A HREF = "Section_start.html#2_6">this section</A> of the a previously specified suffix is turned back on. The use of these 2
manual. The command-line suffix (opt,gpu,cuda) is automatically commands lets your input script use a standard LAMMPS style (i.e. a
appended when the style is created for atom, pair, fix, compute, and non-accelerated variant), which can be useful for testing or
integrate styles. If an accelerated version does not exist, the benchmarking purposes. Of course this is also possible by not using
standard version is created. the suffix command, and explictly appending or non appending the
</P> suffix to the relevant commands in your input script.
<P>If the -accelerator command-line switch is used, you may wish to
disable it for one or more input script commands, so that the standard
version of the style is used instead of the accelerated one. This can
be useful for performance testing or debugging.
</P>
<P>The <I>off</I> style allows you to do this. The effect of the -accelerator
command-line switch is effectively turned off until another
accelerator command is used with the <I>on</I> style.
</P> </P>
<P><B>Restrictions:</B> none <P><B>Restrictions:</B> none
</P> </P>
<P><B>Related commands:</B> <P><B>Related commands:</B>
</P> </P>
<P><A HREF = "Section_start.html_2_6">Command-line switch -suffix</A> <P><A HREF = "Section_start.html#2_6">Command-line switch -suffix</A>
</P> </P>
<P><B>Default:</B> none <P><B>Default:</B> none
</P> </P>

79
doc/suffix.txt
View File

@ -22,67 +22,48 @@ suffix gpu :pre
[Description:] [Description:]
This command allows you to set a suffix which will This command allows you to use variants of various styles if they
be added exist. In that respect it operates the same as the "-suffix
command-line switch"_Section_start.html#2_6. It also has options to
turn off/on any suffix setting made via the command line.
Use variants of various styles if they exist. The specified style can The specified style can be {opt} or {gpu} or {cuda}. These refer to
be {opt} or {gpu} or {cuda}. These refer to optional packages that optional packages that LAMMPS can be built with, as described in "this
LAMMPS can be built with, as described above in "Section 2.3"_#2_3. section of the manual"_Section_start.html#2_3. The "opt" style
The "opt" style corrsponds to the OPT package, the "gpu" style to the corrsponds to the OPT package, the "gpu" style to the GPU package, and
GPU package, and the "cuda" style to the USER-CUDA package. the "cuda" style to the USER-CUDA package.
As an example, all of the packages provide a "pair_style These are the relevant packages and the variants they provide:
lj/cut"_pair_lj.html variant, with style names lj/cut/opt or
lj/cut/gpu or lj/cut/cuda. Any variant styles can be specified
explicitly in your input script, e.g. pair_style lj/cut/gpu. If the
-suffix switch is used, you do not need to modify your input script.
The specified suffix (opt,gpu,cuda) is automatically appended whenever
an input script command creates a new atom, pair, fix, compute, or
integrate style. If the variant version does not exist, the standard
version is created.
The "suffix"_suffix.html command can also set the suffix. It can also
turn off/on the suffix associated with this command-line switch.
Alter settings for use of accelerated versions of various styles.
LAMMPS can be built with optional packages which provide accelerated
versions of specific "atom"_atom_style.html, "pair"_pair_style.html,
"fix"_fix.html, "compute"_compute.html, and "integrate"_run_style.html
styles.
These are the relevant packages:
OPT = a handful of pair styles, cache-optimized for faster CPU performance OPT = a handful of pair styles, cache-optimized for faster CPU performance
GPU = a handful of pair styles and the PPPM kspace_style, optimized to run on one or more GPUs or multicore CPU/GPU nodes GPU = a handful of pair styles and the PPPM kspace_style, optimized to run on one or more GPUs or multicore CPU/GPU nodes
USER-CUDA = a collection of atom, pair, fix, compute, and intergrate styles, optimized to run on one or more NVIDIA GPUs :ul USER-CUDA = a collection of atom, pair, fix, compute, and intergrate styles, optimized to run on one or more NVIDIA GPUs :ul
See "this section"_Section_start.html#2_3 of the manual for As an example, all of the packages provide a "pair_style
instructions on how to build LAMMPS with any of these packages. lj/cut"_pair_lj.html variant, with style names lj/cut/opt or
lj/cut/gpu or lj/cut/cuda. Any variant styles can be specified
explicitly in your input script, e.g. pair_style lj/cut/gpu. If the
suffix command is used with the appropriate style, you do not need to
modify your input script. The specified suffix (opt,gpu,cuda) is
automatically appended whenever an input script command creates a new
"atom"_atom_style.html, "pair"_pair_style.html, "fix"_fix.html,
"compute"_compute.html, or "integrate"_run_style.html style. If the
variant version does not exist, the standard version is created.
These styles can be specified explicitly in your input script, If the specified style is {off}, then any previously specified suffix
e.g. "pair_style lj/cut/gpu"_pair_lj.html. If the -accelerator is temporarily disabled, whether it was specified by a command-line
command-line switch is used, you do not need to modify your input switch or a previous suffix command. If the specified style is {on},
script, as discussed in "this section"_Section_start.html#2_6 of the a previously specified suffix is turned back on. The use of these 2
manual. The command-line suffix (opt,gpu,cuda) is automatically commands lets your input script use a standard LAMMPS style (i.e. a
appended when the style is created for atom, pair, fix, compute, and non-accelerated variant), which can be useful for testing or
integrate styles. If an accelerated version does not exist, the benchmarking purposes. Of course this is also possible by not using
standard version is created. the suffix command, and explictly appending or non appending the
suffix to the relevant commands in your input script.
If the -accelerator command-line switch is used, you may wish to
disable it for one or more input script commands, so that the standard
version of the style is used instead of the accelerated one. This can
be useful for performance testing or debugging.
The {off} style allows you to do this. The effect of the -accelerator
command-line switch is effectively turned off until another
accelerator command is used with the {on} style.
[Restrictions:] none [Restrictions:] none
[Related commands:] [Related commands:]
"Command-line switch -suffix"_Section_start.html_2_6 "Command-line switch -suffix"_Section_start.html#2_6
[Default:] none [Default:] none