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