Wiki source code of IDL cheat sheet

Version 47.1 by fwilde on 2020/10/10 12:38

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