| 1 |
3D reconstruction with electron density – DENSS in RAW |
| 2 |
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 3 |
.. _denss_s2: |
| 4 |
|
| 5 |
A new, exciting method for doing 3D shape reconstructions in SAXS yields actual |
| 6 |
electron density, rather than bead models. There are many potential advantages to this, |
| 7 |
but one significant one is easy handling of systems like RNA-Protein complexes or |
| 8 |
membrane proteins surrounded by lipids or detergents, which have more than one electron |
| 9 |
density. Bead models typically only have two (molecule and solvent) or three bead densities, |
| 10 |
and so typically fail to reconstruct these complex objects. `DENSS <http://denss.org>`_ has |
| 11 |
been fully implemented in RAW and will be used to reconstruct these electron densities. |
| 12 |
|
| 13 |
If you use DENSS in RAW, in addition to citing the RAW paper, please cite the |
| 14 |
DENSS paper: T. D. Grant. Nature Methods (2018) 15, 191–193. |
| 15 |
DOI: `10.1038/nmeth.4581 <https://doi.org/10.1038/nmeth.4581>`_ |
| 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/BepDKkGXM6Q' frameborder='0' allowfullscreen></iframe></div> |
| 22 |
|
| 23 |
The written version of the tutorial follows. |
| 24 |
|
| 25 |
#. Clear all of the data in RAW. Load the **glucose_isomerase.ift** file that you saved in the |
| 26 |
**reconstruction_data** folder in a previous part of the tutorial. |
| 27 |
|
| 28 |
* *Note:* If you haven’t done the previous part of the tutorial, or forgot to save |
| 29 |
the results, you can find the **glucose_isomerase.ift** file in the |
| 30 |
**reconstruction_data/gi_complete** folder. |
| 31 |
|
| 32 |
* *Note:* You could run DENSS on the **glucose_isomerase.out** file that you used |
| 33 |
for :ref:`dammif <dammif>`. However, that profile was truncated to a maximum |
| 34 |
q value of 8/Rg, ~0.23. For DENSS you want to use the full q range of the data. As the |
| 35 |
.ift file was generated using all the q range available, it is convenient to |
| 36 |
use it rather than generating another .out file. Alternatively, use the |
| 37 |
**glucose_isomerase_full.out** file in the **gi_complete** folder. |
| 38 |
|
| 39 |
#. Right click on the **glucose_isomerase.ift** item in the IFT list. Select |
| 40 |
the “Electron Density (DENSS)” option. |
| 41 |
|
| 42 |
#. Running DENSS generates a lot of files. Click the “Select” button for the output directory, |
| 43 |
make a new folder in the **reconstruction_data** directory called **gi_denss** and select |
| 44 |
that folder. |
| 45 |
|
| 46 |
#. Change the number of reconstructions to 5 and the mode to Fast. |
| 47 |
|
| 48 |
* *Note:* It is generally recommended that you do at least 20 reconstructions. However, |
| 49 |
for the purposes of this tutorial, 5 are enough. |
| 50 |
|
| 51 |
* *Note:* For final reconstructions for a paper, DENSS should be run in Slow mode. |
| 52 |
For this tutorial, or for obtaining an initial quick look at results, Fast mode is fine. |
| 53 |
|
| 54 |
#. RAW can align the DENSS output with a PDB structure. To do so, check the |
| 55 |
Align output to PDB/MRC' box and select the **1XIB_4mer.pdb** file in |
| 56 |
the **reconstruction_data/gi_complete** folder. |
| 57 |
|
| 58 |
* *Tip:* If you're not sure if you selected the correct file, hovering |
| 59 |
your mouse over the filename will show the full path to the file. |
| 60 |
|
| 61 |
|denss_run_tab_png| |
| 62 |
|
| 63 |
#. Click the “Start” button. |
| 64 |
|
| 65 |
* *Note:* The status panel will show you the overall status of the reconstructions. |
| 66 |
You can look at the detailed status of each run by clicking the appropriate tab in |
| 67 |
the log panel. |
| 68 |
|
| 69 |
#. Note that by default the densities are aligned and averaged, including enantiomer |
| 70 |
filtering, and a refined density is created from the average. |
| 71 |
|
| 72 |
#. Wait for all of the DENSS runs and averaging to finish. Depending |
| 73 |
on the speed of your computer this could take a bit. |
| 74 |
|
| 75 |
#. Once the reconstructions are finished, the window should automatically switch to the |
| 76 |
results tab. If it doesn’t, click on the results tab. |
| 77 |
|
| 78 |
|denss_results_tab_png| |
| 79 |
|
| 80 |
#. The results panel summarizes the results of the reconstruction runs. If you are using |
| 81 |
a .out file, then at the top of the panel there is the ambimeter evaluation of |
| 82 |
how ambiguous the reconstructions might be (see earlier tutorial section). |
| 83 |
If averaging was run there is an estimate of the |
| 84 |
reconstruction resolution based on the Fourier shell correlation. In the models |
| 85 |
section there are several tabs. The summary tab shows the chi^2, |Rg|, support volume, |
| 86 |
and RSC to the reference model. If any model was not included in the averaging it |
| 87 |
is highlighted in red. |
| 88 |
|
| 89 |
* Verify that the Rg is close to the expected value, and that the chi^2 and support |
| 90 |
volumes are relatively consistent between models. |
| 91 |
|
| 92 |
* *Note:* Above we show the results for 20 runs instead of the 5 in the tutorial. |
| 93 |
|
| 94 |
#. Individual model results are displayed in the numbered tabs. For each individual |
| 95 |
model there are plots of: the original data and the model data (scattering from density); |
| 96 |
the residual between the original data and the model data; and chi squared, |Rg| and support volume |
| 97 |
vs. refinement step. |
| 98 |
|
| 99 |
* Verify that the residual between the actual data and the model data is small. |
| 100 |
|
| 101 |
* Check that the chi squared, |Rg|, and support volume have all plateaued (converged) |
| 102 |
by the final steps. |
| 103 |
|
| 104 |
|denss_model_tab_png| |
| 105 |
|
| 106 |
#. If the densities were averaged, the average tab will display the Fourier shell correlation |
| 107 |
vs. resolution. |
| 108 |
|
| 109 |
* *Note:* The reconstruction resolution is taken as the resolution in angstroms where the |
| 110 |
correlation first crosses 0.5. |
| 111 |
|
| 112 |
|denss_fsc_png| |
| 113 |
|
| 114 |
#. The results summary shown in Summary tab is automatically saved as a |
| 115 |
**<prefix>_denss_results.csv** csv file, e.g. for this data as |
| 116 |
**glucose_isomerase_denss_results.csv**. All the plots shown on the individual model |
| 117 |
tabs are automatically saved as a multi-page pdf file with the same name. |
| 118 |
|
| 119 |
#. Click the “Close” button when you are finished looking at the results and reconstructions. |
| 120 |
|
| 121 |
#. The results from the individual DENSS runs are saved in the selected output folder as |
| 122 |
**<prefix>_xx.mrc** where *xx* corresponds to the run number: 01, 02, etc. For this |
| 123 |
tutorial that would be **glucose_isomerase_01.mrc**, **glucose_isomerase_02.mrc**, etc. |
| 124 |
|
| 125 |
#. If averaging was done, final average density is saved in the selected output |
| 126 |
folder as **<prefix>_aver.mrc**. For this tutorial, that would be **glucose_isomerase_aver.mrc**. |
| 127 |
|
| 128 |
#. If refinement was done, the final refined density is saved in the selected |
| 129 |
output folder as **<prefix>_refine.mrc**. For this tutorial that would be |
| 130 |
**glucose_isomerase_refine.mrc**. |
| 131 |
|
| 132 |
#. If alignment to a reference model was done, the files aligned |
| 133 |
depend on what other processing was done. |
| 134 |
|
| 135 |
* If refinement was done, then there will be a single file named |
| 136 |
**<prefix>_refine_aligned.mrc**. For this tutorial, |
| 137 |
**glucose_isomerase_refine_aligned.mrc**. |
| 138 |
|
| 139 |
* If no refinement is done but averaging is done, then the |
| 140 |
averaged model is aligned. The associated filenames would |
| 141 |
be **<prefix>_average_aligned.mrc**. For this tutorial, |
| 142 |
**glucose_isomerase_averaged_aligned.mrc**. |
| 143 |
|
| 144 |
* If no refinement or averaging is done, then every calculated |
| 145 |
model is aligned. The associated filenames would be |
| 146 |
**<prefix>_##_aligned.mrc** where ## is the model number of a model. |
| 147 |
For this tutorial, that is **glucose_isomerase_##_aligned.mrc**. |
| 148 |
|
| 149 |
#. You can save a summary table of the DENSS results with the pdf report that |
| 150 |
RAW can make. Close the DENSS window, right click on the **glucose_isomerase.ift** |
| 151 |
item in the IFT control panel and select "Save report". Use the "Add DAMMIF/N results |
| 152 |
.csv" button to add the ***glucose_isomerase_denss_results.csv** to the |
| 153 |
report. Then click "Save Report" and save the pdf report. If you open the |
| 154 |
report you will see a summary of the run parameters and numerical results |
| 155 |
saved as a table. |
| 156 |
|
| 157 |
|denss_report_png| |
| 158 |
|
| 159 |
*Note:* **.mrc** files can be opened in Chimera and pyMOL. For tips about how to |
| 160 |
visualize the density and align it with known structures see the appropriate |
| 161 |
sections here: `http://www.tdgrant.com/denss/tips/ <http://www.tdgrant.com/denss/tips/>`_. |
| 162 |
|
| 163 |
|
| 164 |
.. |denss_run_tab_png| image:: images/denss_run_tab.png |
| 165 |
:target: ../_images/denss_run_tab.png |
| 166 |
|
| 167 |
.. |denss_results_tab_png| image:: images/denss_results_tab.png |
| 168 |
:target: ../_images/denss_results_tab.png |
| 169 |
|
| 170 |
.. |denss_model_tab_png| image:: images/denss_model_tab.png |
| 171 |
:target: ../_images/denss_model_tab.png |
| 172 |
|
| 173 |
.. |denss_fsc_png| image:: images/denss_fsc.png |
| 174 |
:target: ../_images/denss_fsc.png |
| 175 |
|
| 176 |
.. |denss_report_png| image:: images/denss_report.png |
| 177 |
:target: ../_images/denss_report.png |
| 178 |
:width: 300 px |
| 179 |
|
| 180 |
.. |Rg| replace:: R\ :sub:`g` |