Debian Codegraph @

docs/source/tutorial/s1_basic.rst

raw
1 Loading configuration files and images, creating subtracted scattering profiles, saving profiles
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _s1p1:
4
5 A video version of this tutorial is available:
6
7 .. raw:: html
8
9 <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/vLyAx7KkS8s' frameborder='0' allowfullscreen></iframe></div>
10
11 The written version of the tutorial follows.
12
13 #. Open RAW. The install instructions contain information on installing and running RAW.
14
15 #. In the files tab, click on the folder button and navigate to the
16 **Tutorial_Data/standards_data** folder. Click the open button to show that
17 folder in the RAW file browser.
18
19 |file_ctrl_1_png|
20
21 * *Tip:* You can navigate within the file list as well. Use the up arrow
22 (filename: "**..**"") to move up a directory level or double click on a directory
23 to open it.
24
25 #. At the bottom of the File tab in the Control Panel, use the drop-down menu to
26 set the file type filter to “CFG files (\*.cfg)”.
27
28 |file_ctrl_3_png|
29
30 #. Double click on the **SAXS.cfg** file to load the SAXS configuration.
31 This loads the beamline configuration into the program.
32
33 * *Note:* Any time you are going to process images, you need to load the
34 appropriate configuration!
35
36 #. Change the file type filter to “TIFF files (\*.tiff)”.
37
38 #. At the CHESS G1 station, where this data was taken, typically ~10 images
39 were collected from a given sample. To load in the 10 images
40 for the glucose isomerase (GI) sample, start by selecting the files
41 **GI2_A9_19_001_xxxx.tiff**, where **xxxx** will range from **0000** to **0009**\ .
42 These files are measured scattering from 0.47 mg/ml GI.
43
44 * *Tip:* you can hold down the ctrl key (apple key on macs) while
45 clicking to select multiple files individually. You can also click on a
46 file, and then shift click on another file to select those files and
47 everything between them.
48
49 * *Warning:* Don’t load the files with **PIL3** in their name. Those are
50 the wide-angle scattering (WAXS) data, which we will process separately later.
51
52 #. Click the plot button to integrate all of the images and plot the integrated
53 scattering profiles on the Profiles plot.
54
55 * *Note:* Typically, once the images are integrated we work only with the
56 scattering profiles. However, it is useful to keep the images around in
57 case you want to reprocess the data.
58
59 |file_ctrl_2_png|
60
61 #. Plot the **GIbuf2** scattering profiles from the images. These are measured
62 scattering from the matching buffer, without any protein, for the GI sample.
63
64 #. Click on the Profiles control tab. This is where you can see what scattering
65 profiles are loaded into RAW, and manipulate/analyze them.
66
67 * *Checkpoint:* If you’ve successfully loaded the images given, you should see twenty
68 scattering profiles in the profiles list, with names like **GI2_A9_19_001_0000.tiff**
69 or **GIbuf2_A9_18_001_0000.tif**.
70
71 |manip_items_1_png|
72
73 #. Click on a filename to select the scattering profile. The background should
74 turn blue, indicating it is selected.
75
76 |manip_items_2_png|
77
78 #. Select all of the GI scattering profiles
79
80 * *Tip:* Again, the ctrl(/apple) key or the shift key can be used
81 to select multiple scattering profiles.
82
83 * *Warning:* Select only the GI profiles, not the GI buffer profiles.
84
85 |manip_items_3_png|
86
87 #. Use the average button to average all of the scattering profiles collected
88 into a single curve.
89
90 * *Checkpoint:* The averaged scattering profile should appear at the bottom of
91 the Profiles list. You may have to scroll down to see it. The filename
92 will be in green, and will start with **A_**, indicating it is an averaged
93 scattering profile.
94
95 #. Average all of the GI buffer scattering profiles.
96
97 #. In order to clearly see the averaged scattering profiles, you will need to hide the
98 individual profiles from the plot. Clicking on the eye to the left of
99 the filename will show/hide a scattering profile. When the eye is shown,
100 the profile is shown on the plot, when the eye has a line through it, the
101 profile is hidden. Hide all of the profiles except the two averaged curves.
102
103 * *Tip:* The eye and eye with the line through it at the top of the Profiles panel
104 can be used to show/hide sets of loaded profiles at once. If no profiles are selected,
105 these buttons show/hide all loaded profiles. If some profiles are selected, these buttons
106 show/hide just the selected profiles. Try selecting all but the averaged files and using
107 the show/hide all buttons.
108
109 |manip_items_4_png|
110
111 #. Next you need to subtract the buffer scattering profile from the measured
112 protein scattering (which is really the scattering of the protein plus the
113 scattering of the buffer). Star the averaged buffer file, and select the
114 averaged protein file, then click the subtract button.
115
116 |manip_items_5_png|
117
118 * *Checkpoint:* The subtracted scattering profile should be shown in the
119 lower plot. A new profile should be shown in the Profiles list
120 with the name in red and a **S_** prefix indicating it is a
121 subtracted file.
122
123 |manip_items_6_png|
124
125 #. You don’t need the individual image scattering profiles any more. Select all of those
126 (but not your averaged or subtracted profiles!) and click remove.
127
128 * *Note:* This only removes the scattering profiles from RAW. The images on your
129 hard drive are unaffected.
130
131 #. You can also load files into RAW by dragging and dropping files onto the RAW
132 window. Load in the **lys2** images by selecting them in your file browser,
133 then dragging them onto the top plot.
134
135 #. Load in the **lysbuf2** files. Average both the lysozyme and buffer data,
136 and subtract to create a subtracted lysozyme scattering profile. The
137 concentration of this sample was 4.27 mg/ml. Remove all of the profiles
138 that are not averaged or subtracted profiles.
139
140 * *Tip:* In order to tell which curve is which in a plot, click on the target icon in
141 the Profiles list. This should bold that curve in the plot. Click the target icon
142 again to return the curve to normal.
143
144 |manip_items_7_png|
145
146 #. We’re done with the averaged profiles. Select all of the averaged profiles and click the “Save”
147 button to save them in the **standards_data** folder. Note that in the filename in the Profiles
148 list, the * at the front goes away. This indicates there are no unsaved changes to those scattering
149 profiles. You can now remove them.
150
151 * *Note:* This saves them with a **.dat** extension. This is the standard format for SAXS
152 scattering profiles, and is also human readable.
153
154 |manip_items_8_png|
155
156 #. Right click on the subtracted plot, move the cursor over ‘Axes’ and select the Log-Log option.
157
158 * *Note:* It is best practice to display SAXS data, particularly in publications, on either
159 a semi-log (Log-Lin, default option in RAW) or double-log plot (depending on the features
160 of interest).
161
162 * *Note:* Well-behaved globular proteins will intersect the intensity axis roughly perpendicularly.
163
164 |log_log_plot_png|
165
166
167 .. |file_ctrl_1_png| image:: images/file_ctrl_1.png
168 :width: 400 px
169 :target: ../_images/file_ctrl_1.png
170
171 .. |file_ctrl_2_png| image:: images/file_ctrl_2.png
172 :width: 400 px
173 :target: ../_images/file_ctrl_2.png
174
175 .. |file_ctrl_3_png| image:: images/file_ctrl_3.png
176 :width: 400 px
177 :target: ../_images/file_ctrl_3.png
178
179 .. |manip_items_1_png| image:: images/manip_items_1.png
180 :target: ../_images/manip_items_1.png
181
182 .. |manip_items_2_png| image:: images/manip_items_2.png
183 :width: 400 px
184 :target: ../_images/manip_items_2.png
185
186 .. |manip_items_3_png| image:: images/manip_items_3.png
187 :width: 400 px
188 :target: ../_images/manip_items_3.png
189
190 .. |manip_items_4_png| image:: images/manip_items_4.png
191 :width: 400 px
192 :target: ../_images/manip_items_4.png
193
194 .. |manip_items_5_png| image:: images/manip_items_5.png
195 :width: 400 px
196 :target: ../_images/manip_items_5.png
197
198 .. |manip_items_6_png| image:: images/manip_items_6.png
199 :target: ../_images/manip_items_6.png
200
201 .. |manip_items_7_png| image:: images/manip_items_7.png
202 :target: ../_images/manip_items_7.png
203
204 .. |manip_items_8_png| image:: images/manip_items_8.png
205 :width: 400 px
206 :target: ../_images/manip_items_8.png
207
208 .. |log_log_plot_png| image:: images/log_log_plot.png
209 :width: 600 px
210 :target: ../_images/log_log_plot.png