[430] | 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> |
---|