Debian Codegraph @

docs/source/tutorial/s3_autocenter.rst

raw
1 Centering and calibration
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _s3p1:
4
5 The next step is to set the beam center, x-ray wavelength, and sample to detector distance.
6 Before this can be done, you have to set the image and file header type in the Options window.
7 The best way to find the beam center and sample to detector distance is using the automated
8 method in RAW. This tutorial assumes you have just done :ref:`Part 1 <s3p3>`.
9 If not, open RAW as in Step 1 and set your data folder as in Step 8 of :ref:`Part 1 <s3p3>`.
10
11 A video version of this tutorial is available:
12
13 .. raw:: html
14
15 <style>.embed-container { position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; } .embed-container iframe, .embed-container object, .embed-container embed { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }</style><div class='embed-container'><iframe src='https://www.youtube.com/embed/v7-CROk8oqM' frameborder='0' allowfullscreen></iframe></div>
16
17 The written version of the tutorial follows.
18
19 #. We will use silver behenate to calibrate the sample to detector distance,
20 the beam center on the detector, and the detector rotation. Show the silver
21 behenate image by selecting the **agbe_008_0001.tif** file and clicking
22 the show image button at the bottom of the File Control panel.
23
24 |calibration_image_png|
25
26 #. In the Image Plot Panel that is now showing, click on the Image Display Settings
27 button (looks like vertical slider bars) at the bottom of the screen.
28
29 #. In the window that appears, set the scale to logarithmic and and click “OK”.
30
31 |calibration_logscale_png|
32
33 #. Open the Centering/Calibration panel by going to the Tools menu and selecting
34 “Centering/Calibration”.
35
36 |calibraiton_auto_panel_png|
37
38 #. In the Centering/Calibration panel set the Energy to 12.0 keV. Verify that the
39 Detector Pixel Size is 172.0 x 172.0 micron. Verify that the Detector is set to
40 "pilatus_1m". Verify that the standard is set to AgBh.
41
42 * *Note:* The x-ray energy/wavelength is a previously measured value.
43
44 * *Note:* If you set the detector properly in the radially averaging
45 options panel the detector and detector pixel size values will
46 fill in automatically (if the detector is not Other).
47
48 |calibration_parameters_png|
49
50 #. The goal of centering and calibration is to find a beam center position, sample
51 to detector distance, and detector rotation that causes the calculated
52 Silver Behenate ring pattern to match up with the rings on the image.
53
54 * *Note:* The beamstop is the blue/green bar extending out from the top
55 right edge of the detector
56
57 #. Click the “Start” button in the “Automatic Centering/Calibration” panel.
58
59 #. Make sure the “Ring #” is set to 0. Click on a point with strong intensity in
60 the Silver Behenate ring nearest the beamstop.
61
62 * *Note:* For some experimental setups, one or more of the largest d-spacing
63 rings may not be visible on the detector. In this case, you need to figure
64 out what the first visible ring on the detector is, and set the ring number
65 to that. So, if the third ring was the first one on the detector, the Ring #
66 would be set to 2 (the ring number is zero index, so 0 corresponds to the first
67 ring, 1 to the second ring, and so on).
68
69 |calibraiton_centering_1_png|
70
71 #. The peak intensity points in that ring will be automatically found, and labeled with
72 tan-ish dots.
73
74 * *Tip:* If it didn’t find very many points, try clicking again on another
75 part of the ring, and it will add more points to your selection.
76
77 #. If needed, click on the other portions of the same ring that are on different detector
78 panels to find out the rest of the points in this calibration ring.
79
80 * *Note:* The autofind algorithm will only find peaks in contiguous
81 regions. However, masked regions don't count, so if you've masked the
82 panel gaps before calibration it should find points in all of the panels.
83
84 * *Tip:* Due to the color map selected, the points may be hard to see. Try changing
85 to the heat map or grayscale to see the selected points,.
86
87 |calibraiton_centering_2_png|
88
89 #. Change the “Ring #” to 1.
90
91 |calibraiton_ring_number_png|
92
93 #. Click on a peak intensity point of the second visible ring. Do this for all
94 the sections of this ring in different detector modules.
95
96 #. Change the “Ring #” to 2. Click on a peak intensity point of the third visible
97 ring. Points will be shown with green dots.
98
99 #. Click the “Done” button in the “Automatic Centering/Calibration” panel.
100
101 |calibraiton_centering_3_png|
102
103 #. The beam position, sample to detector distance, and detector tilt angles will
104 be calculated and filled in. Calculated rings will display on the plot as
105 dashed red lines, based on the parameters found in the fit. The beam center
106 is displayed as a red dot on the image. You can verify the validity of the
107 fit based on how these calculated values match up with what is shown on the image.
108
109 * *Note:* Calculated rings are displayed without detector tilt angles, so if the detector
110 is significantly off beam normal the calculated rings will not match up with the
111 measured rings.
112
113 * *Note:* Image tilt plane rotation is an odd value. It represents motions of
114 both X and Y around the Z axis of the detector. As such, it can take on
115 large values (such as -131) for very small detector angles, which is just
116 representing motion in both axes. In this case, all three detector angles are
117 ~0.7 degrees or less.
118
119 |calibraiton_centering_4_png|
120
121 #. If necessary (such as if the autocentering routine fails), all of the calibration
122 values can be adjusted manually. The beam center can either be typed into the
123 appropriate boxes, or the red arrows can be used to nudge it by "Steps" pixels
124 in any direction. The crosshairs can be used to pick the beam center position by
125 hand, good for getting a rough alignment. The other parameters can be
126 typed into their appropriate boxes. Manual centering is an iterative process:
127
128 #. Enter rough values based on observation, measurement of actual sample
129 detector distance.
130
131 #. Use arrows to move beam center until you match up with the first ring.
132
133 #. Adjust the distance until you match up with the second ring.
134
135 #. Repeat the last two steps as necessary until you converge on a solution.
136
137 #. Click the OK button in the Centering/Calibration panel to save your settings and
138 exit the panel.
139
140
141 .. |calibration_image_png| image:: images/calibration_image.png
142 :target: ../_images/calibration_image.png
143
144 .. |calibration_logscale_png| image:: images/calibration_logscale.png
145 :target: ../_images/calibration_logscale.png
146
147 .. |calibraiton_auto_panel_png| image:: images/calibration_auto_panel.png
148 :target: ../_images/calibration_auto_panel.png
149
150 .. |calibration_parameters_png| image:: images/calibration_parameters.png
151 :width: 400 px
152 :target: ../_images/calibration_parameters.png\
153
154 .. |calibraiton_centering_1_png| image:: images/calibration_centering_1.png
155 :target: ../_images/calibration_centering_1.png
156
157 .. |calibraiton_centering_2_png| image:: images/calibration_centering_2.png
158 :target: ../_images/calibration_centering_2.png
159
160 .. |calibraiton_centering_3_png| image:: images/calibration_centering_3.png
161 :target: ../_images/calibration_centering_3.png
162
163 .. |calibraiton_centering_4_png| image:: images/calibration_centering_4.png
164 :target: ../_images/calibration_centering_4.png
165
166 .. |calibraiton_ring_number_png| image:: images/calibration_ring_number.png
167 :width: 400 px
168 :target: ../_images/calibration_ring_number.png