This is the readme file for Scott Johnson's quantum field theory (QFT)
calculation software.  The ZIP file contains the source code for the
American Journal of Physics paper:

Johnson, Scott C. and Gutierrez, Thomas D., Visualizing the Phonon
Wave Function, American Journal of Physics, vol. 70, no. 3,
pages 227-237, March 2002.

Contents:

readme.txt         This file
johnson.tex        TeX source file, using RevTeX 4.0
                   (available from the American Physical Society)
ho.cpp             C++ source file for figures 1-7
pho.cpp            C++ source file for figures 8-23
make.bat           A MS-DOS batch file for compiling the code and
                   generating the paper, including all the figures

Note that this software is NOT user-friendly.  To do anything other than
generate the pictures in the paper, you must edit and recompile the
source code.

This software works with Borland C++ 5.0, but since it only uses command
line arguments and generates text files, it will probably work with
other compiliers, too.  You must have the header files listed near the
top of each file and the associated libraries.  This could be a problem
for the COMPLEX.H file, which doesn't seem to be as standardized as the
other header files.

Once you compile each program ("ho.exe" and "pho.exe"), run each at the
command line with a single argument specifying the figure to generate.
For example, typing "ho 05" generates the postscript file
"johnson05.ps".  The "pho.exe" program accepts an optional second
argument specifying the number of Monte Carlo iterations to use.  The
default is 50, but this gives somewhat lumpy graphs for some figures,
particularly the ones with coherent states.  Figure 19 is the worst,
requiring about 500 iterations until it looks good.

The exact syntax used to generate the paper are recorded in the batch
file "make.bat".  This may or may not be useful to anyone but me.

I love this project.  To learn more, I suggest doing one or more of the
following:
  1.  Read the AJP paper.
  2.  Read the block comments in the source code.
  3.  Write me an email and ask me anything -- I'll likely give you much
      more information that you wanted because I love talking about this
      project so much.
  4.  Check my personal web page for any new updates:
      landau.ucdavis.edu/~sjohnson

Enjoy!

--Scott Johnson
scott.c.johnson@intel.com
sjohnson@landau.ucdavis.edu


