A first-order matrix RF cavity with exact phase dependence, plus optional amplitude and phase
Parallel capable? : yes
GPU capable? : no
Back-tracking capable? : no
phase reference number (to link with other time-dependent elements)
magnitude of amplitude modulation (fraction value)
phase of amplitude modulation
frequency of amplitude modulation
exponential decay rate of amplitude modulation
magnitude of phase modulation
phase of phase modulation
frequency of phase modulation
exponential decay rate of phase modulation
mode for determining fiducial arrival time (light, tmean, first, pmaximum)
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 is very similar to the RFCA element, except that the amplitude and phase of the cavity can be modulated.
The phase convention is as follows, assuming a positive rf voltage: PHASE=90 is the crest for acceleration. PHASE=180 is the stable phase for a storage ring above transition without energy losses.
The element works by first computing the fidicial arrival time t. Using this, the effective voltage is computed using the amplitude modulation parameters, according to
where V 0 is the nominal cavity voltage VOLT, Aam is AMMAG, ωam is the angular frequency corresponding to AMFREQ, ϕam is the amplitude modulation phase corresponding to AMPHASE (converted from degrees to radians), and αam is AMDECAY.
The phase of the phase modulation is computed using
where ωpm is the angular frequency corresponding to PMFREQ and Δϕpm is the phase offset corresponding to PMPHASE (converted from degrees to radians). The rf phase for the centroid is then computed using
where ω0 is the nominal rf angular frequency (corresponding to FREQ), ϕ0 corresponds to PHASE (converted to radians), Φm corresponds to PMMAG (converted to radians), and αpm corresponds to PMDECAY.
The effective instantaneous rf angular frequency is
Using all of the above, the voltage seen by a particle arriving at time t is then