The specifications might be changed without notice. If you have
\nany complaint,
\n
please do not hesitate to write to me.
\nkikuchim@post.kek.jp\n<\/p>\n
1. Orbit correction\n<\/p>\n
1.1 CorrectOrbit<\/b> makes an orbit correction.\n<\/p>\n
Usage:\n<\/p>\n
CorrectOrbit[orbit-kind,monitor,steer,optics,options]<\/b>\n<\/p>\n
orbit-kind<\/b> : a character string or a list
\nof character strings which
\n
\nrepresent an orbit object to be corrected, for example,
\n
\n“X”, “EY”, {“X”,”Y”}, {“Y”,”EY”}, etc., where “X” represents
\n
\nhorizontal orbit and “EY” the vertical dispersion.
\n
monitor<\/b> : a list of
\nmonitor element which is defined by the
\n
\nfunction Monitor.
\n
steer<\/b> :
\na list of steering element which is defined by the
\n
\nfunction Steer.
\n
optics<\/b> : a list
\nof optics parameters which is defined by the function
\n
\nCalculateOptics.\n<\/p>\n
options<\/b> : optional parameters 1.2 Monitor <\/b>specifies beam position monitors.\n<\/p>\n Usage:\n<\/p>\n Monitor[mon,options]<\/b>\n<\/p>\n mon <\/b> 2. Orbit manupilation with bump\n<\/p>\n 2.1 Bump<\/b> creates a “Bump” object.\n<\/p>\n Usage:\n<\/p>\n b = Bump[str,options]<\/b>\n<\/p>\n str<\/b> :a list of steering element The following is the optional parameters, which are used 2.2 MakeBump<\/b> makes an orbit bump.\n<\/p>\n Usage:\n<\/p>\n MakeBump[b,str,optics,options]<\/b>\n<\/p>\n The function returns a list of steering b<\/b> :a bump 2.3 CorrectOrbitBump<\/b> makes an orbit correction using orbit-bumps CorrectOrbitBump[v,f,bpm,str,optics,options]<\/b>\n<\/p>\n The arguments are the same as those of CorrectOrbit v<\/b> a character string or a list of character Result: (1) Returns a list of kick angles and bump variable. Incomplete manual on orbit correction and orbit manupilations. The specifications might be changed without notice. If you have any complaint, please do not hesitate to write to me. kikuchim@post.kek.jp 1. Orbit correction 1.1 CorrectOrbit...<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[6],"tags":[],"class_list":["post-89","post","type-post","status-publish","format-standard","hentry","category-how-to-use-sad"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/posts\/89","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/comments?post=89"}],"version-history":[{"count":3,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/posts\/89\/revisions"}],"predecessor-version":[{"id":472,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/posts\/89\/revisions\/472"}],"wp:attachment":[{"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/media?parent=89"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/categories?post=89"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/acc-physics.kek.jp\/SAD\/wp-json\/wp\/v2\/tags?post=89"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\nin the form of opt->parameters;
\n
________________________________________________________________________
\n
option default
\ndescriptions
\n
————————————————————————
\n
SetSteer True
\nSet calculated steer values after correction.
\n
Solver “LeastSquare”
\nType of solver routine. For MICADO method
\n
\nSolver->{“Micado”,n}, n is number
\n
\nof correctors.
\n
TotalKick {Null,Null}
\nSpecifies a constraint to the steering strength.
\n
\nTotalKick->{ax,ay} means that the sum of the
\n
\nkick angle should be ax and ay for horizontal
\n
\nand vertical steers, respectively.
\n
ZeroSum False
\nZeroSum->True is equivalent to TotalKick->{0,0}
\n
TotalDZ Null
\nTotalDZ->dz imposes a constraint on the correction
\n
\nthat circumference is increased by amount of dz.
\n
DN
\n{Null,Null} DN->{dnx,dny} imposes a constraint
\non the
\n
\ncorrection that the tune is increased by an amount
\n
\nof {dnx,dny}. DTune<\/b> can be used instead of DN.
\n
Tune {0,0}
\nA list of tunes {nu-x,nu-y} which is used for a
\n
\ncalculation of the response matrix. If tune is zero,
\n
\nthat of the input optics is used.
\n
Orbit {}
\nA list of orbit values that is to be minimized.
\n
Calc True
\nCalulate a resultant optics and set it in the
\n
\nTwiss buffer.
\n
EPS 1e-8
\nPrecision in the LinearSolve. Epsilon<\/b> can be
\n
\nused instead of EPS.
\n
Condition {{},{}}
\nA list {c,d}, where c is a matrix and d is
\n
\na vector representing a condition equations
\n
\nthat the solution should obeys:
\n
\nc.x==d .
\n
\nMore convenient form of Condition option is
\n
\navailable:
\n
\nCondition->{{“ZX.1″,”ZX.2″,”ZX.3”},{1,-2,1},0}}
\n
\n, for example, where “ZX” is the steer element.
\n
\nThis is equivalent to a condition equation
\n
\nZX.1 – 2*ZX.3 + ZX.3 == 0 .
\n
Weight
\nAutomatic A list of weight factors to the monitors. If Automatic
\n
\nSqrt of beta-function at the monitors is
\n
\napplied. MonitorWeight<\/b> can be used instead of Weight.
\n
CorrectorWeight Automatic A list of weight
\nfactors to the correctors. Default is
\n
\nunity.
\n
ExpectedOrbit False
\nLeave an expected orbit in the Twiss buffer
\n
\nafter corretion. (ExpectedOrbit->True)
\n
\noverrides the (Calc->True). This option is
\n
\nconvenient for OPERATE mode.
\n
MomentumCompaction Null If
\nnot Null, an effect of circumference change is taken
\n
\ninto account in the calculation of single-kick response.
\n
MomentumCorrection False Momentum
\ndeviation is used as a corrector variable. If
\n
\nTrue, resultant momentum-deviation is appended as the
\n
\nlast component of the list of kick angle.
\n
MomentumWeight 1
\nRelative weight factor for the momentum deviation given
\n
\nin a unit of betabpm<\/sub>betacorr<\/sub>\/etabpm<\/sub>2<\/sup>.
\nEffective if
\n
\nMomentumCorrection->True.
\n
————————————————————————
\n
Result: (1) Returns a list of kick angle. If MomentumCorrection->True,
\nmomentum
\n
\ndeviation is given as the last component.
\n
(2) Resultant steer
\nstrength is set to “K0” slot in the LINE
\n
\nif SetSteer->True (default).
\n
(3) Calculate optics
\nif Calc->True and ExpectedOrbit->False and
\n
\nOPERATE flag is false.
\n
(4) Leave an estimated
\norbit in the Twiss buffer if
\n
\nExpectedOrbit->True.
\n
\n<\/p>\n
\n: a character string or a list of character strings that
\n
\nmatch beam-line-elements which will be used as beam position
\n
\nmonitors in the CorrectOrbit. Any beam-line-element can be
\n
\nspecified. Example: “QF”, “QD*”, {“MX*”,”MY*”}.
\n
options<\/b> : optional
\nparameters in the form of opt->parameters;
\n
________________________________________________________________________
\n
option default
\ndescriptions
\n
————————————————————————
\n
AttachTo NearestMagnet
\nElement to which the beam position monitor is
\n
\nassumed to be attached. Defualt selects nearest
\n
\nquad or sext.
\n
Offset {0,0}
\nRms lateral offset relative to the AttachTo
\n
\nelement. In every call of Monitor random Gaussian
\n
\noffset is generated.
\n
Jitter {0,0}
\nMesurement jitter in rms for horizontal and vertical
\n
\nplane. In every call of CorrectOrbit, a random
\n
\nGaussian jitter is added to the orbit.
\n
————————————————————————
\n
Result: (1) Returns a list that represent a specification of the
\nbpm:
\n
\n1st component: a list of bpm positions in the lattice.
\n
\n2nd component: a list of list of horizontal and vertical offsets.
\n
\n3rd component: a list of horizontal and vertical jitter.
\n
\n4th component: a list of AttachTo element.\n<\/p>\n
\nwhich is defined by the
\n
function
\nSteer.
\n
options <\/b>: optional parameters in the form of opt->parameters.\n<\/p>\n
\nto specify
\n
the desired shape of the bump.
\n
____________________________________________________________________
\n
option default
\ndescriptions
\n
——————————————————————–
\n
Range Null
\nSpecifies the range of the bump
\n
Center Null
\nSepcifies the center position where
\n
\nthe bump is placed.
\n
Plane Automatic
\nThe plane of the bump. “H” or “V” or “HV”.
\n
Condition Null
\nOrbit conditions. The following forms
\n
\nare allowed,
\n
\n{“QF”,”X”,1e-3} or
\n
\n{{“QF”,”X”,1e-3},{“QF”,”PX”,0},…}
\n
\nThe first one means that x should be 1 mm at “QF”,
\n
\nand the second that x should be 1 mm and<\/i> px is
\n
\n0 mrad at “QF”.
\n
NumberOfSteers 6
\nNumber of steers used for the bump.
\n
——————————————————————–
\n
Result: (1) The symbol b is defined as a “Bump” object.
\n
\n
\n
\n<\/p>\n
\n
strength and index of steers used for
\nmaking a bump whose specification
\n
is given by b. The resultant steer strength
\nis set to K0 slot in the LINE.\n<\/p>\n
\nobject defined through the function Bump as
\n
\nb = Bump[str,Center->…,…]
\n
str<\/b> :a list of steering
\nelement which is defined by the
\n
function
\nSteer.
\n
optics<\/b> :a list of optics parameters which
\nis defined by the function
\n
\nCalculateOptics.
\n
options<\/b> :optional parameters in the form of
\nopt->parameters;
\n
____________________________________________________________________
\n
option default
\ndescriptions
\n
——————————————————————–
\n
SetSteer True
\nSet steer values.
\n
Calc True
\nCalulate a resultant optics and set it in
\n
\nthe Twiss buffer.
\n
——————————————————————–
\n
Result: (1) Returns a list of kick angles and indices of used steers.
\n
(2) Resultant steer
\nstrength is set to “K0” slot in the LINE
\n
\nif SetSteer->True(default).
\n
(3) Calculate optics
\nif Calc->True and OPERATE flag is false.
\n
\n
\n
\n
\n<\/p>\n
\nas
\n
correctors (knobs).
\n
Usage:\n<\/p>\n
\nexcept for f,
\n
which specifies bump variables. The function returns
\na list of
\n
steer strength and determined bump-variables. The
\nresultant
\n
steer strength is set to “K0” slot in the LINE. SetSteer
\noption
\n
is not accepted.\n<\/p>\n
\nstrings that represent
\n
an orbit object to be corrected,
\nfor example,
\n
\n“X”, “EY”, {“X”,”Y”}, {“Y”,”EY”}, etc.
\n
f<\/b> bump variables defined through any
\nof the following forms.
\n
f1=Bump[str,Center->..,…,Condition->{“QF”,”X”,#}]&
\n
f2=Bump[str,Center->..,…,Condition->{{“QF”,”X”,#1},
\n
\n{“QF”,”PX”,#2}}]&
\n
or f3=Function[x,
\n
\nBump[str,Center->..,…,Condition->{“QF”,”X”,x}]
\n
or f4[x_]=Bump[str,Center->..,…,Condition->{“QF”,”X”,x}]
\n
or f={f1,f2,f3,f4}
\n
bpm<\/b> a list of monitor element
\nwhich is defined by the
\n
function
\nMonitor.
\n
str<\/b> a list of steering element
\nwhich is defined by the
\n
function
\nSteer.
\n
optics<\/b> a list of optics parameters which is
\ndefined by the function
\n
CalculateOptics.
\n
options<\/b> optional parameters in the form of opt->parameters,
\nsee
\n
explanations
\nof CorrectOrbit\n<\/p>\n
\n
(2) Resultant steer
\nstrength is set to “K0” slot in the LINE.
\n
(3) Calculates optics
\nif Calc->True and ExpectedOrbit->False and
\n
\nOPERATE flag is false.
\n
(4) Leaves an estimated
\norbit in the Twiss buffer if
\n
\nExpectedOrbit->True.<\/p>\n","protected":false},"excerpt":{"rendered":"