| 1 |
Pair-distance distribution analysis – BIFT in RAW |
| 2 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 3 |
.. _bift_tutorial: |
| 4 |
|
| 5 |
RAW has a built in method for determining the P(r) function using a Bayesian IFT method (BIFT). |
| 6 |
This has the advantage of only have one possible solution. More information on this method can |
| 7 |
be found in the RAW paper and manual and references therein. |
| 8 |
|
| 9 |
This tutorial covers how to use RAW for doing an IFT. This is not a tutorial |
| 10 |
on basic principles and best practices for doing an IFT or analysis of the |
| 11 |
resulting P(r) function. For that, please see the :ref:`SAXS tutorial <saxs_ift>`. |
| 12 |
|
| 13 |
If you use RAW to run BIFT, in addition to citing the RAW paper, please |
| 14 |
cite the BIFT paper: Hansen, S. Journal of Applied Crystallography (2000) |
| 15 |
33, 1415-1421. DOI: `10.1107/S0021889800012930 <https://doi.org/10.1107/S0021889800012930>`_ |
| 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/Q0zCyjUJ35s' frameborder='0' allowfullscreen></iframe></div> |
| 22 |
|
| 23 |
The written version of the tutorial follows. |
| 24 |
|
| 25 |
#. Right click on the glucose isomerase profile in the Profiles list you loaded |
| 26 |
:ref:`previously <s2p1>`. Select “IFT (BIFT)” from the resulting menu. |
| 27 |
|
| 28 |
|bift_panel_png| |
| 29 |
|
| 30 |
#. The BIFT panel has plots on the right. These show the P(r) function |
| 31 |
(top panel), the data (middle panel, blue points) and the fit line (middle |
| 32 |
panel, red line), and the fit residual (bottom panel). |
| 33 |
|
| 34 |
#. On the left of the BIFT panel are the controls and the resulting parameters. Note that |
| 35 |
in this case you do not control the |Dmax| value, the BIFT method finds that for you |
| 36 |
automatically. Because BIFT can take some time to run, if you change the |
| 37 |
*q* range for the data you have to click the 'Run' button to run BIFT again. |
| 38 |
|
| 39 |
#. Note that for this dataset, BIFT has found a |Dmax| value around 100, |
| 40 |
in good agreement with what we found from GNOM. |
| 41 |
|
| 42 |
#. Click OK to exit the BIFT window. This saves the results into the IFTs panel. |
| 43 |
|
| 44 |
#. Click on the IFTs Control and Plot tabs. This will display the BIFT output you just generated. |
| 45 |
Save the **glucose_isomerase.ift** item in the **reconstruction_data** folder. |
| 46 |
|
| 47 |
#. You can save the IFT in the pdf report that RAW can make. Right click on |
| 48 |
the **glucose_isomerase.ift** item in the IFT control panel and |
| 49 |
select "Save report". In the window that opens click "Save Report" and |
| 50 |
save the pdf report. If you open the report you will see a plot of the P(r) |
| 51 |
function and a summary of the run parameters and numerical results saved |
| 52 |
as a table. |
| 53 |
|
| 54 |
|bift_report_png| |
| 55 |
|
| 56 |
*Note:* As of now, BIFT output from RAW is not compatible with DAMMIF or other ATSAS programs. |
| 57 |
However, it is compatible with electron density determination via DENSS. |
| 58 |
|
| 59 |
|
| 60 |
|
| 61 |
.. |bift_panel_png| image:: images/bift_panel.png |
| 62 |
:target: ../_images/bift_panel.png |
| 63 |
|
| 64 |
.. |bift_report_png| image:: images/bift_report.png |
| 65 |
:target: ../_images/bift_report.png |
| 66 |
:width: 450 px |
| 67 |
|
| 68 |
.. |Dmax| replace:: D\ :sub:`max` |