Changes for page IDL cheat sheet

Last modified by fwilde on 2025/03/28 19:55

From version 48.1
edited by fwilde
on 2020/10/10 12:39
Change comment: There is no comment for this version
To version 26.1
edited by fwilde
on 2018/12/18 11:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,13 +1,15 @@
1 +This is an overview of the most commonly used commands during a beamtime.
2 +
1 1  == {{id name="IDLcheatsheet-Coordinatesystem"/}}Coordinate system ==
2 2  
3 3  Right-handed coordinate system with y-direction along the x-ray beam.
4 4  
7 +\\
8 +
5 5  [[image:attach:p05_uct.png||width="700"]]
6 6  
7 7  == {{id name="IDLcheatsheet-Samplepositioning"/}}Sample positioning ==
8 8  
9 -=== {{id name="IDLcheatsheet-Relativemovement"/}}Relative movement ===
10 -
11 11  (% class="wrapped fixed-table" %)
12 12  |=(((
13 13  IDL command
... ... @@ -17,7 +17,7 @@
17 17  motion
18 18  )))
19 19  |(((
20 -##**s_stage_x/z, 1**##
22 +s_stage_x/z, 1
21 21  )))|(((
22 22  move rotation stage in x/z-direction by 1 mm
23 23  )))|(((
... ... @@ -24,14 +24,14 @@
24 24  relative [ mm ]
25 25  )))
26 26  |(((
27 -##**s_pos_x/y/z, 1**##
29 +s_pos_z, 1
28 28  )))|(((
29 -move sample stage in x/y/z-direction by 1 mm (caution with directions: stage mount on rotation axis)
31 +move sample stage in z-direction by 1 mm,
30 30  )))|(((
31 31  relative [ mm ]
32 32  )))
33 33  |(((
34 -##**s_pos_lateral, 1**##
36 +s_pos_lateral, 1
35 35  )))|(((
36 36  move sample stage in x-direction by 1 mm, regardless of position of rotation axis
37 37  )))|(((
... ... @@ -38,16 +38,39 @@
38 38  relative [ mm ]
39 39  )))
40 40  |(((
41 -##**s_angle, 90**##
43 +s_angle, 90
42 42  )))|(((
43 43  rotate sample around z axis
44 44  )))|(((
45 45  relative [ deg ]
46 46  )))
49 +|(((
50 +s_in
51 +)))|(((
52 +move sample to "in" position
53 +)))|(((
54 +predefined
55 +)))
56 +|(((
57 +s_out
58 +)))|(((
59 +move sample to "out" position
60 +)))|(((
61 +predefined
62 +)))
63 +|(((
64 +s_change
65 +)))|(((
66 +move sample to "change" position
67 +)))|(((
68 +predefined
69 +)))
47 47  
48 -=== {{id name="IDLcheatsheet-Absolutemovement"/}}Absolute movement ===
71 +\\
49 49  
50 -(% class="relative-table wrapped" style="width: 67.0892%;" %)
73 +\\
74 +
75 +(% class="relative-table wrapped" style="width: 72.9307%;" %)
51 51  |=(((
52 52  IDL command
53 53  )))|=(((
... ... @@ -56,7 +56,7 @@
56 56  motion
57 57  )))
58 58  |(((
59 -##**goto_s_stage_x/z, 1**##
84 +goto_s_stage_x/z, 1
60 60  )))|(((
61 61  move rotation stage in x/z-direction to 1 mm
62 62  )))|(((
... ... @@ -63,7 +63,7 @@
63 63  absolute [ mm ]
64 64  )))
65 65  |(((
66 -##**goto_s_pos_x/y/z, 1**##
91 +goto_s_pos_x/y/z, 1
67 67  )))|(((
68 68  move sample stage in x/y/z-direction to 1  mm
69 69  )))|(((
... ... @@ -70,16 +70,14 @@
70 70  absolute [ mm ]
71 71  )))
72 72  |(((
73 -##**goto_s_angle, 90**##
98 +goto_s_angle, 90
74 74  )))|(((
75 -rotate sample around z axis to 90° (**alias command: s_rot**)
100 +rotate sample around z axis to 90°
76 76  )))|(((
77 77  absolute [ deg ]
78 78  )))
79 79  
80 -=== {{id name="IDLcheatsheet-Getcurrentposition"/}}Get current position ===
81 -
82 -(% class="relative-table wrapped" style="width: 54.0627%;" %)
105 +(% class="relative-table wrapped" style="width: 67.1421%;" %)
83 83  |=(((
84 84  IDL command
85 85  )))|=(((
... ... @@ -86,74 +86,21 @@
86 86  description
87 87  )))
88 88  |(((
89 -##**pos_s_stage_x/z()**##
112 +pos_s_stage_x/z()
90 90  )))|(((
91 91  return current rotation stage in x/z position
92 92  )))
93 93  |(((
94 -##**pos_s_pos_x/y/z()**##
117 +pos_s_pos_x/y/z()
95 95  )))|(((
96 96  return current sample stage in x/y/z position
97 97  )))
98 98  |(((
99 -##**pos_s_angle()**##
122 +pos_s_angle()
100 100  )))|(((
101 101  return current rotation stage angle
102 102  )))
103 103  
104 -=== {{id name="IDLcheatsheet-Predefinedpositions"/}}Predefined positions ===
105 -
106 -(% class="relative-table wrapped" style="width: 55.721%;" %)
107 -|=(((
108 -IDL command
109 -)))|=(((
110 -description
111 -)))
112 -|(((
113 -##**s_in**##
114 -)))|(((
115 -move sample to "in" position
116 -)))
117 -|(((
118 -##**s_out**##
119 -)))|(((
120 -move sample to "out" position
121 -)))
122 -|(((
123 -##**s_change**##
124 -)))|(((
125 -move sample to "change" position
126 -)))
127 -|(((
128 -##**set_s_in_pos, 0**##
129 -)))|(((
130 -set s_in position to 0.0 mm
131 -)))
132 -|(((
133 -##**set_s_out_dist, 10**##
134 -)))|(((
135 -set s_out distance to 10.0 mm
136 -)))
137 -
138 -=== {{id name="IDLcheatsheet-Magnificationsets"/}}Magnification sets ===
139 -
140 -(% class="wrapped" %)
141 -|=(((
142 -IDL command
143 -)))|=(((
144 -description
145 -)))
146 -|(((
147 -##**save_magn_set, 'dmm_11000ev_cmos_10x'**##
148 -)))|(((
149 -save current magnification set
150 -)))
151 -|(((
152 -##**restore_magn_set, 'dmm_11000ev_cmos_10x'**##
153 -)))|(((
154 -restore magnification set with the name 'dmm_11000ev_cmos_10x'
155 -)))
156 -
157 157  == {{id name="IDLcheatsheet-Detectorpositioning"/}}Detector positioning ==
158 158  
159 159  (% class="wrapped fixed-table" %)
... ... @@ -165,7 +165,7 @@
165 165  motion
166 166  )))
167 167  |(((
168 -##**pressure_on**##
138 +pressure_on
169 169  )))|(((
170 170  enable detector y movement
171 171  )))|(((
... ... @@ -172,7 +172,7 @@
172 172  \\
173 173  )))
174 174  |(((
175 -##**o_ccd_dist, 5**##
145 +o_ccd_dist, 5
176 176  )))|(((
177 177  move detector in y direction
178 178  )))|(((
... ... @@ -179,7 +179,7 @@
179 179  relative [ mm ]
180 180  )))
181 181  |(((
182 -##**pressure_off**##
152 +pressure_off
183 183  )))|(((
184 184  disable detector movement
185 185  )))|(((
... ... @@ -186,44 +186,8 @@
186 186  \\
187 187  )))
188 188  
189 -== {{id name="IDLcheatsheet-Slitpositioning"/}}Slit positioning ==
159 +== {{id name="IDLcheatsheet-Makeimage"/}}Make image ==
190 190  
191 -(% class="wrapped" %)
192 -|=(((
193 -IDL command
194 -)))|=(((
195 -description
196 -)))
197 -|(((
198 -##**slit_oh, rx=1 (rz=1)**##
199 -)))|(((
200 -moves oh slit aperture horizontally (vertically) by 1mm
201 -)))
202 -|(((
203 -##**slit_oh, rdx=1 (rdz=1)**##
204 -)))|(((
205 -opens oh the slit aperture horizontally (vertically) by 1 mm
206 -)))
207 -|(((
208 -##**slit_eh2, rx=1 (rz=1)**##
209 -)))|(((
210 -moves eh2 slit aperture horizontally (vertically) by 1 mm
211 -)))
212 -|(((
213 -##**slit_eh2, rdx=1 (rdz=1)**##
214 -)))|(((
215 -opens eh2 the slit aperture horizontally (vertically) by 1 mm
216 -)))
217 -|(((
218 -##**slit_info**##
219 -)))|(((
220 -show all slit positions
221 -)))
222 -
223 -rx, rdx, rz and rdz can be concatenated in one command (e.g. slit_oh, rx=1, rz=-2, rdx=0.5, rdz=0.5)
224 -
225 -== {{id name="IDLcheatsheet-Makeandsaveimages"/}}Make and save images ==
226 -
227 227  (% class="wrapped fixed-table" %)
228 228  |=(((
229 229  IDL command
... ... @@ -231,28 +231,17 @@
231 231  description
232 232  )))
233 233  |(((
234 -##**i=quick(100) & display_image, BYSTCL(i, 0, 4096)
235 -**##
168 +i=quick(100) & tv_quick, i & draw_box, [ x1, x2 ,z1 ,z2 ]
236 236  )))|(((
237 -make an image & scale image (eg. from 0 to 4096, usually from 0 to maximum value the camera can do)
170 +make an image & show image & draw box
238 238  )))
239 239  |(((
240 -##**a=quick_abs(100) & display_image, BYTSCL(a, 0, 2)**##
173 +a=quick_abs(100) & tv_quick, a & draw_box, [ x1, x2 ,z1 ,z2 ]
241 241  )))|(((
242 -make an absorption image & scale image (usually from 0 to to 2)
175 +make an absorption image & show image & draw box
243 243  )))
244 -|(((
245 -##**write_tiff, '/gpfs/current/raw/test_projection.tif', i, /SHORT**##
246 -)))|(((
247 -save i as 16-bit integer tiff in /gpfs/...
248 -)))
249 -|(((
250 -##**write_tiff, '/gpfs/current/raw/test_absorption.tif', a, /FLOAT**##
251 -)))|(((
252 -save a as 32-bit float tiff in /gpfs/...
253 -)))
254 254  
255 -== {{id name="IDLcheatsheet-DCMpositioning"/}}DCM positioning ==
178 +== {{id name="IDLcheatsheet-Monochromatorpositioning"/}}Monochromator positioning ==
256 256  
257 257  (% class="wrapped fixed-table" %)
258 258  |=(((
... ... @@ -263,39 +263,14 @@
263 263  motion
264 264  )))
265 265  |(((
266 -##**dcm_pitch, 0.00001**##
189 +calc_dcm_energy, 10000, /set
267 267  )))|(((
268 -move 2nd crystal pitch by 0.00001 deg
191 +set DCM and undulator to 10 keV
269 269  )))|(((
270 -relative [ deg ]
271 -)))
272 -|(((
273 -##**goto_dcm_pitch,  -0.03976**##
274 -)))|(((
275 -move 2nd crystal pitch to -0.03976 deg
276 -)))|(((
277 -absolute [ deg ]
278 -)))
279 -|(((
280 -##**reflex_opt**##
281 -)))|(((
282 -move 2nd crystal pitch to optimal flux position
283 -)))|(((
284 284  \\
285 285  )))
286 -
287 -== {{id name="IDLcheatsheet-DMMpositioning"/}}DMM positioning ==
288 -
289 -(% class="fixed-table wrapped" %)
290 -|=(((
291 -IDL command
292 -)))|=(((
293 -description
294 -)))|=(((
295 -motion
296 -)))
297 297  |(((
298 -##**dmm_x2_rot, 0.001**##
196 +dcm_pitch, 0.00001
299 299  )))|(((
300 300  move 2nd crystal pitch by 0.00001 deg
301 301  )))|(((
... ... @@ -302,96 +302,37 @@
302 302  relative [ deg ]
303 303  )))
304 304  |(((
305 -##**goto_dmm_x2_rot,  0.8923
306 -**##
203 +goto_dcm_pitch,  -0.03976
307 307  )))|(((
308 -move 2nd crystal pitch to 0.8923 deg
205 +move 2nd crystal pitch to -0.03976 deg
309 309  )))|(((
310 310  absolute [ deg ]
311 311  )))
312 -
313 -{{info title="Monochromator positioning"}}
314 -ATTENTION: Setting up a Monochromator as well as positioning front end slits is **only** done by the beamline staff!
315 -
316 -The commands above may be used by users to realign the beam should it beam profile drift with time.
317 -{{/info}}
318 -
319 -\\
320 -
321 -== {{id name="IDLcheatsheet-Generalsyntax"/}}General syntax ==
322 -
323 -(% class="wrapped relative-table" style="width: 45.5603%;" %)
324 -|=(((
325 -Functionality
326 -)))|=(((
327 -IDL syntax
328 -)))
329 329  |(((
330 -chaining commands
210 +reflex_opt
331 331  )))|(((
332 -command_1 **&** command_2 **&** ...
333 -)))
334 -|(((
335 -absolute movement
212 +move 2nd crystal pitch to optimal flux position
336 336  )))|(((
337 -**goto_**//motor//, position
214 +\\
338 338  )))
339 339  |(((
340 -relative movement
217 +gap, 0.01
341 341  )))|(((
342 -//motor//, position
343 -)))
344 -|(((
345 -current motor position
219 +move undulator gap by 0.01 mm
346 346  )))|(((
347 -**pos_**//motor//()
221 +relative [ mm ]
348 348  )))
349 349  
350 -== {{id name="IDLcheatsheet-BeamshutterandInterlockcontrol"/}}Beamshutter and Interlock control ==
224 +== {{id name="IDLcheatsheet-Saveanimageastiff"/}}Save an image as tiff ==
351 351  
352 -(% class="wrapped relative-table" style="width: 75.0455%;" %)
226 +(% class="wrapped" %)
353 353  |=(((
354 354  IDL command
355 355  )))|=(((
356 -description
230 +desciption
357 357  )))
358 358  |(((
359 -##**bs_info**##
233 +write_tiff, '/gpfs/current/raw/test.tif', i, /SHORT
360 360  )))|(((
361 -prints an overview of the beamline beamshutter status
235 +save i as 16-bit tiff in /gofs/...
362 362  )))
363 -|(((
364 -##**bsoh_open / bsoh_close**##
365 -)))|(((
366 -opens / closes the optics hutch beamshutter. Closing the OH beamshutter will close all following beamshutters (EH1, EH2)
367 -)))
368 -|(((
369 -##**bseh1_open / bseh1_close**##
370 -)))|(((
371 -opens / closes the EH1 beamshutter. Opening will open the OH beamshutter as well. Closing the OH beamshutter will the EH2 beamshutter as well
372 -)))
373 -|(((
374 -##**bseh2_open / bseh2_close**##
375 -)))|(((
376 -opens / closes the EH2 beamshutter. Openening will open the OH and EH1 beamshutters as well.
377 -)))
378 -|(((
379 -##**ics_info**##
380 -)))|(((
381 -prints an overview of the beamline interlock status
382 -)))
383 -|(((
384 -##**ics_break_oh**##
385 -)))|(((
386 -closes all P05 beamshutters and breaks OH door interlock. P06 beamshutter must be closed for this command to work!
387 -)))
388 -|(((
389 -##**ics_break_eh1**##
390 -)))|(((
391 -closes EH1 beamshutter (and EH2 beamshutter  if open) and breaks EH1 door interlock
392 -)))
393 -|(((
394 -##**ics_break_eh2**##
395 -)))|(((
396 -closes EH2 beshutter and breaks EH2 door interlock
397 -)))
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -179783464
1 +116602071
URL
... ... @@ -1,1 +1,1 @@
1 -https://confluence.desy.de/spaces/P5I/pages/179783464/IDL cheat sheet
1 +https://confluence.desy.de/spaces/P5I/pages/116602071/IDL cheat sheet