1 | <head> |
---|
2 | <title>SODD</title> |
---|
3 | <!-- Changed by: E. T. d'Amico, 8-Sep-2004 --> |
---|
4 | </head> |
---|
5 | |
---|
6 | <body bgcolor="#ffffff"> |
---|
7 | <center> |
---|
8 | EUROPEAN ORGANIZATION FOR NUCLEAR RESEARCH |
---|
9 | <IMG SRC="http://cern.ch/madx/icons/mx7_25.gif" align=right> |
---|
10 | <h2>SODD</h2> |
---|
11 | </center> |
---|
12 | <p> |
---|
13 | This command will execute the Second Order Detuning and Distortion as |
---|
14 | described in the paper of J. Bengtsson and J. Irwin |
---|
15 | "Analytical Calculation of Smear and Tune Shift " (SSC-232, February |
---|
16 | 1990), on the beam line defined by the last USE command followed by a |
---|
17 | TWISS command. It is based on the stand-alone program written by Frank |
---|
18 | Schmidt in November 1998 - January 1999 who also extended the |
---|
19 | analytical computation to the second order distortion (cfr. Beam |
---|
20 | Physics Note 60 F. Schmidt "SODD: A physics Guide"). |
---|
21 | It consists of three parts: |
---|
22 | <p> |
---|
23 | <li><h4>Subroutine detune (launched by the attribute detune)</h4> |
---|
24 | It calculates the detuning |
---|
25 | function terms in first and second order in the strength of the |
---|
26 | multipoles. |
---|
27 | If the attribute print_at_end has been set, the following two files |
---|
28 | (and the corresponding madx tables) are created : |
---|
29 | <p> |
---|
30 | <i>detune_1_end</i> containing five columns : |
---|
31 | <ul> |
---|
32 | 1) 'multipole order', 2) '(hor., ver. plane => (1/2)', |
---|
33 | 3) 'hor. or ver. detuning', 4) 'order of horizontal invariant', 5) 'order of |
---|
34 | vertical invariant'. |
---|
35 | </ul> |
---|
36 | <p> |
---|
37 | <i>detune_2_end</i> containing five columns : |
---|
38 | <ul> |
---|
39 | 1) 'first multipole order', 2) 'second multipole order', |
---|
40 | 3) 'horizontal detuning', 4) 'order of horizontal invariant', 5)'order of |
---|
41 | vertical invariant'. |
---|
42 | </ul> |
---|
43 | If the attribute print_all has been set, the following two files |
---|
44 | (and the corresponding madx tables) are created : |
---|
45 | <p> |
---|
46 | <i>detune_1_all</i> containing five columns : |
---|
47 | <ul> |
---|
48 | 1) 'multipole order', 2) '(hor., ver. plane => (1/2)', |
---|
49 | 3) 'hor. or ver. detuning', 4) 'order of horizontal invariant', 5)'order of |
---|
50 | vertical invariant'. |
---|
51 | </ul> |
---|
52 | <i>detune_2_all</i> containing five columns : |
---|
53 | <ul> |
---|
54 | 1) 'first multipole order', 2) 'second multipole order', |
---|
55 | 3) 'horizontal detuning', 4) 'order of horizontal invariant', 5) 'order of |
---|
56 | vertical invariant'. |
---|
57 | </ul> |
---|
58 | <p> |
---|
59 | <li><h4>Subroutine distort1 (launched by the attribute distort1)</h4> |
---|
60 | It calculates the distortion function and the |
---|
61 | Hamiltonian terms in first order in the strength of the multipoles. |
---|
62 | If the attribute print_at_end has been set, the two files |
---|
63 | (and the corresponding madx tables) are created : |
---|
64 | <p> |
---|
65 | <i>distort_1_F_end</i> containing eight columns : |
---|
66 | <ul> |
---|
67 | 1) 'multipole order', 2) 'cosine part |
---|
68 | of distortion', 3) 'sine part of distortion', 4) 'amplitude of distortion', |
---|
69 | 5) 'j', 6) 'k', 7) 'l', 8) 'm'. |
---|
70 | </ul> |
---|
71 | <i>distort_1_H_end</i> containing eight columns : |
---|
72 | <ul> |
---|
73 | 1) 'multipole order', 2) 'cosine part |
---|
74 | of Hamiltonian', 3) 'sine part of Hamiltonian', 4) 'amplitude of Hamiltonian', |
---|
75 | 5) 'j', 6) 'k', 7) 'l', 8) 'm'. |
---|
76 | </ul> |
---|
77 | If the attribute print_all has been set, the following two files |
---|
78 | (and the corresponding madx tables) are created : |
---|
79 | <p> |
---|
80 | <i>distort_1_F_all</i> containing eleven columns : |
---|
81 | <ul> |
---|
82 | 1) 'multipole order', 2) 'appearance |
---|
83 | number in position range', 3) 'number of resonance', 4) 'position', 5) |
---|
84 | 'cosine part of distortion', 6) 'sine part of distortion', 7) 'amplitude of distortion', |
---|
85 | 8) 'j', 9) 'k', 10) 'l', 11) 'm'. |
---|
86 | </ul> |
---|
87 | <i>distort_1_H_all</i> containing eleven columns : |
---|
88 | <ul> |
---|
89 | 1) 'multipole order', 2) 'appearance |
---|
90 | number in position range, 3) 'number of resonance', 4) 'position', 5) 'cosine part |
---|
91 | of Hamiltonian', 6) 'sine part of Hamiltonian', 7) 'amplitude of Hamiltonian', |
---|
92 | 8) 'j', 9) 'k', 10) 'l', 11) 'm'. |
---|
93 | </ul> |
---|
94 | <p> |
---|
95 | <li><h4>Subroutine distort2 (launched by the attribute distort2)</h4> |
---|
96 | It calculates the distortion function and Hamiltonian |
---|
97 | terms in second order in the strength of the multipoles. |
---|
98 | If the attribute print_at_end has been set, the following two files |
---|
99 | (and the corresponding madx tables) are created : |
---|
100 | <p> |
---|
101 | <i>distort_2_F_end</i> containing nine columns : |
---|
102 | <ul> |
---|
103 | 1) 'first multipole order',2) 'second multipole order', |
---|
104 | 3) 'cosine part of distortion', 4) 'sine part of distortion', 5) 'amplitude of distortion', |
---|
105 | 6) 'j', 7) 'k', 8) 'l', 9) 'm'. |
---|
106 | </ul> |
---|
107 | <i>distort_2_H_end</i> containing nine columns : |
---|
108 | <ul> |
---|
109 | 1) 'first multipole order', 2) 'second multipole order', |
---|
110 | 3) 'cosine part of Hamiltonian', 4) 'sine part of Hamiltonian', 5) 'amplitude of Hamiltonian', |
---|
111 | 6) 'j', 7) 'k', 8) 'l', 9) 'm'. |
---|
112 | </ul> |
---|
113 | <p> |
---|
114 | N. B. The first row of every file is a header containing the names of |
---|
115 | the columns. This row is absent in the internal tables. |
---|
116 | <p> |
---|
117 | <li><h4><a name=sodd>SODD</a></h4> |
---|
118 | <pre> |
---|
119 | sodd, |
---|
120 | detune=logical, |
---|
121 | distort1=logical, |
---|
122 | distort2=logical, |
---|
123 | start_stop = start,stop |
---|
124 | multipole_order_range = fist,last |
---|
125 | noprint = logical |
---|
126 | print_all = logical |
---|
127 | print_at_end = logical |
---|
128 | nosixtrack = logical |
---|
129 | </pre> |
---|
130 | where the parameters have the following meaning: |
---|
131 | </ul> |
---|
132 | <ul> |
---|
133 | <li>detune : logical, default=false. If true, the detune subroutine is executed. |
---|
134 | <li>distort1 : logical, default=false. If true, the distort1 subroutine is executed. |
---|
135 | <li>distort2 : logical, default=false. If true, the distort2 subroutine is executed. |
---|
136 | <li>start_stop : longitudinal interval of the beam line (in m). start |
---|
137 | and stop should be given as real numbers. |
---|
138 | <li>multipole_order_range : the lowest and the largest multipole order |
---|
139 | which will be taken in account. first and last should be given as integers. |
---|
140 | <li>noprint : logical, default=false. If true, no file or internal |
---|
141 | table will be created to keep the results. In this case the attributes |
---|
142 | print_all or print_at_end have no effect. |
---|
143 | <li>print_all : logical, default=false. If true, the files and |
---|
144 | internal tables containing results at each multipole will be generated. |
---|
145 | <li>print_at_end : logical, default=false. If true, the files and |
---|
146 | internal tables containing results at the end of the |
---|
147 | position range will be generated. |
---|
148 | <li>nosixtrack : logical, default=false. If true, the input file |
---|
149 | fc.34 will not be generated internally by invoking the conversion |
---|
150 | routine of sixtrack and the user should provide it before the |
---|
151 | execution of the sodd command. |
---|
152 | </ul> |
---|
153 | <li>A more detailed description can be found in |
---|
154 | <address> |
---|
155 | <a href="http://cern.ch/madx/doc/ab-note-2004-069">AB-note-2004-069</a> |
---|
156 | </address> |
---|
157 | </ul> |
---|
158 | <address> |
---|
159 | <a href="http://xwho.web.cern.ch/xwho/people/show/6175">damico</a>, |
---|
160 | September 10, 2004 |
---|
161 | </address> |
---|
162 | |
---|
163 | </body> |
---|