| 1 | <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
|---|
| 2 | <html> |
|---|
| 3 | <head> |
|---|
| 4 | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
|---|
| 5 | <meta name="GENERATOR" content="Mozilla/4.77 [en] (Windows NT 5.0; U) [Netscape]"> |
|---|
| 6 | <title>MATCH / ENDMATCH</title> |
|---|
| 7 | <!-- Changed by: Chris ISELIN, 27-Jan-1997 --> |
|---|
| 8 | <!-- Changed by: Oliver Bruning, 20-Jun-2002 --> |
|---|
| 9 | <!-- Changed by: Hans Grote, 30-Sep-2002 --> |
|---|
| 10 | <!-- Changed by: Riccardo de Maria, 9-Jan-2008 --> |
|---|
| 11 | </head> |
|---|
| 12 | <body bgcolor="#FFFFFF"> |
|---|
| 13 | |
|---|
| 14 | <center>EUROPEAN ORGANIZATION FOR NUCLEAR RESEARCH<img SRC="mx7_25.gif" align=RIGHT></center> |
|---|
| 15 | |
|---|
| 16 | <center> |
|---|
| 17 | <h2> |
|---|
| 18 | Enter and Leave <a href="match.html">Matching |
|---|
| 19 | Mode</a></h2></center> |
|---|
| 20 | Before matching at least one <a href="../Introduction/sequence.html">SEQUENCE</a> |
|---|
| 21 | must be selected by means of a <a href="../control/general.html#use">USE</a> |
|---|
| 22 | command. The matching module can act on more than one sequence simultaneously |
|---|
| 23 | by specifying more than one sequence when <a href="../match/match_main.html#match">INITIATING</a> |
|---|
| 24 | the matching mode: |
|---|
| 25 | <h2> |
|---|
| 26 | <a NAME="match"></a>Initiating the Matching Module</h2> |
|---|
| 27 | The 'match' command can be either used for matching a periodic cell or |
|---|
| 28 | for matching an insertion to another part of the machine. Both matching |
|---|
| 29 | modes are initiated by the MATCH command. |
|---|
| 30 | <ul> |
|---|
| 31 | <li> |
|---|
| 32 | <a NAME="cell"></a>Cell matching:</li> |
|---|
| 33 | |
|---|
| 34 | <p><br>In the first mode the matching routine is initiated only with one |
|---|
| 35 | attribute specifying the sequence(s) the matching module will work on. In |
|---|
| 36 | this matching mode the periodicity of the optics functions is enforced |
|---|
| 37 | at the beginning and end of the selected range. |
|---|
| 38 | <p>MATCH, SEQUENCE='name1', 'name2',..,nema-n'; |
|---|
| 39 | <br> |
|---|
| 40 | <li> |
|---|
| 41 | Insertion matching:</li> |
|---|
| 42 | |
|---|
| 43 | <p><br>In the second mode, called insertion matching, the matching routine |
|---|
| 44 | is initiated with two attributes: one specifying the sequence(s) the matching |
|---|
| 45 | module will work on and one specifying the initial conditions of the optic |
|---|
| 46 | functions for each sequence. In this case the initial values are assumed |
|---|
| 47 | as exact. |
|---|
| 48 | <ul> |
|---|
| 49 | <li> |
|---|
| 50 | Specification of Initial Values: The initial values of the optical functions |
|---|
| 51 | for the insertion matching can either be specified in form of a <a href="../control/general.html#savebeta">SAVEBETA</a> |
|---|
| 52 | command or by explicitly stating the individual optic function values after |
|---|
| 53 | the 'MATCH' command. The two options can be entered as</li> |
|---|
| 54 | |
|---|
| 55 | <pre>MATCH,sequence='name1','name2',..,'name-n',BETA0='beta01','beta02',..,'beta0n';</pre> |
|---|
| 56 | or |
|---|
| 57 | <pre>MATCH,SEQUENCE='sequence-name', BETX=real,ALFX=real,MUX=real, |
|---|
| 58 | BETY=real,ALFY=real,MUY=real, |
|---|
| 59 | X=real,PX=real,Y=real,PY=real, |
|---|
| 60 | DX=real,DY=real,DPX=real,DPY=real, |
|---|
| 61 | DELTAP=real;</pre> |
|---|
| 62 | > Examples: |
|---|
| 63 | <ul> |
|---|
| 64 | <li> |
|---|
| 65 | Example 1:</li> |
|---|
| 66 | |
|---|
| 67 | <pre>CELL: SEQUENCE=(...) ; |
|---|
| 68 | INSERT: SEQUENCE=(...) ; |
|---|
| 69 | USE,PERIOD=cell; |
|---|
| 70 | SAVEBETA,LABEL=bini,place=#e; |
|---|
| 71 | TWISS,SEQUENCE=cell; |
|---|
| 72 | USE,PERIOD=insert; |
|---|
| 73 | MATCH,SEQUENCE=insert,BETA0=bini; |
|---|
| 74 | CONSTRAINT,SEQUENCE=insert,RANGE=#e,MUX=9.345,MUY=9.876;</pre> |
|---|
| 75 | This matches the sequence 'INSERT' with initial conditions to a new phase |
|---|
| 76 | advance. The initial conditions are given by the periodic solution for |
|---|
| 77 | the sequence CELL1. |
|---|
| 78 | <li> |
|---|
| 79 | Example 2:</li> |
|---|
| 80 | |
|---|
| 81 | <pre>USE,PERIOD=INSERT; |
|---|
| 82 | MATCH,SEQUENCE=insert; |
|---|
| 83 | CONSTRAINT,SEQUENCE=insert,RANGE=#e,MUX=9.345,MUY=9.876;</pre> |
|---|
| 84 | This matches the beam line 'INSERT' with periodic boundary conditions to |
|---|
| 85 | a new phase advance.</ul> |
|---|
| 86 | The initial conditions can also be transmitted by a combination of a <a href="../control/general.html#savebeta">SAVEBETA</a> |
|---|
| 87 | command and explicit optic function specifications: |
|---|
| 88 | <pre>USE,CELL1; |
|---|
| 89 | SAVEBETA,LABEL=bini,PLACE=#E; |
|---|
| 90 | TWISS,SEQUENCE=CELL1; |
|---|
| 91 | USE,PERIOD=LINE1; |
|---|
| 92 | MATCH,SEQUENCE=LINE1,BETA0=bini,MUX=1.234,MUY=4.567;</pre> |
|---|
| 93 | This example transmits all values of the SAVEBETA array 'bini' as initial |
|---|
| 94 | values to the MATCH command and overrides the initial phase values by the |
|---|
| 95 | given values.</ul> |
|---|
| 96 | An additional <a href="match_con.html#constraint">CONSTRAINT</a> |
|---|
| 97 | may be imposed in other places, i.e. intermediate or end values of the |
|---|
| 98 | optics functions at the transition point. |
|---|
| 99 | <br> |
|---|
| 100 | <li> |
|---|
| 101 | More than one active sequence:</li> |
|---|
| 102 | |
|---|
| 103 | <p><br>The matching module can act on more than one sequence simultaneously |
|---|
| 104 | by specifying more than one sequence after the MATCH command: |
|---|
| 105 | <pre>MATCH,SEQUENCE=LINE1,CELL1,BETA0=bini1,bini2;</pre> |
|---|
| 106 | This example initiates the matching mode for the 'LINE1' and the 'CELL1' |
|---|
| 107 | sequence. The <a href="../twiss/twiss.html">Twiss |
|---|
| 108 | module</a> function of the two sequences are calculated with fixed initial |
|---|
| 109 | conditions. The SAVEBETA array 'bini1' is used for calculating the optics |
|---|
| 110 | functions of sequence 'LINE1' and the SAVEBETA array 'bini2' for calculating |
|---|
| 111 | the optics functions of sequence 'CELL1'. Without the initial conditions |
|---|
| 112 | the matching module will work in the <a href="match_main.html#cell">CELL</a> |
|---|
| 113 | mode. |
|---|
| 114 | <p><br> |
|---|
| 115 | <li> <font color="#ff0000"> |
|---|
| 116 | Special flag:</li></ul> |
|---|
| 117 | <p><br> |
|---|
| 118 | The "slow" attribute enforces the old and slow matching procedure which allows |
|---|
| 119 | to use the special columns <tt>mvar1, ..., mvar4</tt>, if they are added to the twiss table. |
|---|
| 120 | Recently a number of parameter, like "RE56", have been |
|---|
| 121 | added to list of matchable parameters. Nevertheless, some parameters |
|---|
| 122 | might only be available when using the "slow" attribute. |
|---|
| 123 | </font> |
|---|
| 124 | <h2> |
|---|
| 125 | <a NAME="match"></a><font size=+2>Further attributes of the TWISS statements |
|---|
| 126 | are:</font></h2> |
|---|
| 127 | |
|---|
| 128 | <ul> |
|---|
| 129 | <li> |
|---|
| 130 | RMATRIX: If this flag is used the one-turn map at the location of every |
|---|
| 131 | element is calculated and prepared for storage in the TWISS table.</li> |
|---|
| 132 | |
|---|
| 133 | <br>Target values for the matrix elements at certain positions in the sequence |
|---|
| 134 | can be specified with the help of the <a href="match_con.html#constraint">CONSTRAINT</a> |
|---|
| 135 | command and the |
|---|
| 136 | keywords: <b>RE, RE11...RE16...RE61...RE66</b>, where <b>REij</b> refers |
|---|
| 137 | to the "ij" matrix component. |
|---|
| 138 | <br> |
|---|
| 139 | <br>> Examples: |
|---|
| 140 | <ul> |
|---|
| 141 | <pre>Example 1: |
|---|
| 142 | MATCH,RMATRIX,SEQUENCE='name',BETA0='beta-block-name'; |
|---|
| 143 | CONSTRAINT,SEQUENCE=insert,RANGE=#e,RE11=-2.808058321,re22=2.748111197; |
|---|
| 144 | VARY,NAME=kqf,STEP=1.0e-6; |
|---|
| 145 | VARY,NAME=kqd,STEP=1.0e-6;</pre> |
|---|
| 146 | This matches the sequence 'name' with initial conditions to new values |
|---|
| 147 | for the matrix elements 'RE11' and 'RE22' by varying the strength of the |
|---|
| 148 | main quadrupole circuits.</ul> |
|---|
| 149 | <li> |
|---|
| 150 | CHROM: If this flag is used the chromatic functions at the location of every |
|---|
| 151 | element are calculated and prepared for storage in the TWISS table.</li> |
|---|
| 152 | |
|---|
| 153 | <br>Target values for the chromatic functions at certain positions in the |
|---|
| 154 | sequence can be specified with the help of the <a href="match_con.html#constraint">CONSTRAINT</a> command and the keywords <a href="../Introduction/tables.html#normal">WX, PHIX, WY, PHIY,...</a>. |
|---|
| 155 | |
|---|
| 156 | </ul> |
|---|
| 157 | |
|---|
| 158 | <h2> |
|---|
| 159 | <a NAME="endmatch"></a>Leave Matching Mode</h2> |
|---|
| 160 | The ENDMATCH command terminates the matching section and deletes all tables |
|---|
| 161 | related to the matching run. |
|---|
| 162 | <pre>ENDMATCH;</pre> |
|---|
| 163 | |
|---|
| 164 | <hr> |
|---|
| 165 | <address> |
|---|
| 166 | <a href="http://bruening.home.cern.ch/bruening/">Oliver Brüning</a>, |
|---|
| 167 | October, 2003; |
|---|
| 168 | <a href="http://rdemaria.home.cern.ch/rdemaria/">Riccardo de Maria</a>, January, 2008. |
|---|
| 169 | </address> |
|---|
| 170 | |
|---|
| 171 | </body> |
|---|
| 172 | </html> |
|---|
![(please configure the [header_logo] section in trac.ini)](/PSPA/chrome/site/pspa.gif)
