Changes for page IDL cheat sheet

Last modified by fwilde on 2025/03/28 19:55
From version 51.1
edited by fwilde
on 2023/02/21 18:15
Change comment: There is no comment for this version
To version 30.1
edited by fwilde
on 2018/12/18 12:12
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,3 +1,5 @@
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.
... ... @@ -6,8 +6,6 @@
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**##
20 +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**##
27 +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)
29 +move sample stage in z-direction by 1 mm,
30 30  )))|(((
31 31  relative [ mm ]
32 32  )))
33 33  |(((
34 -##**s_pos_lateral, 1**##
34 +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,35 @@
38 38  relative [ mm ]
39 39  )))
40 40  |(((
41 -##**s_angle, 90**##
41 +s_angle, 90
42 42  )))|(((
43 43  rotate sample around z axis
44 44  )))|(((
45 45  relative [ deg ]
46 46  )))
47 +|(((
48 +s_in
49 +)))|(((
50 +move sample to "in" position
51 +)))|(((
52 +predefined
53 +)))
54 +|(((
55 +s_out
56 +)))|(((
57 +move sample to "out" position
58 +)))|(((
59 +predefined
60 +)))
61 +|(((
62 +s_change
63 +)))|(((
64 +move sample to "change" position
65 +)))|(((
66 +predefined
67 +)))
47 47  
48 -=== {{id name="IDLcheatsheet-Absolutemovement"/}}Absolute movement ===
49 -
50 -(% class="relative-table wrapped" style="width: 67.0892%;" %)
69 +(% class="relative-table wrapped" style="width: 63.4026%;" %)
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**##
78 +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**##
85 +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**##
92 +goto_s_angle, 90
74 74  )))|(((
75 -rotate sample around z axis to 90° (**alias command: s_rot**)
94 +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%;" %)
99 +(% class="relative-table wrapped" style="width: 51.477%;" %)
83 83  |=(((
84 84  IDL command
85 85  )))|=(((
... ... @@ -86,76 +86,21 @@
86 86  description
87 87  )))
88 88  |(((
89 -##**pos_s_stage_x/z()**##
106 +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()**##
111 +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()**##
116 +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(, name_add)
148 -**##
149 -)))|(((
150 -save current magnification set, optionally add something to the automatically generated name
151 -)))
152 -|(((
153 -##**restore_magn_set(, name)
154 -**##
155 -)))|(((
156 -restore last magnification set, or optionally load a file with a specific name
157 -)))
158 -
159 159  == {{id name="IDLcheatsheet-Detectorpositioning"/}}Detector positioning ==
160 160  
161 161  (% class="wrapped fixed-table" %)
... ... @@ -167,30 +167,30 @@
167 167  motion
168 168  )))
169 169  |(((
170 -##**o_ccd_dist, 5**##
132 +pressure_on
171 171  )))|(((
172 -move detector in y direction relative by 5 mm
134 +enable detector y movement
173 173  )))|(((
174 -relative [ mm ]
136 +\\
175 175  )))
176 176  |(((
177 -##**goto_o_ccd_dist, 30**##
139 +o_ccd_dist, 5
178 178  )))|(((
179 -move detector in y direction absoilute to 30 mm
141 +move detector in y direction
180 180  )))|(((
181 -\\
143 +relative [ mm ]
182 182  )))
183 183  |(((
184 -##**pos_o_ccd_dist()**##
146 +pressure_off
185 185  )))|(((
186 -return current of the camera stage distance
148 +disable detector movement
187 187  )))|(((
188 188  \\
189 189  )))
190 190  
191 -== {{id name="IDLcheatsheet-Slitpositioning"/}}Slit positioning ==
153 +== {{id name="IDLcheatsheet-Makeimage"/}}Make image ==
192 192  
193 -(% class="wrapped" %)
155 +(% class="wrapped fixed-table" %)
194 194  |=(((
195 195  IDL command
196 196  )))|=(((
... ... @@ -197,85 +197,35 @@
197 197  description
198 198  )))
199 199  |(((
200 -##**slit_oh, rx=1 (rz=1)**##
162 +i=quick(100) & tv_quick, i & draw_box, [ x1, x2 ,z1 ,z2 ]
201 201  )))|(((
202 -moves oh slit aperture horizontally (vertically) by 1mm
164 +make an image & show image & draw box
203 203  )))
204 204  |(((
205 -##**slit_oh, rdx=1 (rdz=1)**##
167 +a=quick_abs(100) & tv_quick, a & draw_box, [ x1, x2 ,z1 ,z2 ]
206 206  )))|(((
207 -opens oh the slit aperture horizontally (vertically) by 1 mm
169 +make an absorption image & show image & draw box
208 208  )))
209 -|(((
210 -##**slit_eh2, rx=1 (rz=1)**##
211 -)))|(((
212 -moves eh2 slit aperture horizontally (vertically) by 1 mm
213 -)))
214 -|(((
215 -##**slit_eh2, rdx=1 (rdz=1)**##
216 -)))|(((
217 -opens eh2 the slit aperture horizontally (vertically) by 1 mm
218 -)))
219 -|(((
220 -##**slit_info**##
221 -)))|(((
222 -show all slit positions
223 -)))
224 224  
225 -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)
172 +== {{id name="IDLcheatsheet-Monochromatorpositioning"/}}Monochromator positioning ==
226 226  
227 -== {{id name="IDLcheatsheet-Makeandsaveimages"/}}Make and save images ==
228 -
229 229  (% class="wrapped fixed-table" %)
230 230  |=(((
231 231  IDL command
232 232  )))|=(((
233 233  description
179 +)))|=(((
180 +motion
234 234  )))
235 235  |(((
236 -##**i=quick(100) & display_image, BYSTCL(i, 0, 4096)
237 -**##
183 +calc_dcm_energy, 10000, /set
238 238  )))|(((
239 -make an image & scale image (eg. from 0 to 4096, usually from 0 to maximum value the camera can do)
240 -)))
241 -|(((
242 -##**a=quick_abs(100) & display_image, BYTSCL(a, 0, 2)**##
185 +set DCM and undulator to 10 keV
243 243  )))|(((
244 -make an absorption image & scale image (usually from 0 to to 2)
245 -)))
246 -|(((
247 -##**write_tiff, '/gpfs/current/raw/test_projection.tif', i, /SHORT**##
248 -)))|(((
249 -save i as 16-bit integer tiff in /gpfs/...
250 -)))
251 -|(((
252 -##**write_tiff, '/gpfs/current/raw/test_absorption.tif', a, /FLOAT**##
253 -)))|(((
254 -save a as 32-bit float tiff in /gpfs/...
255 -)))
256 -
257 257  \\
258 -
259 -\\
260 -
261 -{{info title="Monochromator positioning"}}
262 -ATTENTION: Setting up a Monochromator as well as positioning front end slits is **only** done by the beamline staff!
263 -
264 -The commands above may be used by users to realign the beam should it beam profile drift with time.
265 -{{/info}}
266 -
267 -== {{id name="IDLcheatsheet-DCMpositioning"/}}DCM positioning ==
268 -
269 -(% class="wrapped fixed-table" %)
270 -|=(((
271 -IDL command
272 -)))|=(((
273 -description
274 -)))|=(((
275 -motion
276 276  )))
277 277  |(((
278 -##**dcm_pitch, 0.00001**##
190 +dcm_pitch, 0.00001
279 279  )))|(((
280 280  move 2nd crystal pitch by 0.00001 deg
281 281  )))|(((
... ... @@ -282,7 +282,7 @@
282 282  relative [ deg ]
283 283  )))
284 284  |(((
285 -##**goto_dcm_pitch,  -0.03976**##
197 +goto_dcm_pitch,  -0.03976
286 286  )))|(((
287 287  move 2nd crystal pitch to -0.03976 deg
288 288  )))|(((
... ... @@ -289,44 +289,37 @@
289 289  absolute [ deg ]
290 290  )))
291 291  |(((
292 -##**reflex_opt_single**##
204 +reflex_opt
293 293  )))|(((
294 294  move 2nd crystal pitch to optimal flux position
295 295  )))|(((
296 296  \\
297 297  )))
210 +|(((
211 +gap, 0.01
212 +)))|(((
213 +move undulator gap by 0.01 mm
214 +)))|(((
215 +relative [ mm ]
216 +)))
298 298  
299 -== {{id name="IDLcheatsheet-DMMpositioning"/}}DMM positioning ==
218 +== {{id name="IDLcheatsheet-Saveanimageastiff"/}}Save an image as tiff ==
300 300  
301 -(% class="fixed-table wrapped" %)
220 +(% class="wrapped relative-table" style="width: 60.1204%;" %)
302 302  |=(((
303 303  IDL command
304 304  )))|=(((
305 -description
306 -)))|=(((
307 -motion
224 +desciption
308 308  )))
309 309  |(((
310 -##**dmm_x2_rot, 0.001**##
227 +write_tiff, '/gpfs/current/raw/test.tif', i, /SHORT
311 311  )))|(((
312 -move 2nd crystal pitch by 0.00001 deg
313 -)))|(((
314 -relative [ deg ]
229 +save i as 16-bit tiff in /gofs/...
315 315  )))
316 -|(((
317 -##**goto_dmm_x2_rot,  0.8923
318 -**##
319 -)))|(((
320 -move 2nd crystal pitch to 0.8923 deg
321 -)))|(((
322 -absolute [ deg ]
323 -)))
324 324  
325 -\\
232 +== {{id name="IDLcheatsheet-Generalremarks"/}}General remarks ==
326 326  
327 -== {{id name="IDLcheatsheet-Generalsyntax"/}}General syntax ==
328 -
329 -(% class="wrapped relative-table" style="width: 45.5603%;" %)
234 +(% class="wrapped relative-table" style="width: 51.5317%;" %)
330 330  |=(((
331 331  Functionality
332 332  )))|=(((
... ... @@ -333,7 +333,7 @@
333 333  IDL syntax
334 334  )))
335 335  |(((
336 -chaining commands
241 +Chaining commands
337 337  )))|(((
338 338  command_1 **&** command_2 **&** ...
339 339  )))
... ... @@ -352,52 +352,3 @@
352 352  )))|(((
353 353  **pos_**//motor//()
354 354  )))
355 -
356 -== {{id name="IDLcheatsheet-BeamshutterandInterlockcontrol"/}}Beamshutter and Interlock control ==
357 -
358 -(% class="wrapped relative-table" style="width: 75.0455%;" %)
359 -|=(((
360 -IDL command
361 -)))|=(((
362 -description
363 -)))
364 -|(((
365 -##**bs_info**##
366 -)))|(((
367 -prints an overview of the beamline beamshutter status
368 -)))
369 -|(((
370 -##**bsoh_open / bsoh_close**##
371 -)))|(((
372 -opens / closes the optics hutch beamshutter. Closing the OH beamshutter will close all following beamshutters (EH1, EH2)
373 -)))
374 -|(((
375 -##**bseh1_open / bseh1_close**##
376 -)))|(((
377 -opens / closes the EH1 beamshutter. Opening will open the OH beamshutter as well. Closing the OH beamshutter will the EH2 beamshutter as well
378 -)))
379 -|(((
380 -##**bseh2_open / bseh2_close**##
381 -)))|(((
382 -opens / closes the EH2 beamshutter. Openening will open the OH and EH1 beamshutters as well.
383 -)))
384 -|(((
385 -##**ics_info**##
386 -)))|(((
387 -prints an overview of the beamline interlock status
388 -)))
389 -|(((
390 -##**oh_break_ics**##
391 -)))|(((
392 -closes all P05 beamshutters and breaks OH door interlock. P06 beamshutter must be closed for this command to work!
393 -)))
394 -|(((
395 -##**eh1_break_ics**##
396 -)))|(((
397 -closes EH1 beamshutter (and EH2 beamshutter  if open) and breaks EH1 door interlock
398 -)))
399 -|(((
400 -##**eh2_break_ics**##
401 -)))|(((
402 -closes EH2 beshutter and breaks EH2 door interlock
403 -)))
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -297508007
1 +116602099
URL
... ... @@ -1,1 +1,1 @@
1 -https://confluence.desy.de/spaces/P5I/pages/297508007/IDL cheat sheet
1 +https://confluence.desy.de/spaces/P5I/pages/116602099/IDL cheat sheet