tools/xmovie/README

   1 Xmovie is an X-based visualization package that can reads particle
   2 data in a simple text format.  LAMMPS output files are in this format
   3 (by default).  Xmovie displays 2d projections of 3d (or 2d) data sets.
   4 While simple, it is extremely fast, and often useful for debugging.
   5
   6 Xmovie was written by Mike Uttormark, while visiting Sandia, in the
   7 summer of 1994.  Subsequent small changes have been made by Steve
   8 Plimpton.
   9
  10 To make xmovie for your platform, edit the top section of the Makefile
  11 appropriately for your machine.  You will need to point at the correct
  12 X libraries for xmovie to compile and link properly.
  13
  14 Once you have an xmovie executable you can test it by typing:
  15
  16 xmovie dummy.dat
  17
  18 A control window and a display window should pop open.  Move the
  19 "thickness" slider all the way to the right and click "Start".  You
  20 should see a small white ball oscillate back and forth in the display.
  21
  22 The examples directory in the LAMMPS distribution has several
  23 simulations that can be run with LAMMPS to produce dump.* files that
  24 you can use xmovie to visualize.  The Movies page of the LAMMPS WWW
  25 Site has animations of these simulations that were produced by
  26 converting saved xmovie snapshots to MPEG files (via ImageMagick's
  27 convert program).  Note that LAMMPS output is scaled by default (so
  28 all coordinates are from 0 to 1).  Thus you need to run xmovie like
  29 this:
  30
  31 xmovie -scale dump.*
  32
  33 to see the snapshot you expect.
  34
  35 The xmovie control window options should be self-explanatory.  You are
  36 always viewing a 2d projection of your 2d or 3d snapshot; the
  37 "position" and "thickness" sliders control the range of the slab of
  38 atoms being projected.  You will not always see a snapshot when xmovie
  39 begins, unless you push the "thickness" slider to the right.
  40
  41 Type xmovie to see a list of command-line options and info on file
  42 formats.
  43
  44 ---------------------------------------------------------------
  45
  46 If the xpm.h file is not on a system, it must be downloaded from
  47 somewhere
  48
  49 Needed to build on IBM cheetah at ORNL:
  50 #include </apps/xpm/3.4k/rs_aix51/include/X11/xpm.h>
  51