Changes for page IDL cheat sheet

Last modified by fwilde on 2025/03/28 19:55
From version 57.1
edited by fwilde
on 2024/06/13 14:51
Change comment: There is no comment for this version
To version 45.1
edited by fwilde
on 2020/10/10 12:16
Change comment: Reverted from v. 43

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -== {{id name="IDLcheatsheet-eCoordinatesystem"/}}eCoordinate system ==
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  
... ... @@ -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,7 +24,7 @@
24 24  relative [ mm ]
25 25  )))
26 26  |(((
27 -##**s_pos_x/y/z, 1**##
27 +s_pos_x/y/z, 1
28 28  )))|(((
29 29  move sample stage in x/y/z-direction by 1 mm (caution with directions: stage mount on rotation axis)
30 30  )))|(((
... ... @@ -31,7 +31,7 @@
31 31  relative [ mm ]
32 32  )))
33 33  |(((
34 -##**s_pos, 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,7 +38,7 @@
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  )))|(((
... ... @@ -47,7 +47,7 @@
47 47  
48 48  === {{id name="IDLcheatsheet-Absolutemovement"/}}Absolute movement ===
49 49  
50 -(% class="relative-table wrapped" style="width: 67.0892%;" %)
50 +(% 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**##
59 +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**##
66 +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,9 +70,9 @@
70 70  absolute [ mm ]
71 71  )))
72 72  |(((
73 -##**goto_s_angle, 90**##
73 +goto_s_angle, 90
74 74  )))|(((
75 -rotate sample around z axis to 90° (**alias command: s_rot**)
75 +rotate sample around z axis to 90° (alias command: s_rot)
76 76  )))|(((
77 77  absolute [ deg ]
78 78  )))
... ... @@ -79,7 +79,7 @@
79 79  
80 80  === {{id name="IDLcheatsheet-Getcurrentposition"/}}Get current position ===
81 81  
82 -(% class="relative-table wrapped" style="width: 54.0627%;" %)
82 +(% class="relative-table wrapped" style="width: 51.477%;" %)
83 83  |=(((
84 84  IDL command
85 85  )))|=(((
... ... @@ -86,17 +86,17 @@
86 86  description
87 87  )))
88 88  |(((
89 -##**pos_s_stage_x/z()**##
89 +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()**##
94 +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()**##
99 +pos_s_angle()
100 100  )))|(((
101 101  return current rotation stage angle
102 102  )))
... ... @@ -110,27 +110,27 @@
110 110  description
111 111  )))
112 112  |(((
113 -##**s_in**##
113 +s_in
114 114  )))|(((
115 115  move sample to "in" position
116 116  )))
117 117  |(((
118 -##**s_out**##
118 +s_out
119 119  )))|(((
120 120  move sample to "out" position
121 121  )))
122 122  |(((
123 -##**s_change**##
123 +s_change
124 124  )))|(((
125 125  move sample to "change" position
126 126  )))
127 127  |(((
128 -##**set_s_in_pos(, 0)**##
128 +set_s_in_pos, 0
129 129  )))|(((
130 -set s_in position to current stage position, or optionally to e.g. 0.0 mm
130 +set s_in position to 0.0 mm
131 131  )))
132 132  |(((
133 -##**set_s_out_dist, 10**##
133 +set_s_out_dist, 10
134 134  )))|(((
135 135  set s_out distance to 10.0 mm
136 136  )))
... ... @@ -144,16 +144,14 @@
144 144  description
145 145  )))
146 146  |(((
147 -##**save_magn_set(, name_add)
148 -**##
147 +save_magn_set, 'dmm_11000ev_cmos_10x'
149 149  )))|(((
150 -save current magnification set, optionally add something to the automatically generated name
149 +save current magnification set
151 151  )))
152 152  |(((
153 -##**restore_magn_set(, name)
154 -**##
152 +restore_magn_set, 'dmm_11000ev_cmos_10x'
155 155  )))|(((
156 -restore last magnification set, or optionally load a file with a specific name
154 +restore magnification set with the name 'dmm_11000ev_cmos_10x'
157 157  )))
158 158  
159 159  == {{id name="IDLcheatsheet-Detectorpositioning"/}}Detector positioning ==
... ... @@ -167,23 +167,23 @@
167 167  motion
168 168  )))
169 169  |(((
170 -##**o_ccd_dist, 5**##
168 +pressure_on
171 171  )))|(((
172 -move detector in y direction relative by 5 mm
170 +enable detector y movement
173 173  )))|(((
174 -relative [ mm ]
172 +\\
175 175  )))
176 176  |(((
177 -##**goto_o_ccd_dist, 30**##
175 +o_ccd_dist, 5
178 178  )))|(((
179 -move detector in y direction absoilute to 30 mm
177 +move detector in y direction
180 180  )))|(((
181 -\\
179 +relative [ mm ]
182 182  )))
183 183  |(((
184 -##**pos_o_ccd_dist()**##
182 +pressure_off
185 185  )))|(((
186 -return current of the camera stage distance
184 +disable detector movement
187 187  )))|(((
188 188  \\
189 189  )))
... ... @@ -197,34 +197,24 @@
197 197  description
198 198  )))
199 199  |(((
200 -##**slit_oh, rx=1 (rz=1)**##
198 +slit_eh2, rx=1 (rz=1)
201 201  )))|(((
202 -moves oh slit aperture horizontally (vertically) by 1mm
200 +moves eh2 slit aperture horizontally (vertically) by 1mm , **works analoguous for slit_oh and slit_ps2**
203 203  )))
204 204  |(((
205 -##**slit_oh, rdx=1 (rdz=1)**##
203 +slit_eh2, rdz=1 (rdz=1)
206 206  )))|(((
207 -opens oh the slit aperture horizontally (vertically) by 1 mm
205 +opens eh2 the slit aperture horizontally (vertically) by 1 mm, **works analoguous for slit_oh and slit_ps2**
208 208  )))
209 209  |(((
210 -##**slit_eh2, rx=1 (rz=1)**##
208 +slit_info
211 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 222  show all slit positions
223 223  )))
224 224  
225 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)
226 226  
227 -== {{id name="IDLcheatsheet-Makeandsaveimages"/}}Make and save images ==
215 +== {{id name="IDLcheatsheet-Makeimages"/}}Make images ==
228 228  
229 229  (% class="wrapped fixed-table" %)
230 230  |=(((
... ... @@ -233,100 +233,40 @@
233 233  description
234 234  )))
235 235  |(((
236 -##**i=quick(100) & display_image, BYSTCL(i, 0, 4096)
237 -**##
224 +i=quick(100) & tv_quick, i & draw_box, [ x1, x2 ,z1 ,z2 ]
238 238  )))|(((
239 -make an image & scale image (eg. from 0 to 4096, usually from 0 to maximum value the camera can do)
226 +make an image & show image & draw box
240 240  )))
241 241  |(((
242 -##**a=quick_abs(100) & display_image, BYTSCL(a, 0, 2)**##
229 +a=quick_abs(100) & tv_quick, a & draw_box, [ x1, x2 ,z1 ,z2 ]
243 243  )))|(((
244 -make an absorption image & scale image (usually from 0 to to 2)
231 +make an absorption image & show image & draw box
245 245  )))
246 246  |(((
247 -##**write_tiff, '/gpfs/current/raw/test_projection.tif', i, /SHORT**##
234 +write_tiff, '/gpfs/current/raw/test.tif', i, /SHORT
248 248  )))|(((
249 -save i as 16-bit integer tiff in /gpfs/...
236 +save i as 16-bit tiff in /gpfs/...
250 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 256  
257 -== {{id name="IDLcheatsheet-Macrosmotion+images"/}}Macros motion  + images ==
239 +== {{id name="IDLcheatsheet-Monochromatorpositioning"/}}Monochromator positioning ==
258 258  
259 -These macros make images with predefined and internally saved values (like exposure time or display scale). Some move an axis first and then make an image (again with internally saved options likeexposure time, and image type). **Use these macros to quickly align you samples.**
260 -
261 -(% class="relative-table wrapped" style="width: 114.69%;" %)
241 +(% class="wrapped fixed-table" %)
262 262  |=(((
263 263  IDL command
264 264  )))|=(((
265 265  description
246 +)))|=(((
247 +motion
266 266  )))
267 267  |(((
268 -**{{code language="none"}}qt (, t=100, scale=[0,4096]){{/code}}**
250 +calc_dcm_energy, 10000, /set
269 269  )))|(((
270 -Quick **transmission** image at the current position. Options: set new exposure time, set new scale for image display,
271 -)))
272 -|(((
273 -**{{code language="none"}}qa (, t=100, scale=[0,2], /ref, /here){{/code}}**
252 +set DCM and undulator to 10 keV
274 274  )))|(((
275 -Quick **absorption** image at s_in position. Options: set new exposure time, set new scale for image display, make new reference image, make image at current position.
276 -)))
277 -|(((
278 -**{{code language="none"}}qp (, t=100, scale=[0,2], /ref, /here){{/code}}**
279 -)))|(((
280 -Quick **phase** image at s_in position. Options: set new exposure time, set new scale for image display, make new reference image, make image at current position
281 -)))
282 -|(((
283 -**{{code language="none"}}qr (, t=100, scale=[0,4096]){{/code}}
284 -**
285 -)))|(((
286 -Quick **reference image**. Options: set new exposure time,  set new scale for image display,
287 -)))
288 -|(((
289 -**{{code language="none"}}side, 90 (, t=100, /ref, /rel, /here, imgtype='a') {{/code}}**
290 -)))|(((
291 -**Rotate** (absolute degrees) and make an image at the new position. Options: set new exposure time, make new reference image, make image at current position, set image type ('a': absorption, 't': transmission, 'p' phase)
292 -)))
293 -|(((
294 -**{{code language="none"}}sshift, 2 (, t=100, /ref, /here, imgtype='a'){{/code}}**
295 -)))|(((
296 -Move **sample stage laterally** (relative, mm) and make an image at the new position. Options: set exposure time, make new reference image, , make image at current position, set image type ('a': absorption, 't': transmission, 'p' phase)
297 -)))
298 -|(((
299 -##**sz, 2 (, t=100, /ref, /here, imgtype='a')**##
300 -)))|(((
301 -Move **rotation stage up or down** (relative, mm) and make an image at the new position. Options: set exposure time, make reference image, make image at current position, set image type ('a': absorption, 't': transmission, 'p' phase)
302 -)))
303 -|(((
304 -**{{code language="none"}}zx, 2 (, t=100, /ref, /here, imgtype='a'){{/code}}
305 -**
306 -)))|(((
307 -Move **rotation stage left or right** (relative, mm) and make an image at the new position. Options: set exposure time, make reference image, make image at current position, set image type ('a': absorption, 't': transmission, 'p' phase)
308 -)))
309 -
310 310  \\
311 -
312 -{{info title="Monochromator positioning"}}
313 -ATTENTION: Setting up a Monochromator as well as positioning front end slits is **only** done by the beamline staff!
314 -
315 -The commands above may be used by users to realign the beam should it beam profile drift with time.
316 -{{/info}}
317 -
318 -== {{id name="IDLcheatsheet-DCMpositioning"/}}DCM positioning ==
319 -
320 -(% class="wrapped fixed-table" %)
321 -|=(((
322 -IDL command
323 -)))|=(((
324 -description
325 -)))|=(((
326 -motion
327 327  )))
328 328  |(((
329 -##**dcm_pitch, 0.00001**##
257 +dcm_pitch, 0.00001
330 330  )))|(((
331 331  move 2nd crystal pitch by 0.00001 deg
332 332  )))|(((
... ... @@ -333,7 +333,7 @@
333 333  relative [ deg ]
334 334  )))
335 335  |(((
336 -##**goto_dcm_pitch,  -0.03976**##
264 +goto_dcm_pitch,  -0.03976
337 337  )))|(((
338 338  move 2nd crystal pitch to -0.03976 deg
339 339  )))|(((
... ... @@ -340,44 +340,23 @@
340 340  absolute [ deg ]
341 341  )))
342 342  |(((
343 -##**reflex_opt_single**##
271 +reflex_opt
344 344  )))|(((
345 345  move 2nd crystal pitch to optimal flux position
346 346  )))|(((
347 347  \\
348 348  )))
349 -
350 -== {{id name="IDLcheatsheet-DMMpositioning"/}}DMM positioning ==
351 -
352 -(% class="fixed-table wrapped" %)
353 -|=(((
354 -IDL command
355 -)))|=(((
356 -description
357 -)))|=(((
358 -motion
359 -)))
360 360  |(((
361 -##**dmm_x2_rot, 0.001**##
278 +gap, 0.01
362 362  )))|(((
363 -move 2nd crystal pitch by 0.00001 deg
280 +move undulator gap by 0.01 mm
364 364  )))|(((
365 -relative [ deg ]
282 +relative [ mm ]
366 366  )))
367 -|(((
368 -##**goto_dmm_x2_rot,  0.8923
369 -**##
370 -)))|(((
371 -move 2nd crystal pitch to 0.8923 deg
372 -)))|(((
373 -absolute [ deg ]
374 -)))
375 375  
376 -\\
377 -
378 378  == {{id name="IDLcheatsheet-Generalsyntax"/}}General syntax ==
379 379  
380 -(% class="wrapped relative-table" style="width: 45.5603%;" %)
287 +(% class="wrapped relative-table" style="width: 51.5317%;" %)
381 381  |=(((
382 382  Functionality
383 383  )))|=(((
... ... @@ -384,7 +384,7 @@
384 384  IDL syntax
385 385  )))
386 386  |(((
387 -chaining commands
294 +Chaining commands
388 388  )))|(((
389 389  command_1 **&** command_2 **&** ...
390 390  )))
... ... @@ -406,7 +406,7 @@
406 406  
407 407  == {{id name="IDLcheatsheet-BeamshutterandInterlockcontrol"/}}Beamshutter and Interlock control ==
408 408  
409 -(% class="wrapped relative-table" style="width: 75.0455%;" %)
316 +(% class="wrapped" %)
410 410  |=(((
411 411  IDL command
412 412  )))|=(((
... ... @@ -413,93 +413,42 @@
413 413  description
414 414  )))
415 415  |(((
416 -##**bs_info**##
323 +bs_info
417 417  )))|(((
418 418  prints an overview of the beamline beamshutter status
419 419  )))
420 420  |(((
421 -##**bsoh_open / bsoh_close**##
328 +bsoh_open / bsoh_close
422 422  )))|(((
423 423  opens / closes the optics hutch beamshutter. Closing the OH beamshutter will close all following beamshutters (EH1, EH2)
424 424  )))
425 425  |(((
426 -##**bseh1_open / bseh1_close**##
333 +bseh1_open / bseh1_close
427 427  )))|(((
428 428  opens / closes the EH1 beamshutter. Opening will open the OH beamshutter as well. Closing the OH beamshutter will the EH2 beamshutter as well
429 429  )))
430 430  |(((
431 -##**bseh2_open / bseh2_close**##
338 +bseh2_open / bseh2_close
432 432  )))|(((
433 433  opens / closes the EH2 beamshutter. Openening will open the OH and EH1 beamshutters as well.
434 434  )))
435 435  |(((
436 -##**ics_info**##
343 +ics_info
437 437  )))|(((
438 438  prints an overview of the beamline interlock status
439 439  )))
440 440  |(((
441 -##**oh_break_ics**##
348 +ics_break_oh
442 442  )))|(((
443 443  closes all P05 beamshutters and breaks OH door interlock. P06 beamshutter must be closed for this command to work!
444 444  )))
445 445  |(((
446 -##**eh1_break_ics**##
353 +ics_break_eh1
447 447  )))|(((
448 448  closes EH1 beamshutter (and EH2 beamshutter  if open) and breaks EH1 door interlock
449 449  )))
450 450  |(((
451 -##**eh2_break_ics**##
358 +ics_break_eh2
452 452  )))|(((
453 453  closes EH2 beshutter and breaks EH2 door interlock
454 454  )))
455 -
456 -== {{id name="IDLcheatsheet-Helpermacros"/}}Helper macros ==
457 -
458 -The helper macros may help to align a sample quickly. Mainly, these are motion commands which subsequently make an image with predefined values.
459 -
460 -(% class="wrapped" %)
461 -|=(((
462 -IDL command
463 -)))|=(((
464 -description
465 -)))
466 -|(((
467 -helper_object, /info
468 -)))|(((
469 -show predefined values
470 -)))
471 -|(((
472 -\\
473 -)))|(((
474 -\\
475 -)))
476 -|(((
477 -\\
478 -)))|(((
479 -\\
480 -)))
481 -|(((
482 -\\
483 -)))|(((
484 -\\
485 -)))
486 -|(((
487 -\\
488 -)))|(((
489 -\\
490 -)))
491 -|(((
492 -\\
493 -)))|(((
494 -\\
495 -)))
496 -|(((
497 -\\
498 -)))|(((
499 -\\
500 -)))
501 -|(((
502 -\\
503 -)))|(((
504 -\\
505 -)))
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -365835135
1 +179783453
URL
... ... @@ -1,1 +1,1 @@
1 -https://confluence.desy.de/spaces/P5I/pages/365835135/IDL cheat sheet
1 +https://confluence.desy.de/spaces/P5I/pages/179783453/IDL cheat sheet