Debian Codegraph @

docs/source/tutorial/s2_denss.rst

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