Appendix C Bunch description formats

For compatibility with other simulation codes following bunch formats can be read. For example, to use the file distr.dat as input the beam definition should look like

     
     beam, particle="e-",distrType="guineapig_bunch",distrFile="distr.dat"
     

The formats currently supported are listed below: ¹

• guineapig_bunch : E[GeV] x[mum] y[mum] z[mum] x'[murad] y'[murad]
• guineapig_slac : E[GeV] x'[rad] y'[rad] z[mum] x[nm] y[nm]
• guineapig_pairs : E[GeV] x'[rad] y'[rad] z'[rad] x[nm] y[nm] z[nm] (here a particle with E>0 is assumed to be an electron and with E<0 a positron.)
• cain : ....

A custom distribution file format can be specified in the form

     distrType="field1[unit1]:field1[unit1]:...

The allowed values for fields/units are: .....

For instance:

     
     beam,  particle="e-",
            energy=ener * GeV,
     
     
            distrType="pt[1]:E[GeV]:xp[rad]:yp[rad]:z[mum]:x[nm]:y[nm]",
            distrFile="bunches/beam.dat";