doc/src/comm_style.txt

   1 "LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
   2
   3 :link(lws,http://lammps.sandia.gov)
   4 :link(ld,Manual.html)
   5 :link(lc,Section_commands.html#comm)
   6
   7 :line
   8
   9 comm_style command :h3
  10
  11 [Syntax:]
  12
  13 comm_style style :pre
  14
  15 style = {brick} or {tiled} :ul
  16
  17 [Examples:]
  18
  19 comm_style brick
  20 comm_style tiled :pre
  21
  22 [Description:]
  23
  24 This command sets the style of inter-processor communication of atom
  25 information that occurs each timestep as coordinates and other
  26 properties are exchanged between neighboring processors and stored as
  27 properties of ghost atoms.
  28
  29 For the default {brick} style, the domain decomposition used by LAMMPS
  30 to partition the simulation box must be a regular 3d grid of bricks,
  31 one per processor.  Each processor communicates with its 6 Cartesian
  32 neighbors in the grid to acquire information for nearby atoms.
  33
  34 For the {tiled} style, a more general domain decomposition can be
  35 used, as triggered by the "balance"_balance.html or "fix
  36 balance"_fix_balance.html commands.  The simulation box can be
  37 partitioned into non-overlapping rectangular-shaped "tiles" or varying
  38 sizes and shapes.  Again there is one tile per processor.  To acquire
  39 information for nearby atoms, communication must now be done with a
  40 more complex pattern of neighboring processors.
  41
  42 Note that this command does not actually define a partitoining of the
  43 simulation box (a domain decomposition), rather it determines what
  44 kinds of decompositions are allowed and the pattern of communication
  45 used to enable the decomposition.  A decomposition is created when the
  46 simulation box is first created, via the "create_box"_create_box.html
  47 or "read_data"_read_data.html or "read_restart"_read_restart.html
  48 commands.  For both the {brick} and {tiled} styles, the initial
  49 decomposition will be the same, as described by
  50 "create_box"_create_box.html and "processors"_processors.html
  51 commands.  The decomposition can be changed via the
  52 "balance"_balance.html or "fix balance"_fix_balance.html commands.
  53
  54 [Restrictions:] none
  55
  56 [Related commands:]
  57
  58 "comm_modify"_comm_modify.html, "processors"_processors.html,
  59 "balance"_balance.html, "fix balance"_fix_balance.html
  60
  61 [Default:]
  62
  63 The default style is brick.