doc/src/accelerate_opt.txt

   1 "Previous Section"_Section_packages.html - "LAMMPS WWW Site"_lws -
   2 "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
   3
   4 :link(lws,http://lammps.sandia.gov)
   5 :link(ld,Manual.html)
   6 :link(lc,Section_commands.html#comm)
   7
   8 :line
   9
  10 "Return to Section accelerate overview"_Section_accelerate.html
  11
  12 5.3.5 OPT package :h5
  13
  14 The OPT package was developed by James Fischer (High Performance
  15 Technologies), David Richie, and Vincent Natoli (Stone Ridge
  16 Technologies).  It contains a handful of pair styles whose compute()
  17 methods were rewritten in C++ templated form to reduce the overhead
  18 due to if tests and other conditional code.
  19
  20 Here is a quick overview of how to use the OPT package.  More details
  21 follow.
  22
  23 make yes-opt
  24 make mpi                               # build with the OPT package
  25 Make.py -v -p opt -o mpi -a file mpi   # or one-line build via Make.py :pre
  26
  27 lmp_mpi -sf opt -in in.script                # run in serial
  28 mpirun -np 4 lmp_mpi -sf opt -in in.script   # run in parallel :pre
  29
  30 [Required hardware/software:]
  31
  32 None.
  33
  34 [Building LAMMPS with the OPT package:]
  35
  36 The lines above illustrate how to build LAMMPS with the OPT package in
  37 two steps, using the "make" command.  Or how to do it with one command
  38 via the src/Make.py script, described in "Section
  39 2.4"_Section_start.html#start_4 of the manual.  Type "Make.py -h" for
  40 help.
  41
  42 Note that if you use an Intel compiler to build with the OPT package,
  43 the CCFLAGS setting in your Makefile.machine must include "-restrict".
  44 The Make.py command will add this automatically.
  45
  46 [Run with the OPT package from the command line:]
  47
  48 As in the lines above, use the "-sf opt" "command-line
  49 switch"_Section_start.html#start_7, which will automatically append
  50 "opt" to styles that support it.
  51
  52 [Or run with the OPT package by editing an input script:]
  53
  54 Use the "suffix opt"_suffix.html command, or you can explicitly add an
  55 "opt" suffix to individual styles in your input script, e.g.
  56
  57 pair_style lj/cut/opt 2.5 :pre
  58
  59 [Speed-ups to expect:]
  60
  61 You should see a reduction in the "Pair time" value printed at the end
  62 of a run.  On most machines for reasonable problem sizes, it will be a
  63 5 to 20% savings.
  64
  65 [Guidelines for best performance:]
  66
  67 Just try out an OPT pair style to see how it performs.
  68
  69 [Restrictions:]
  70
  71 None.