| 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` |