Info on how to put orbit bumps into any ATF extraction-line element
To Calculate an orbit bump (x,x' or y,y') use the fontbump.m matlab code on ~user1/font/steering.
To calculate the effect of a corrector current change on an element, use kicker_response.m in the same location. Both files are included here also.
The structure lat mentioned below is contained in the matlab data file in the attachments.
For instructions on how to use see below:
fontbump
[k1_amp k2_amp] = fontbump(kik1,kik2,ele,y,yp,lat,apply)
Inputs:
kik1 and kik2 are the names of correctors to use for bump- for putting orbits into both BINP and KEK BPMs- use:
- ZH3X and ZH4X for horizontal bumps
- ZV7X and ZV8X for vertical bumps.
ele is the name of any element in the ATF extraction line deck to calculate the bump at. Useful locations are:
- CBPM1S CBPM2S CBPM3S for the BINP BPMs
- CBPM1K CBPM2K CBPM3K for the KEK BPMs
- ML1X... for ATF stripline BPMs
- Nothing in the deck yet for ATF2 BPM
y and yp are the position and angle required at ele (is really horizontal position if kickers are ZH*X and vertical if ZV*X). Units are um/urad.
lat is the lattice to use- latest lattice is in quadson_13dec05.mat
apply [0|1], if 0 then just calculate the corrector changes, if 1 apply them (obviously select 0 if not running on nanolinux with machine operational).
Outputs:
k1_amp, k2_amp are the corrector current changes required to the 2 correctors chosen in Amps.
kicker_response
[ x,xp,y,yp ] = kicker_response( lat,BpmName,CorrName,CorrVal )
Inputs:
lat as above
BpmName- actually name of any element in deck as ele above
CorrName- any horizontal or vertical corrector as kik1,2 above. Actually, any lattice element name will do here- you can pretend BPM's are correctors if you like! (who am I to restrict artistic freedom?!)
CorrVal- current change in named corrector desired in Amps
Outputs:
x,xp,y,yp are the position and angle changes at given BpmName with given current change in given corrector. You should read x,xp values for horizontal correctors and y,yp values for vertical correctors. No cross-coupling is assumed. Units are um/urad.
NB: The relation between Corrector values and dx' or dy' is:
theta=((0.124833*112e-3)/(33.3564*energy))*CorrVal
where, energy is 1.28 GeV and CorrVal is in Amps.
NEW:
Now added the transport matrices between elements in the ATF extraction line in the attached .mat file in the attachments section. Look up the indicies of the elements you are interested in, in the Names cell array. Then look up the response matrix in the cell array Rmat.
Feb 22: Added KEK2 BPM position in R matrix data- called CBPMK2
