Guinea Pig

Guinea Pig is an e+e- beam beam simulation program

Author: Daniel Schulte

Documentation: See the new GUINEA PIG MANUAL (2/2/99) which Kathy Thompson has adapted from Appendix A of Daniel's thesis. This manual describes the input parameters and the output files. The classic reference for the physics of the beam-beam interaction is Beam-beam phenomena in linear colliders (44 pages, PS 4.36MB), K.Yokoya and P.Chen, Frontiers of Particle Beams: Intensity Limitations, edited by M.Month and S.Turner, Lecture Notes in Physics Vol. 400 (Springer-Verlag, Berlin, 1990),pp.415-445.

MatLiar Guinea Pig has been incorporated in the accelerator code that simulates NLC performance.  More documentation and newer versions of the code than that used for background simulations are available from the MatLiar Web Site.

Other Knowledgeable People:
Olivier Napoly
Kathy Thompson
Mike Woods

To Install Guinea Pig Source code on your UNIX account:

• copy the most recent program directory to your own machine and run the makefile to create an executable, or
• copy over the gp.tar file, unpack the tar-file using the command 'tar xvf gp.tar', and make the executable using the command 'make guinea'

Program versions
We are trying to keep all versions of the program that have generated useful files on web accessible UNIX machines.

• ver_1999_07_08 : used to generate the pair background files

• ver_1998_09_21: used to create e-e- files

ACC.DAT Input File

• The acc.dat file defines the machine and the processes you want to simulate.  The NLC parameter sets, as they were defined on 8/22/98, are the basis for the ACCELERATOR PARAMETERS used in the simulations.   Schulte has advised us on a consistent set of TECHNICAL PROGRAM PARAMETERS. Each process simulated has a number of other physics cuts which play off program performance to required resolution.  See the acc.dat file used for the process you are interested.

To Run the program:

• Edit the 'acc.dat' file
• See the documentation to understand what variables do
• Run the program via 'guinea ACCELERATOR PARAMETERS fileout.out'
• For example, guinea NLC-B-500 standard nlcb0500.out

NLC e+e- Ray Sets

• Organized by machine energy and parameter set.  We hope these will become the "standard" sets of ray files to be used for background analyses.
• Data result files are also available for the e-e- machine option.

Standard Plots

• It would be wonderful if someone would volunteer to produce and post some standard plots

Last modified 02/06/03
Tom Markiewicz