next up previous
Next: TRWAKE Up: Element Dictionary Previous: TRCOUNT

TRFMODE

A simulation of a beam-driven TM dipole mode of an RF cavity.
Parallel capable? : yes
Parameter Name Units Type Default Description
RA $Ohm/m$ double 0.0 shunt impedance
RS $Ohm/m$ double 0.0 shunt impedance (Ra=2*Rs)
Q   double 0.0 cavity Q
FREQ $Hz$ double 0.0 frequency
CHARGE $C$ double 0.0 beam charge (or use CHARGE element)
BETA   double 0.0 normalized load impedance
BIN_SIZE $S$ double 0.0 bin size for current histogram (use 0 for autosize)
N_BINS   long 20 number of bins for current histogram
PLANE   STRING both x, y, or both
SAMPLE_INTERVAL   long 1 passes between output to RECORD file
PER_PARTICLE_OUTPUT   long 0 If non-zero, then in BINLESS mode, provides per-particle output of RECORD data.
RECORD   STRING NULL output file for cavity data
SINGLE_PASS   long 0 if nonzero, don't accumulate field from pass to pass
RIGID_UNTIL_PASS   long 0 don't affect the beam until this pass
DX $M$ double 0.0 misalignment
DY $M$ double 0.0 misalignment
XFACTOR   double 1 factor by which to multiply shunt impedances
YFACTOR   double 1 factor by which to multiply shunt impedances
RAMP_PASSES   long 0 Number of passes over which to linearly ramp up the impedance to full strength.
BINLESS   long 0 If nonzero, use algorithm that doesn't requiring binning. Best for few particles, widely spaced.
RESET_FOR_EACH_STEP   long 1 If nonzero, voltage and phase are reset for each simulation step.

A simulation of a beam-driven TM dipole mode of an RF cavity.
Parameter Name Units Type Default Description
LONG_RANGE_ONLY   long 0 If nonzero, induced voltage from present turn does not affect bunch. Short range wake should be included via TRWAKE or ZTRANSVERSE element.
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 element simulates a beam-driven dipole mode cavity using the fundamental theorem of beam loading and phasor rotation.

Normally, the field dumped in the cavity by one particle affects trailing particles in the same turn. However, if one is also using a TRWAKE or ZTRANSVSE element to simulate the short-range wake of the cavity, this would be double-counting. In that case, one can use LONG_RANGE_ONLY=1 to suppress the same-turn effects of the RFMODE element.


next up previous
Next: TRWAKE Up: Element Dictionary Previous: TRCOUNT
Robert Soliday 2014-03-21