Elements

A list of all element types and the relevant parameter keywords follows. Unless otherwise noted, all values default to zero except the aperture, which defaults to 1 meter.

  

drift 


l 		is the length.









sbend


l 		is the length.


angle 		is the bend angle.


k1 		$\parbox{8cm}{If the standard convention is being used, k1 is given b...
...e being used, k1 is $n = -\frac{\rho}{B_{0}}\frac{\partial B_{0}}{\partial x}$}$


e1 		is the entrance edge angle.


e2 		is the exit edge angle.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/2 is assumed.}$


k2 		$\parbox{8cm}{If the standard convention is being used, k2 is given b...
..., k2 is$\beta=\frac{\rho^{2}}{2B_{0}}\frac{\partial^{2}B_{0}}{\partial x^{2}}$}$


h1 		is the entrance pole face curvature.


h2 		is the exit pole face curvature.


hgap 		$\parbox{8cm}{is the entrance half gap size. If hgapx is not given a ...
... of hgap. Duringfitting, however, both hgap and hgapx must be varied together.}$


fint 		$\parbox{8cm}{is the entrance fringe field integral, which defaults t...
...xit half gap size. See hgap.fintx is the exit fringe field integral. See fint.}$









rbend		$\parbox{11cm}{The rbend is a parallel faced dipole magnet. Its param...
...ided bythe user and are set by the program to half the value of the bendangle.}$









quadrupole


l 		is the length.


k1 		is the strength.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/4 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation









sextupole


l 		is the length.


k2 		is the strength.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/6 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation









quadsext


l 		is the length.


k1 		is the quadrupole strength.


k2 		is the sextupole strength.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/4 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation









octupole


l 		is the strength.


k3 		is the strength.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/8 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation.









multipole


l 		$\parbox{8cm}{is the length. If the length is zero, the strengths are interpreted as integrated strengths.}$


k0 - k20 		are the strengths.


t0 - t20 		$\parbox{8cm}{are the tilt angles. If tn is entered without a value, halfturn/2(n+1) is assumed.}$


scalefac 		$\parbox{8cm}{is a dimensionless strength factor, used to scale all the strengths together.}$


tilt 		is the overall tilt angle.


aperture 		is the magnet aperture for the Hardware operation.


note1 : 		$\parbox{11cm}{ only the components with non zero amplitude are store...
...g errors via the ERROR definition then enter components with small amplitudes.}$


note2 : 		$\parbox{11cm}{when a quadrupole or a sextupole component is present ...
...important in computing misalignment effects with multipole components present.}$









solenoid


l 		is the length.


ks 		is the solenoid strength. ks=0.5*Bs/Brho.


k1 		is the quadrupole strength.


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/4 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation.









quadac  		$\parbox{11cm}{(linac cavity containing a quadrupole element)}$


l 		is the length.


k1 		is the quadrupole strength


deltae 		$\parbox{8cm}{is the energy increment per unit length in GeV/m given by the cavity to a particle riding on the crest of the wave.}$


phi0 		$\parbox{8cm}{is the phase of the reference particle with respect to the RF wave.}$


freq 		is the frequency of the RF in MHz.


e0 		is the energy in GeV of the reference particle


tilt 		$\parbox{8cm}{is the tilt angle. If tilt is entered with no value, halfturn/4 is assumed.}$


aperture 		is the magnet aperture for the Hardware operation.









rfcavity


l 		is the length.


volt 		is the cavity voltage.(kV for Utransport)


lag 		$\parbox{8cm}{is the phase lag of the cavity with respect to a nominal particle (0,0,0,0,0,0) at the start of the machine.(Degrees for Utransport)}$


freq 		$\parbox{8cm}{is the frequency of the cavity.(Hz for Utransport) In p...
...type (electrons or protons) is selected via the constant definition operation.}$


energy 		is the energy.(GeV)









roll		$\parbox{11cm}{This element performs a rotation of the coordinate system about the longitudinal axis.}$


angle 		$\parbox{8cm}{is the rotation angle. A positive angle means the new c...
... system is rotated clockwise about the s- axis with respect to the old system.}$









zrot		$\parbox{11cm}{This element performs a rotation of the coordinate system about the vertical axis. The angle must be small.}$


angle 		$\parbox{8cm}{is the rotation angle. A positive angle means the new c...
...em is rotated clockwise about the local z-axis with respect to the old system.}$









hkick, vkick				$\parbox{8cm}{These elements are translated by the program into general kicks (gkick).}$


kick 		a horizontal (vertical) kick of size kick,









gkick		$\parbox{11cm}{This element is a general kick.}$


l 		is the length.


dx 		is the change in x.


dxp 		is the change in x'.


dy 		is the change in y.


dyp 		is the change in y'.


dl 		is the change in path length.


dp 		is the change in dp/p.


angle 		$\parbox{8cm}{is the angle through which the coordinates are rotated about the longitudinal axis.}$


dz 		is the longitudinal displacement.


v 		$\parbox{8cm}{is the extrance-exit parameter of the kick. v is positi...
... force the kick to be applied every abs(v) turns. The default value of v is 1.}$


t 		$\parbox{8cm}{is the momentum dependence parameter. The kicks dx' and...
...ine oscillation is proportional to the pathlength of the reference trajectory.}$









hmon, vmon, monitor				$\parbox{8cm}{These elements are horizontal, vertical, and horizontal and vertical monitors, respectively.}$


l 		is the monitor length.


xserr,		not used presently


yserr,		not used presently


xrerr,		not used presently


yrerr 		not used presently









marker		$\parbox{11cm}{A marker is a drift element of zero length. It has no parameters.}$









ecollimator, rcollimator				$\parbox{8cm}{An ecollimator is elliptic, and an rcollimator is recta...
.... The particles are checked at the entrance and at the exit of the collimator.}$


l 		is the length.


xsize 		 x collimator aperture


ysize 		y  collimator aperture   The default                apertures are 1 meter.









arbitelm		$\parbox{11cm}{This is the arbitrary element. Its parameters are used...
... only be recognized by the program through the use of one parameter as a flag.}$


l 		is the length.


p1 - p20 		are the parameters.









mtwiss


l 		is the length.


mux,		 x phase advance of twiss matrix


betax,		 x beta value of twiss matrix


alphax,		 x alpha value of twiss matrix


muy,		 x phase advance of twiss matrix


betay,		 y beta value of twiss matrix


alphay 		 $\parbox{8cm}{y alpha value of twiss matrix betax and betay have default values of 1.}$









matrix		$\parbox{11cm}{This element is a general transfer matrix.}$


rij 		 first order ij element of matrix      


tijk 		$\parbox{8cm}{second order ijk element of matrix, i,j and k range from 1 to 6, but j is always less than or equal to k.}$