Guinea Pig

Guinea Pig is an e+e- beam-beam simulation program written by Daniel Schulte.

This page has been prepared for Snowmass 2001 and some external links have been removed. The official NLC Beam Delivery Guinea Pig page can be found here.

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, 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. 

To Install Guinea Pig Source code (only tested on Linux):

• copy the source code to your own machine and run the makefile to create an executable. 

Program version: The code corresponds to ver_1999_07_08

ACC.DAT Input File

• The acc.dat file defines the machine and the processes you want to simulate.   

To Run the program:

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

Standard output:

• The canonical Snowmass NLC configurations have been run to produce output files which can be used to study machine backgrounds. A few example bunch crossings have been processed through GEANT3 models of the LD and SD detectors. HBOOK ntuples of the resulting hits in the detectors can be found in the appropriate directories here.
• The files can be analyzed with PAW using the KUIP macro files found here, or converted to ROOT tuples using h2root, or within JAS using this example analysis.