Debian Codegraph @

docs/source/tutorial/s2_baseline.rst

raw
1 Advanced Series processing – Baseline correction
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3
4 Sometimes SEC data shows a baseline drift. This can be due either to instrumental
5 changes (such as beam drift), or changes in the measured system, such as capillary
6 fouling. RAW provides the ability to correct for these forms of baseline drift
7 using either a linear or integral baseline method. The linear baseline method
8 is best for instrumental drifts, while the integral baseline method is best
9 for capillary fouling. Both baseline methods apply a distinct correction for each
10 *q* value.
11
12 If you use integral baseline correction in RAW, in addition to citing the RAW
13 paper, please cite this paper: E. Brookes, P. Vachette, M. Rocco, and J. Pérez.
14 Journal of Applied Crystallography (2016). 49, 1827-1841.
15 DOI: `10.1107/S1600576716011201 <https://doi.org/10.1107/S1600576716011201>`_
16
17 A video version of this tutorial is available:
18
19 .. raw:: html
20
21 <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/ftFPs6XTyEA' frameborder='0' allowfullscreen></iframe></div>
22
23 The written version of the tutorial follows.
24
25 Linear Baseline Correction
26 *****************************
27
28 #. Clear all of the data in RAW. Load the **xylanase.hdf5** SEC data in the
29 **series_data** folder.
30
31 #. When it loads in, you will see there is a distinct constant upward slope in the
32 integrated intensity. This usually happens due to instrumental drift,
33 and can often be mostly corrected for.
34
35 |baseline_series_plot_png|
36
37 #. Open the LC Series analysis panel. Set a buffer range ('Auto' is fine).
38 You'll still see the slope in the subtracted integrated intensity plot.
39
40 * *Note:* To baseline correct data, you should only have buffer regions
41 selected before the peak.
42
43 #. Use the triangle to expand the Baseline Correction section.
44
45 * *Note:* On windows it will look like a button with '>>' after the
46 name.
47
48 |lc_analysis_baseline_expand_png|
49
50 #. Set baseline correction to 'Linear'. You should see the start and end
51 controls become active, and two blue regions representing your selected
52 start and end regions appear on the 'Subtracted' plot.
53
54 * *Note:* This should automatically show the 'Subtracted' plot tab. If
55 it doesn't, select the 'Subtracted' plot tab.
56
57 |lc_analysis_baseline_linear_png|
58
59 #. If you look closely, it looks like the baseline may level off a little bit
60 at the start of the series curve. So we will select a start range closer
61 to the peak. Click the 'Pick' button for the baseline correction start region
62 and select a start region about halfway to the peak. Roughly 30-50 frames
63 is a good length for the start and end regions.
64
65 |lc_analysis_baseline_linear_pick_png|
66
67 #. Expand the end range to be 50 frames long.
68
69 |lc_analysis_baseline_linear_range_png|
70
71 #. Click 'Set baseline and calculate'. You may see a warning, click 'Continue'.
72
73 * *Note:* The warning simply informs you that the slope of the linear correction
74 is not the same in the start and end region at all q values. This is usually
75 the case, and mostly can be ignored.
76
77 |lc_analysis_baseline_linear_warning_png|
78
79 #. The 'Baseline Corrected' plot should automatically show after you set the
80 baseline region and calculate. If not, change to that plot tab. You can
81 see that the upward drift is essentially gone.
82
83 |lc_analysis_baseline_linear_corrected_png|
84
85 #. Switch back to the subtracted plot. You'll see the calculated baseline
86 shown in orange.
87
88 |lc_analysis_baseline_linear_baseline_png|
89
90 #. Switch back to displaying the Baseline Corrected plot.
91
92 #. Remove any existing sample region and find a new sample region using the 'Auto'
93 button. Send that region to the Profiles plot.
94
95 #. You can remove the baseline correction by changing the 'Baseline correction'
96 selection from 'Linear' to 'None'. Do this, then send the sample region to the
97 Profiles plot again.
98
99 #. Change the 'Baseline correction' selection back to 'Linear'. Click 'Set Baseline
100 and calculate' to redo the linear correction. Click 'OK' to exit the LC Series
101 Analysis window. Now if you save series or reopen the window you will see
102 your baseline correction.
103
104 #. Switch to the profiles plot. Put the subtracted plot on a Log-Log scale.
105 You can see a difference in the profiles due to the baseline correction at
106 low q.
107
108 |baseline_linear_profiles_png|
109
110 Integral Baseline Correction
111 ******************************
112
113 Integral baseline correction proceeds very similarly to linear baseline correction.
114 Here we provide detail only where the procedures are different.
115
116 #. Clear all of the data in RAW. Load the **baseline.hdf5** SEC data in the
117 **series_data** folder.
118
119 * *Note:* This is the same as what you :ref:`previously saved <s1p7>` in
120 an earlier part of the tutorial.
121
122 #. Open the LC Series analysis panel. Verify that your buffer regions
123 are before the peak of interest.
124
125 #. Set baseline correction to 'Integral'.
126
127 #. Zoom in near the base of the subtracted peak. Pick a start region in the
128 flat baseline area just before the start of the peaks.
129
130 #. Pick an end region in the flat region just after the end of the peaks.
131
132 * *Note:* You should end up with regions ~460-480 and 860-880
133
134 * *Try:* You can use the 'Auto' button to automatically find start and end
135 regions. For this dataset, it ends up a little close to the peaks, so
136 some manual adjustment is necessary.
137
138 |lc_analysis_baseline_regions_png|
139
140 #. Click the 'Set baseline and calculate' button.
141
142 * *Note:* The start and end points should be set in regions with no change
143 in the baseline. If they aren't, RAW will give a warning. Try changing the
144 end region to ~800-820 to see such a warning.
145
146 #. Zoom in on the base of the peak in the baseline corrected dataset. You should
147 see that the baseline is actually a little overcorrected. This is because
148 the integral baseline correction only allows for positive or no change in the
149 baseline, so if some *q* values need a negative correction the total baseline
150 ends up overcorrected, as the positive values are brought down but the negative
151 values are not brought up.
152
153 * *Note:* You can change the intensity display to individual *q* values or
154 a *q* range and look at different points in *q* to try figure out which *q*
155 values are causing the issue.
156
157 |lc_analysis_baseline_overcorrect_png|
158
159 #. Switch back to the subtracted plot and zoom in on the base of the peak.
160 You'll see the calculated baseline shown in orange.
161
162 |lc_analysis_baseline_baseline_png|
163
164 #. Change the intensity display to 'Intensity in q range' and try several
165 different q ranges. This will allow you to see what q values are getting
166 the baseline overcompensated.
167
168 * *Try:* Recommended regions to try for this dataset are 0.01-0.02, 0.05-0.06,
169 0.1-0.2, 0.2-0.27.
170
171 * *Note:* You should find that it is the high *q* ranges that are being
172 overcorrected. This may imply that the profiles are mostly noise in
173 that range. If you examine the profiles and determine that is the case,
174 you could truncate the profiles to lower *q* before doing the baseline
175 correction.
176
177 #. Switch back to displaying the total intensity and the Baseline Corrected plot.
178
179 #. Remove any existing sample region and find a new sample region using the "Auto"
180 button. Send that sample region to the main plot.
181
182
183 .. |baseline_series_plot_png| image:: images/baseline_series_plot.png
184 :target: ../_images/baseline_series_plot.png
185
186 .. |lc_analysis_baseline_expand_png| image:: images/lc_analysis_baseline_expand.png
187 :width: 300 px
188 :target: ../_images/lc_analysis_baseline_expand.png
189
190 .. |lc_analysis_baseline_linear_png| image:: images/lc_analysis_baseline_linear.png
191 :target: ../_images/lc_analysis_baseline_linear.png
192
193 .. |lc_analysis_baseline_linear_pick_png| image:: images/lc_analysis_baseline_linear_pick.png
194 :width: 300 px
195 :target: ../_images/lc_analysis_baseline_linear_pick.png
196
197 .. |lc_analysis_baseline_linear_range_png| image:: images/lc_analysis_baseline_linear_range.png
198 :target: ../_images/lc_analysis_baseline_linear_range.png
199
200 .. |lc_analysis_baseline_linear_warning_png| image:: images/lc_analysis_baseline_linear_warning.png
201 :width: 500 px
202 :target: ../_images/lc_analysis_baseline_linear_warning.png
203
204 .. |lc_analysis_baseline_linear_corrected_png| image:: images/lc_analysis_baseline_linear_corrected.png
205 :target: ../_images/lc_analysis_baseline_linear_corrected.png
206
207 .. |lc_analysis_baseline_linear_baseline_png| image:: images/lc_analysis_baseline_linear_baseline.png
208 :target: ../_images/lc_analysis_baseline_linear_baseline.png
209
210 .. |baseline_linear_profiles_png| image:: images/baseline_linear_profiles.png
211 :target: ../_images/baseline_linear_profiles.png
212
213 .. |lc_analysis_baseline_regions_png| image:: images/lc_analysis_baseline_regions.png
214 :target: ../_images/lc_analysis_baseline_regions.png
215
216 .. |lc_analysis_baseline_overcorrect_png| image:: images/lc_analysis_baseline_overcorrect.png
217 :target: ../_images/lc_analysis_baseline_overcorrect.png
218
219 .. |lc_analysis_baseline_baseline_png| image:: images/lc_analysis_baseline_baseline.png
220 :target: ../_images/lc_analysis_baseline_baseline.png