Debian Codegraph @

docs/source/tutorial/s2_gnom.rst

raw
1 Pair-distance distribution analysis – GNOM in RAW
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _s2p1:
4
5 The first step in most advanced data processing is to calculate the P(r) function, the
6 Fourier transform of I(q). This cannot be calculated directly from the scattering profile, so
7 indirect Fourier transform (IFT) methods are typically used. The most common such method is implemented
8 in the GNOM program from the ATSAS package. We will use RAW to run GNOM. Note that you need
9 :ref:`ATSAS installed <atsas>` to do this part of the tutorial.
10
11 This tutorial covers how to use RAW for doing an IFT. This is not a tutorial
12 on basic principles and best practices for doing an IFT or analysis of the
13 resulting P(r) function. For that, please see the :ref:`SAXS tutorial <saxs_ift>`.
14
15 If you use RAW to run GNOM, in addition to citing the RAW paper, please
16 cite the paper given in the `GNOM manual. <https://biosaxs-com.github.io/atsas/4.0.0/manuals/gnom.html>`_
17
18 A video version of this tutorial is available:
19
20 .. raw:: html
21
22 <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/1fe6uleE8iM' frameborder='0' allowfullscreen></iframe></div>
23
24 The written version of the tutorial follows.
25
26 #. Open RAW. The install instructions contain information on installing and running RAW.
27 If RAW is already open, clear all loaded data in RAW.
28
29 #. Open the **glucose_isomerase.dat** file in the **Tutorial_Data/reconstruction_data** folder.
30
31 #. Right click on the glucose_isomerase profile in the Profiles list and select “IFT (GNOM)”.
32
33 * *Note:* RAW will automatically try to find an appropriate maximum dimension (|Dmax|).
34
35 * *Troubleshooting:* If you do not have the GNOM option in the right click menu, RAW does
36 not know where your ATSAS programs are installed. If you installed the ATSAS programs
37 after starting RAW, restart RAW and it will attempt to automatically find them. If that
38 has failed, go to the Options->Advanced Options menu and choose the ATSAS settings (“ATSAS”).
39 Uncheck the option to “Automatically find the ATSAS bin location”, and specify the location
40 manually.
41
42 |gnom_panel_png|
43
44 #. The GNOM panel has plots on the right. These show the P(r) function
45 (top panel), the data (middle panel, blue points) and the fit line (middle
46 panel, red line), and the fit residual (bottom panel).
47
48 * *Note:* The fit line is the Fourier transform of the P(r) function, and is also
49 called the regularized intensity.
50
51 #. On the left of the GNOM panel are the controls and the resulting parameters. You can alter
52 the data range used, the |Dmax| value, whether the solution is forced to zero at
53 |Dmax|, and the alpha value used.
54
55 * *Tip:* The Guinier and P(r) |Rg| and I(0) values should agree well for
56 mostly rigid particles. The total estimate varies from 0 to 1, with 1
57 being ideal. GNOM also provides an estimate of the quality of
58 the solution. You want it to be at least a “REASONABLE” solution.
59
60 #. Try varying the |Dmax| value up and down in the range of 80-110. Observe what
61 happens to the P(r) and the quality of the solution.
62
63 #. Return the |Dmax| value to that found by RAW by clicking the "Auto Dmax" button.
64 |Dmax| should be 102. By default, GNOM forces the P(r) function to zero at |Dmax|.
65 For a high quality data set and a good choice of |Dmax|, P(r) should go to zero
66 naturally. Change the “Force to 0 at Dmax” option to “N”.
67
68 * *Try:* Vary |Dmax| with this option turned off.
69
70 #. Reset it so that the P(r) function is again being forced to zero
71 at |Dmax|.
72
73 #. RAW makes it easy to truncate your data for bead model reconstructions with ,
74 DAMMIF/N by setting q\ :sub:`max` to 8/|Rg| or 0.30, whichever is smaller.
75 Check the "Truncate for DAMMIF/N" box to truncate the data.
76
77 |gnom_cutrg_png|
78
79 * *Note:* The q\ :sub:`max` goes from 0.283 to 0.238 when you check the box.
80 * *Tip:* For electron density reconstruction with DENSS use the full
81 available q range.
82
83 #. Click "OK" to exit the panel and save the IFT to the RAW IFTs panel and plot.
84
85 * *Tip:* After exiting the IFT panel, note that data from the IFT shows
86 up in the Information panel.
87
88 #. Click on the IFTs Control and Plot tabs. This will display the GNOM output you just generated.
89 Save the **glucose_isomerase.out** item in the **reconstruction_data** folder.
90
91 * *Note:* This saved file is all of the GNOM output, in the GNOM format. It can be used
92 as input for any program that needs a GNOM **.out** file.
93
94 #. You can save the IFT in the pdf report that RAW can make. Right click on
95 the **glucose_isomerase.out** item in the IFT control panel and
96 select "Save report". In the window that opens click "Save Report" and
97 save the pdf report. If you open the report you will see a plot of the P(r)
98 function and a summary of the run parameters and numerical results saved
99 as a table.
100
101 * *Try:* Save both the GI profile and the IFT in the same report.
102
103 |gnom_report_png|
104
105 .. |gnom_panel_png| image:: images/gnom_panel.png
106 :target: ../_images/gnom_panel.png
107
108 .. |gnom_cutrg_png| image:: images/gnom_cutrg.png
109 :width: 300 px
110 :target: ../_images/gnom_cutrg.png
111
112 .. |gnom_report_png| image:: images/gnom_report.png
113 :width: 450 px
114 :target: ../_images/gnom_report.png
115
116 .. |Rg| replace:: R\ :sub:`g`
117
118 .. |Dmax| replace:: D\ :sub:`max`