Changes for page IDL cheat sheet

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

From version 41.1
edited by fwilde
on 2019/08/08 14:07
Change comment: There is no comment for this version
To version 59.2
edited by fwilde
on 2025/03/28 19:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  === {{id name="IDLcheatsheet-Relativemovement"/}}Relative movement ===
10 10  
11 -(% class="wrapped fixed-table" %)
11 +(% class="fixed-table wrapped" %)
12 12  |=(((
13 13  IDL command
14 14  )))|=(((
... ... @@ -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_lateral, 1
34 +##**s_pos, 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: 63.4026%;" %)
50 +(% class="relative-table wrapped" style="width:67.0892%" %)
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: 51.477%;" %)
82 +(% class="relative-table wrapped" style="width:54.0627%" %)
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  )))
... ... @@ -103,7 +103,7 @@
103 103  
104 104  === {{id name="IDLcheatsheet-Predefinedpositions"/}}Predefined positions ===
105 105  
106 -(% class="relative-table wrapped" style="width: 55.721%;" %)
106 +(% class="relative-table wrapped" style="width:55.721%" %)
107 107  |=(((
108 108  IDL command
109 109  )))|=(((
... ... @@ -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 0.0 mm
130 +set s_in position to current stage position, or optionally to e.g. 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,19 +144,19 @@
144 144  description
145 145  )))
146 146  |(((
147 -save_magn_set, 'dmm_11000ev_cmos_10x'
147 +##**save_magn_set(, name_add)**##
148 148  )))|(((
149 -save current magnification set
149 +save current magnification set, optionally add something to the automatically generated name
150 150  )))
151 151  |(((
152 -restore_magn_set, 'dmm_11000ev_cmos_10x'
152 +##**restore_magn_set(, name)**##
153 153  )))|(((
154 -restore magnification set with the name 'dmm_11000ev_cmos_10x'
154 +restore last magnification set, or optionally load a file with a specific name
155 155  )))
156 156  
157 157  == {{id name="IDLcheatsheet-Detectorpositioning"/}}Detector positioning ==
158 158  
159 -(% class="wrapped fixed-table" %)
159 +(% class="fixed-table wrapped" %)
160 160  |=(((
161 161  IDL command
162 162  )))|=(((
... ... @@ -165,25 +165,25 @@
165 165  motion
166 166  )))
167 167  |(((
168 -pressure_on
168 +##**o_ccd_dist, 5**##
169 169  )))|(((
170 -enable detector y movement
170 +move detector in y direction relative by 5 mm
171 171  )))|(((
172 -\\
172 +relative [ mm ]
173 173  )))
174 174  |(((
175 -o_ccd_dist, 5
175 +##**goto_o_ccd_dist, 30**##
176 176  )))|(((
177 -move detector in y direction
177 +move detector in y direction absoilute to 30 mm
178 178  )))|(((
179 -relative [ mm ]
179 +
180 180  )))
181 181  |(((
182 -pressure_off
182 +##**pos_o_ccd_dist()**##
183 183  )))|(((
184 -disable detector movement
184 +return current of the camera stage distance
185 185  )))|(((
186 -\\
186 +
187 187  )))
188 188  
189 189  == {{id name="IDLcheatsheet-Slitpositioning"/}}Slit positioning ==
... ... @@ -195,26 +195,36 @@
195 195  description
196 196  )))
197 197  |(((
198 -slit_eh2, rx=1 (rz=1)
198 +##**slit_oh, rx=1 (rz=1)**##
199 199  )))|(((
200 -moves eh2 slit aperture horizontally (vertically) by 1mm , **works analoguous for slit_oh and slit_ps2**
200 +moves oh slit aperture horizontally (vertically) by 1mm
201 201  )))
202 202  |(((
203 -slit_eh2, rdz=1 (rdz=1)
203 +##**slit_oh, rdx=1 (rdz=1)**##
204 204  )))|(((
205 -opens eh2 the slit aperture horizontally (vertically) by 1 mm, **works analoguous for slit_oh and slit_ps2**
205 +opens oh the slit aperture horizontally (vertically) by 1 mm
206 206  )))
207 207  |(((
208 -slit_info
208 +##**slit_eh2, rx=1 (rz=1)**##
209 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 +)))|(((
210 210  show all slit positions
211 211  )))
212 212  
213 213  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)
214 214  
215 -== {{id name="IDLcheatsheet-Makeimages"/}}Make images ==
225 +== {{id name="IDLcheatsheet-Makeandsaveimages"/}}Make and save images ==
216 216  
217 -(% class="wrapped fixed-table" %)
227 +(% class="fixed-table wrapped" %)
218 218  |=(((
219 219  IDL command
220 220  )))|=(((
... ... @@ -221,47 +221,105 @@
221 221  description
222 222  )))
223 223  |(((
224 -i=quick(100) & tv_quick, i & draw_box, [ x1, x2 ,z1 ,z2 ]
234 +##**i=quick(100) & display_image, BYSTCL(i, 0, 4096)**##
225 225  )))|(((
226 -make an image & show image & draw box
236 +make an image & scale image (eg. from 0 to 4096, usually from 0 to maximum value the camera can do)
227 227  )))
228 228  |(((
229 -a=quick_abs(100) & tv_quick, a & draw_box, [ x1, x2 ,z1 ,z2 ]
239 +##**a=quick_abs(100) & display_image, BYTSCL(a, 0, 2)**##
230 230  )))|(((
231 -make an absorption image & show image & draw box
241 +make an absorption image & scale image (usually from 0 to to 2)
232 232  )))
233 233  |(((
234 -write_tiff, '/gpfs/current/raw/test.tif', i, /SHORT
244 +##**write_tiff, '/gpfs/current/raw/test_projection.tif', i, /SHORT**##
235 235  )))|(((
236 -save i as 16-bit tiff in /gpfs/...
246 +save i as 16-bit integer tiff in /gpfs/...
237 237  )))
248 +|(((
249 +##**write_tiff, '/gpfs/current/raw/test_absorption.tif', a, /FLOAT**##
250 +)))|(((
251 +save a as 32-bit float tiff in /gpfs/...
252 +)))
238 238  
239 -== {{id name="IDLcheatsheet-Monochromatorpositioning"/}}Monochromator positioning ==
254 +== {{id name="IDLcheatsheet-Macrosmotion+images"/}}Macros motion  + images ==
240 240  
241 -(% class="wrapped fixed-table" %)
256 +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). **You may use these macros to quickly align samples.**
257 +
258 +(% class="relative-table wrapped" style="width:114.69%" %)
242 242  |=(((
243 243  IDL command
244 244  )))|=(((
245 245  description
246 -)))|=(((
247 -motion
248 248  )))
249 249  |(((
250 -calc_dcm_energy, 10000, /set
265 +**{{code language="none"}}qt (, t=100, scale=[0,4096]){{/code}}**
251 251  )))|(((
252 -set DCM and undulator to 10 keV
267 +Quick **transmission** image at the current position. Options: set new exposure time, set new scale for image display,
268 +)))
269 +|(((
270 +**{{code language="none"}}qa (, t=100, scale=[0,2], /ref, /here){{/code}}**
253 253  )))|(((
254 -\\
272 +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.
255 255  )))
256 256  |(((
257 -dcm_pitch, 0.00001
275 +**{{code language="none"}}qp (, t=100, scale=[0,2], /ref, /here){{/code}}**
258 258  )))|(((
277 +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
278 +)))
279 +|(((
280 +**{{code language="none"}}qr (, t=100, scale=[0,4096]){{/code}}**
281 +)))|(((
282 +Quick **reference image**. Options: set new exposure time,  set new scale for image display,
283 +)))
284 +|(((
285 +**{{code language="none"}}side, 90 (, t=100, /ref, /rel, /here, imgtype='a') {{/code}}**
286 +)))|(((
287 +**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)
288 +)))
289 +|(((
290 +**{{code language="none"}}sshift, 2 (, t=100, /ref, /here, imgtype='a'){{/code}}**
291 +)))|(((
292 +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)
293 +)))
294 +|(((
295 +##**sz, 2 (, t=100, /ref, /here, imgtype='a')**##
296 +)))|(((
297 +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)
298 +)))
299 +|(((
300 +**{{code language="none"}}zx, 2 (, t=100, /ref, /here, imgtype='a'){{/code}}**
301 +)))|(((
302 +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)
303 +)))
304 +
305 +{{info title="
306 +
307 +
308 +Monochromator positioning"}}
309 +ATTENTION: Setting up a Monochromator as well as positioning front end slits is **only** done by the beamline staff!
310 +
311 +The commands above may be used by users to realign the beam should it beam profile drift with time.
312 +{{/info}}
313 +
314 +== {{id name="IDLcheatsheet-DCMpositioning"/}}DCM positioning ==
315 +
316 +(% class="fixed-table wrapped" %)
317 +|=(((
318 +IDL command
319 +)))|=(((
320 +description
321 +)))|=(((
322 +motion
323 +)))
324 +|(((
325 +##**dcm_pitch, 0.00001**##
326 +)))|(((
259 259  move 2nd crystal pitch by 0.00001 deg
260 260  )))|(((
261 261  relative [ deg ]
262 262  )))
263 263  |(((
264 -goto_dcm_pitch,  -0.03976
332 +##**goto_dcm_pitch,  -0.03976**##
265 265  )))|(((
266 266  move 2nd crystal pitch to -0.03976 deg
267 267  )))|(((
... ... @@ -268,23 +268,43 @@
268 268  absolute [ deg ]
269 269  )))
270 270  |(((
271 -reflex_opt
339 +##**reflex_opt_single**##
272 272  )))|(((
273 273  move 2nd crystal pitch to optimal flux position
274 274  )))|(((
275 -\\
343 +
276 276  )))
345 +
346 +== {{id name="IDLcheatsheet-DMMpositioning"/}}DMM positioning ==
347 +
348 +(% class="fixed-table wrapped" %)
349 +|=(((
350 +IDL command
351 +)))|=(((
352 +description
353 +)))|=(((
354 +motion
355 +)))
277 277  |(((
278 -gap, 0.01
357 +##**dmm_x2_rot, 0.001**##
279 279  )))|(((
280 -move undulator gap by 0.01 mm
359 +move 2nd crystal pitch by 0.00001 deg
281 281  )))|(((
282 -relative [ mm ]
361 +relative [ deg ]
283 283  )))
363 +|(((
364 +##**goto_dmm_x2_rot,  0.8923**##
365 +)))|(((
366 +move 2nd crystal pitch to 0.8923 deg
367 +)))|(((
368 +absolute [ deg ]
369 +)))
284 284  
371 +
372 +
285 285  == {{id name="IDLcheatsheet-Generalsyntax"/}}General syntax ==
286 286  
287 -(% class="wrapped relative-table" style="width: 51.5317%;" %)
375 +(% class="relative-table wrapped" style="width:45.5603%" %)
288 288  |=(((
289 289  Functionality
290 290  )))|=(((
... ... @@ -291,7 +291,7 @@
291 291  IDL syntax
292 292  )))
293 293  |(((
294 -Chaining commands
382 +chaining commands
295 295  )))|(((
296 296  command_1 **&** command_2 **&** ...
297 297  )))
... ... @@ -313,6 +313,7 @@
313 313  
314 314  == {{id name="IDLcheatsheet-BeamshutterandInterlockcontrol"/}}Beamshutter and Interlock control ==
315 315  
404 +(% class="relative-table wrapped" style="width:75.0455%" %)
316 316  |=(((
317 317  IDL command
318 318  )))|=(((
... ... @@ -319,42 +319,46 @@
319 319  description
320 320  )))
321 321  |(((
322 -bs_info
411 +##**bs_info**##
323 323  )))|(((
324 324  prints an overview of the beamline beamshutter status
325 325  )))
326 326  |(((
327 -bsoh_open / bsoh_close
416 +##**bsoh_open / bsoh_close**##
328 328  )))|(((
329 329  opens / closes the optics hutch beamshutter. Closing the OH beamshutter will close all following beamshutters (EH1, EH2)
330 330  )))
331 331  |(((
332 -bseh1_open / bseh1_close
421 +##**bseh1_open / bseh1_close**##
333 333  )))|(((
334 -opens / closes the EH1 beamshutter. Closing the OH beamshutter will the EH2 beamshutter as well
423 +opens / closes the EH1 beamshutter. Opening will open the OH beamshutter as well. Closing the OH beamshutter will the EH2 beamshutter as well
335 335  )))
336 336  |(((
337 -bseh2_open / bseh2_close
426 +##**bseh2_open / bseh2_close**##
338 338  )))|(((
339 -opens / closes the EH2 beamshutter.
428 +opens / closes the EH2 beamshutter. Openening will open the OH and EH1 beamshutters as well.
340 340  )))
341 341  |(((
342 -ics_info
431 +##**ics_info**##
343 343  )))|(((
344 344  prints an overview of the beamline interlock status
345 345  )))
346 346  |(((
347 -ics_break_oh
436 +##**oh_break_ics**##
348 348  )))|(((
349 349  closes all P05 beamshutters and breaks OH door interlock. P06 beamshutter must be closed for this command to work!
350 350  )))
351 351  |(((
352 -ics_break_eh1
441 +##**eh1_break_ics**##
353 353  )))|(((
354 354  closes EH1 beamshutter (and EH2 beamshutter  if open) and breaks EH1 door interlock
355 355  )))
356 356  |(((
357 -ics_break_eh2
446 +##**eh2_break_ics**##
358 358  )))|(((
359 -closes EH2 beshutter and breaks EH2 door interlock
448 +closes EH2 beamshutter and breaks EH2 door interlock
360 360  )))
450 +
451 +== Sample Changer Macros ==
452 +
453 +
p05_uct.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.fwilde
Size
... ... @@ -1,0 +1,1 @@
1 +1022.2 KB
Content
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -135759019
1 +87353119
URL
... ... @@ -1,1 +1,1 @@
1 -https://confluence.desy.de/spaces/P5I/pages/135759019/IDL cheat sheet
1 +https://confluence.desy.de/spaces/P5I/pages/87353119/IDL cheat sheet