← Back to branch summary

~ubuntu-branches/debian/sid/lammps/sid

« back to all changes in this revision

Viewing changes to doc/suffix.html

  • Committer: Package Import Robot
  • Author(s): Anton Gladky
  • Date: 2015-04-29 23:44:49 UTC
  • mfrom: (5.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20150429234449-mbhy9utku6hp6oq8
Tags: 0~20150313.gitfa668e1-1
Upload into unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/suffix.html
15
15
</P>
16
16
<PRE>suffix style 
17
17
</PRE>
18
 
<UL><LI>style = <I>off</I> or <I>on</I> or <I>opt</I> or <I>omp</I> or <I>gpu</I> or <I>cuda</I> 
 
18
<UL><LI>style = <I>off</I> or <I>on</I> or <I>cuda</I> or <I>gpu</I> or <I>intel</I> or <I>kk</I> or <I>omp</I> or <I>opt</I> 
19
19
</UL>
20
20
<P><B>Examples:</B>
21
21
</P>
22
22
<PRE>suffix off
23
23
suffix on
24
 
suffix gpu 
 
24
suffix gpu
 
25
suffix intel
 
26
suffix kk 
25
27
</PRE>
26
28
<P><B>Description:</B>
27
29
</P>
28
30
<P>This command allows you to use variants of various styles if they
29
31
exist.  In that respect it operates the same as the <A HREF = "Section_start.html#start_7">-suffix
30
32
command-line switch</A>.  It also has options
31
 
to turn off/on any suffix setting made via the command line.
 
33
to turn off or back on any suffix setting made via the command line.
32
34
</P>
33
 
<P>The specified style can be <I>opt</I>, <I>omp</I>, <I>gpu</I>, or <I>cuda</I>.  These refer to
34
 
optional packages that LAMMPS can be built with, as described in <A HREF = "Section_start.html#start_3">this
35
 
section of the manual</A>.  The "opt" style
36
 
corrsponds to the OPT package, the "omp" style to the USER-OMP package, 
37
 
the "gpu" style to the GPU package, and the "cuda" style to the
38
 
USER-CUDA package.
 
35
<P>The specified style can be <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or
 
36
<I>opt</I>.  These refer to optional packages that LAMMPS can be built
 
37
with, as described in <A HREF = "Section_start.html#start_3">this section of the
 
38
manual</A>.  The "cuda" style corresponds to
 
39
the USER-CUDA package, the "gpu" style to the GPU package, the "intel"
 
40
style to the USER-INTEL package, the "kk" style to the KOKKOS package,
 
41
the "omp" style to the USER-OMP package, and the "opt" style to the
 
42
OPT package,
39
43
</P>
40
44
<P>These are the variants these packages provide:
41
45
</P>
42
 
<UL><LI>OPT = a handful of pair styles, cache-optimized for faster CPU
43
 
performance 
 
46
<UL><LI>USER-CUDA = a collection of atom, pair, fix, compute, and intergrate
 
47
styles, optimized to run on one or more NVIDIA GPUs 
 
48
 
 
49
<LI>GPU = a handful of pair styles and the PPPM kspace_style, optimized to
 
50
run on one or more GPUs or multicore CPU/GPU nodes 
 
51
 
 
52
<LI>USER-INTEL = a collection of pair styles and neighbor routines
 
53
optimized to run in single, mixed, or double precision on CPUs and
 
54
Intel(R) Xeon Phi(TM) coprocessors. 
 
55
 
 
56
<LI>KOKKOS = a collection of atom, pair, and fix styles optimized to run
 
57
using the Kokkos library on various kinds of hardware, including GPUs
 
58
via Cuda and many-core chips via OpenMP or threading. 
44
59
 
45
60
<LI>USER-OMP = a collection of pair, bond, angle, dihedral, improper,
46
61
kspace, compute, and fix styles with support for OpenMP
47
62
multi-threading 
48
63
 
49
 
<LI>GPU = a handful of pair styles and the PPPM kspace_style, optimized to
50
 
run on one or more GPUs or multicore CPU/GPU nodes 
51
 
 
52
 
<LI>USER-CUDA = a collection of atom, pair, fix, compute, and intergrate
53
 
styles, optimized to run on one or more NVIDIA GPUs 
 
64
<LI>OPT = a handful of pair styles, cache-optimized for faster CPU
 
65
performance 
54
66
</UL>
55
67
<P>As an example, all of the packages provide a <A HREF = "pair_lj.html">pair_style
56
68
lj/cut</A> variant, with style names lj/cut/opt, lj/cut/omp,
57
 
lj/cut/gpu, or lj/cut/cuda.  A variant styles can be specified
58
 
explicitly in your input script, e.g. pair_style lj/cut/gpu.  If the
59
 
suffix command is used with the appropriate style, you do not need to
60
 
modify your input script.  The specified suffix (opt,omp,gpu,cuda) is
61
 
automatically appended whenever your input script command creates a
62
 
new <A HREF = "atom_style.html">atom</A>, <A HREF = "pair_style.html">pair</A>,
63
 
<A HREF = "bond_style.html">bond</A>, <A HREF = "angle_style.html">angle</A>,
64
 
<A HREF = "dihedral_style.html">dihedral</A>, <A HREF = "improper_style.html">improper</A>,
65
 
<A HREF = "kspace_style.html">kspace</A>, <A HREF = "fix.html">fix</A>, <A HREF = "compute.html">compute</A>, or
66
 
<A HREF = "run_style.html">run</A> style.  If the variant version does not exist,
67
 
the standard version is created.
 
69
lj/cut/gpu, lj/cut/intel, lj/cut/cuda, or lj/cut/kk.  A variant styles
 
70
can be specified explicitly in your input script, e.g. pair_style
 
71
lj/cut/gpu. If the suffix command is used with the appropriate style,
 
72
you do not need to modify your input script.  The specified suffix
 
73
(opt,omp,gpu,intel,cuda,kk) is automatically appended whenever your
 
74
input script command creates a new <A HREF = "atom_style.html">atom</A>,
 
75
<A HREF = "pair_style.html">pair</A>, <A HREF = "bond_style.html">bond</A>,
 
76
<A HREF = "angle_style.html">angle</A>, <A HREF = "dihedral_style.html">dihedral</A>,
 
77
<A HREF = "improper_style.html">improper</A>, <A HREF = "kspace_style.html">kspace</A>,
 
78
<A HREF = "fix.html">fix</A>, <A HREF = "compute.html">compute</A>, or <A HREF = "run_style.html">run</A> style.
 
79
If the variant version does not exist, the standard version is
 
80
created.
 
81
</P>
 
82
<P>When using the intel suffix, LAMMPS will first attempt to use a style
 
83
with the intel suffix.  If the USER-OMP package is installed, the the
 
84
omp suffix will be tried as a second choice, if a requested style is
 
85
not available in the USER-INTEL package.
68
86
</P>
69
87
<P>If the specified style is <I>off</I>, then any previously specified suffix
70
88
is temporarily disabled, whether it was specified by a command-line