10.13 CHARGE—An element to establish the total charge of a beam. Active on first pass only. If given, overrides all charge specifications on other elements.

An element to establish the total charge of a beam. Active on first pass only. If given, overrides all charge specifications on other elements.
Parallel capable? : yes
GPU capable? : no
Back-tracking capable? : yes






Parameter Name Units Type Default

Description






TOTAL C double0.0

total charge in beam






PER_PARTICLE C double0.0

charge per macroparticle






ALLOW_TOTAL_CHANGENULLlong 0

If nonzero, allow total charge to change while tracking even if number of particles does not change. Useful for ramping of charge.






GROUP string NULL

Optionally used to assign an element to a group, with a user-defined name. Group names will appear in the parameter output file in the column ElementGroup






This is the preferred way to assign charge to a beam, which is needed for the use of CSR simulation (CSRCSBEND, CSRDRIFT), wake simulation (WAKE, TRWAKE, LRWAKE, ZLONGIT, ZTRANSVERSE), rf mode simulation (RFMODE, TRFMODE, FRFMODE, RTRFMODE), space charge simulation (LSCDRIFT, RFCW, SCMULT), and intrabeam scattering simulation (IBSCATTER).

CLEAN