source: PSPA/madxPSPA/doc/usrguide/ptc_auxiliaries/PTC_EPlacement.html

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

import madx-5.01.00
File size: 5.4 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_EPLACEMENT</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_EPLACEMENT</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_EPLACEMENT,
53range = [s, none],
54x        = [r, 0], y       = [r, 0], z       = [r, 0],
55phi      = [r, 0],
56theta   = [r, 0],
57onlyposition    = [l, false, true] ,
58onlyorientation = [l, false, true] ,
59autoplacedownstream = [l, true, true] ,
60refframe = [s, gcs] ;
61
62</big>
63</pre>
64
65</div>
66 
67<!--  ##########################################################              -->
68
69<h4> Description </h4>
70
71<div>
72Places a given element at required position and orientation.
73All rotations are made around the front face of the element.
74</div>
75
76<h4> Example </h4>
77<a href="http://cern.ch/frs/mad-X_examples/ptc_madx_interface/eplacement/chicane.madx">  Dog leg chicane </a> :
78postion of quads is matched to obtain required R566 value.
79
80<!--  ##########################################################              -->
81
82<h4> Command parameters and switches </h4>
83<div>
84
85<dl>
86<dt><b> range </b></dt> 
87  <dd>
88  <i> string in range format, </i>
89  <p> Specifies name of the element to be moved.
90  </dd>
91<dt><b> x,y,z </b></dt> 
92  <dd>
93  <i> real,   </i>
94  <p>Coordinate of the front face of the magnet.
95  </dd>
96<dt><b> phi, theta </b></dt> 
97  <dd>
98  <i> real,   </i>
99  <p> polar (in xz plane, around z axis) and azimuthal (around x axis) angles, respectively.
100  </dd>
101
102
103<dt><b> refframe </b></dt> 
104  <dd>
105  <i> string, default gcs</i>
106  <p> Defines the coordinate system with respect to which coordinates and angles are specified.
107      Possible values are:
108      <dl> 
109      <dt>gcs </dt> <dd> global coordinate system </dd> 
110      <dt>current </dt> <dd>  current position</dd>
111      <dt>previouselement </dt> <dd> end face of the previous element </dd>
112      </dl>
113  </dd>
114
115<dt><b> onlyposition </b></dt> 
116  <dd>
117  <i> logical, default false, if value explicitly not specified then true</i>
118  <p> If true, only translation are performed and orientation of the element is not changed.
119  </dd>
120
121<dt><b> onlyorientation </b></dt> 
122  <dd>
123  <i> logical, default false, if value explicitly not specified then true</i>
124  <p> If true, only rotations are performed and position of the element is not changed.
125  </dd>
126
127 
128<dt><b> autoplacedownstream </b></dt> 
129  <dd>
130  <i> logical, default true,    </i>
131  <p> if true all the elements downstream are placed at default positions in respect to the
132      moved element, if false the rest of the layout stays untouched.
133  </dd>
134
135
136<dt><b> surveyall </b></dt> 
137  <dd>
138  <i> logical, default true, if value explicitly not specified then true</i>
139  <p> If true, survey of all the line is performed after element placement at new position
140      and orientation. It is implemented mainly for the software debugging purposes.
141      If patching was performed correctly, the global survey should not change anything.
142  </dd>
143
144</dl>
145
146<h4>_  </h4>
147
148
149<!-- ############################################################ -->
150<!-- ############################################################ -->
151<!-- ############################################################ -->
152<h3> PROGRAMMERS MANUAL </h3>
153
154<p> 
155The command is implemented pro_ptc_eplacement function in madxn.c and
156by subroutine ptc_eplacement() in madx_ptc_eplacement.f90.
157<p>
158Sopecified range is resolved with help of get_range command. Number of the element in the current sequence
159is resolved and passed as the parameter to the fortran routine. It allows to resolve uniquely the corresponding
160element in the PTC layout.
161<p>
162TRANSLATE_Fibre and ROTATE_Fibre routines of ptc are employed to place and orient an element in space.
163These commands adds rotation and translation from the current position. Hence, if the specified reference frame is
164other then "current", the element firstly needs to be placed at the center of the reference frame and then it is
165moved about the user specified coordinates.
166<p>
167After element placement at new position and orientation patch needs to be recomputed. If autoplacedownstream
168is false then patch to the next element is also recomputed. Otherwise, the layout is surveyed from
169the next element on, what places all the elements downstream with default position with respect to the moved element.
170<p>
171At the end all the layout is surveyed, if surveyall flag is true, what normally should always take place.
172
173
174
175</div>
176
177</body>
178
179</html>
Note: See TracBrowser for help on using the repository browser.