ZTRANSVERSE

A simulation of a single-pass broad-band or functionally-specified transverse dipole impedance.

Parameter Name	Units	Type	Default	Description
CHARGE	$C$	double	0.0	beam charge (or use CHARGE element)
BROAD_BAND		long	0	broad-band impedance?
RS	$Ohm$	double	0.0	shunt impedance (Ra=2*Rs)
Q		double	0.0	cavity Q
FREQ	$Hz$	double	0.0	frequency (BROAD_BAND=1)
INPUTFILE		STRING	NULL	name of file giving impedance (BROAD_BAND=0)
FREQCOLUMN		STRING	NULL	column in INPUTFILE containing frequency
ZXREAL		STRING	NULL	column in INPUTFILE containing real impedance for x plane
ZXIMAG		STRING	NULL	column in INPUTFILE containing imaginary impedance for x plane
ZYREAL		STRING	NULL	column in INPUTFILE containing real impedance for y plane
ZYIMAG		STRING	NULL	column in INPUTFILE containing imaginary impedance for y plane
BIN_SIZE	$S$	double	0.0	bin size for current histogram (use 0 for autosize)
INTERPOLATE		long	0	interpolate wake?
N_BINS		long	128	number of bins for current histogram
SMOOTHING		long	0	smooth current histogram?
SG_ORDER		long	1	Savitzky-Golay filter order for smoothing
SG_HALFWIDTH		long	4	Savitzky-Golay filter halfwidth for smoothing
DX	$M$	double	0.0	misalignment
DY	$M$	double	0.0	misalignment

This element allows simulation of a transverse impedance using a ``broad-band'' resonator or an impedance function specified in a file. The impedance is defined as the Fourier transform of the wake function

$$Z(\omega) = \int_{-\infty}^{+\infty} e^{-i \omega t} W(t) dt$$ (13)

where $i = \sqrt{-1}$, $W(t)=0 for t<0$, and $W(t)$ has units of $V/C/m$. Note that there is no factor of $i$ in front of the integral.

For a resonator impedance, the functional form is

$$Z(\omega) = \frac{1}{\omega} \frac{R_s}{1 + iQ(\frac{\omega}{\omega_r} - \frac{\omega_r}{\omega})},$$ (14)

where $R_s$ is the shunt impedance in $Ohms/m$, $Q$ is the quality factor, and $\omega_r$ is the resonant frequency.

When providing an impedance in a file, the user must be careful to conform to these conventions.

Other notes:

1. The frequency data required from the input file is not $\omega$, but rather $f = \omega/(2 \pi)$.
2. The default smoothing setting (SG_HALFWIDTH=4), may apply too much smoothing. It is recommended that the user vary this parameter if smoothing is employed.