elegant2genesis

• description: elegant2genesis analyzes particle output data from elegant and prepares a ``beamfile'' for input to GENESIS[8], a 3-D time-dependent FEL code by S. Reiche. The beamfile is contains slice analysis of the particle data, and may be useful in other applications as well.

• synopsis:
  elegant2genesis inputfile outputfile [-pipe=[in][,out]] [-textOutput] [-totalCharge=coulombs | -chargeParameter=name] [-wavelength=meters | -slices=integer] [-steer] [-removePTails=deltaLimit=value[,fit][,beamOutput=filename]]

• files:
  • inputfile -- A particle output file from elegant or any other program that uses the same column names and units.
  • outputfile -- Contains the slice analysis, suitable for use with SDDS-compliant GENESIS.

• switches:
  • -pipe[in][,out] -- The standard SDDS toolkit pipe option.
  • -textOutput -- Requests text output instead of SDDS output, which may be useful for input to non-SDDS-complaint versions of GENESIS.
  • -totalCharge=coulombs -- Gives the total charge of the beam in Coulombs.
  • -chargeParameter=name -- Gives the name of a parameter in inputfile where the total charge in the beam is given.
  • -wavelength=meters -- This option is misnamed. It is actually the slice length in meters.
  • -slices=integer -- The number of analysis slices to use.
  • -steer -- If given, then the transverse centroids for the bulk beam are all set to zero. The relative centroid offsets of the slices are, of course, unchanged.
  • removePTails=deltaLimit=value[,fit][,beamOutput={\em filename}\verb]| -- Remvoes the momentum tails from the beam. deltaLimit is the maximum absolute value of $(p-\langle p \rangle)/\langle p \rangle$ that will be accepted. If fit is given, then a linear fit to $p$ as a function of $t$ is performed, and removal is based on the residuals from that fit. If beamOutput is given, then the filtered beam data is written to the named file for review.

• author: R. Soliday, ANL/APS.