source: PSPA/madxPSPA/doc/usrguide/ptc_auxiliaries/PTC_SelectMoment.html @ 430

Last change on this file since 430 was 430, checked in by touze, 11 years ago

import madx-5.01.00
File size: 5.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1" ?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5<html xmlns="http://www.w3.org/1999/xhtml">
6
7<head>
8<meta http-equiv=Content-Type content="text/html; charset=iso-8889-2">
9<meta name=Generator content="NEdit">
10<meta name=Originator content="Skowron">
11<link rel="stylesheet" type="text/css" href="../ptc_general/madxdoc_ps.css" />
12<title>PTC_SELECT_MOMENT</title>
13<style>
14</style>
15</head>
16
17<body bgcolor="#ffffff"'>
18
19<div style="text-align:center;">
20<center>
21  EUROPEAN ORGANIZATION FOR NUCLEAR RESEARCH
22  <IMG SRC="http://cern.ch/madx/icons/mx7_25.gif" align="right">
23  <h1>PTC_SELECT_MOMENT</h1>
24 
25</center>
26</div>
27
28
29<!--  ##########################################################              -->
30
31<div class="madxdocContent">
32
33
34<!--  ##########################################################              -->
35<!--  ##########################################################              -->
36<!--  ##########################################################              -->
37
38<h3 align=center style='margin-top:0cm;text-align:left;text-indent:0cm'>
39 <span>
40  USER MANUAL
41 </span>
42</h3>
43
44<div>
45
46<!--  ##########################################################              -->
47
48<h4>SYNOPSIS</h4>
49
50<pre>
51<big>
52PTC_SELECT_MOMENT,
53table      = [s, none, none],
54column     = [s, none, none],
55moments   = [s, none] ,
56moments   = [i, {0}] ,
57parametric = [l, false, true],
58
59</big>
60</pre>
61
62</div>
63 
64<!--  ##########################################################              -->
65
66<h4> Description </h4>
67
68<div>
69Selects a moment to be:
70<p>
71   a) <b>Stored in a user specified table and column. </b>
72<p>
73   b) <b>Stored as a function (taylor series) of
74      <a href="PTC_Knob.html">knobs</a>,  if any is defined.</b> 
75      Than, <i>parametric</i> switch should be set to true.
76<p>
77Both a) and b) can be joined in one command.
78
79
80</div>
81
82<h4> Examples</h4>
83
84<a href="http://cern.ch/frs/mad-X_examples/ptc_madx_interface/moments/moments.madx"> ATF2 </a>
85
86
87<!--  ##########################################################              -->
88
89<h4> Command parameters and switches </h4>
90<div>
91
92<dl>
93
94
95<dt><b> moment_s </b></dt> 
96  <dd>
97  <i> list of coma separated strings composed of up to 6 digits </i>
98  <p> Defines moment of the polynomial in PTC nomenclature.
99      String 'ijklmn' (i,j,k,l,m,n are digits ) defines
100      &lt;x<sup>i</sup>p<sub>x</sub><sup>j</sup>y<sup>k</sup>p<sub>y</sub><sup>l</sup>
101      &Delta;T<sup>m</sup>(&Delta;p/p)<sup>n</sup>&gt;.
102      For example, moments=1000000 defines &lt;x<sup>1</sup>&gt;
103  <p>
104      Note that for input we always use MAD-X notation where dp/p is always the 6th coordinate.
105      (Internaly PTC dp/p is the 5th coordinate. We perform automatic conversion that is transparent for the user.)
106      As the consequence RMS in dp/p is always defined as 000002, even in 5D case.
107  <p>   
108      This notations allows to define more then one moment with one command. In this case,
109      the corresponding column names are as the passed strings with "mu" prefix.
110      However, they are always extended to 6 digits, i.e. the trailing 0 are automatically added.
111      For example, if specified moments=2, the column name is mu200000.
112  <p>   
113      This method does not allow to pass bigger numbers then 9. If you need to define
114      such a moment, use the command switch below.
115  </dd>
116
117
118<dt><b> moment </b></dt> 
119  <dd>
120  <i> list of up to 6 coma separated integers, </i>
121  <p> Defines a moment. For example: moment=2 defines &lt;x<sup>2</sup>&gt; ,
122      moment=0,0,2 : &lt;y<sup>2</sup>&gt;,
123      moment=0,14,0,2 : &lt;px<sup>14</sup>py<sup>2</sup>&gt;, etc.
124  </dd>
125
126<dt><b> table </b></dt> 
127  <dd>
128  <i> string, default "moments" </i>
129  <p> Specifies name of the table where the calculated moments should be stored.
130  </dd>
131
132
133<dt><b> column </b></dt> 
134  <dd>
135  <i> string </i>
136  <p> Ignored if <i> moments </i> is specified.
137      Defines name of the column where values should be stored.
138      If not specified then it is automatically generated from moment the definition
139      &lt;x<sup>i</sup>p<sub>x</sub><sup>j</sup>y<sup>k</sup>p<sub>y</sub><sup>l</sup>
140      &Delta;T<sup>m</sup>(&Delta;p/p)<sup>n</sup>&gt; =&gt;
141      mu_i_j_k_l_m_n (numbers separated with underscores).
142     
143     
144  </dd>
145
146
147<dt><b> parametric </b></dt> 
148  <dd>
149  <i> logical, default false, if value explicitly not specified then true</i>
150  <p> If it is true, and any
151      <a href="PTC_Knob.html">knobs</a> 
152      are defined the map element is stored as the parametric result.
153       
154  </dd>
155
156
157
158</dl>
159
160<h4>  </h4>
161
162
163<!-- ############################################################ -->
164<!-- ############################################################ -->
165<!-- ############################################################ -->
166<!--
167<h3> PROGRAMMERS MANUAL </h3>
168
169<p> 
170The command is implemented pro_ptc_SELECT function in madxn.c and
171by subroutine xxxx in madx_ptc_xxx.f90.
172<p>
173Sopecified range is resolved with help of get_range command. Number of the element in the current sequence
174is resolved and passed as the parameter to the fortran routine. It allows to resolve uniquely the corresponding
175element in the PTC layout.
176<p>
177
178-->
179
180</div>
181
182</body>
183
184</html>
Note: See TracBrowser for help on using the repository browser.