Debian Codegraph @

docs/source/tutorial/s2_align.rst

raw
1 Aligning reconstructions with high resolution shapes
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3
4 It is often important to align SAXS reconstructions, either bead models such
5 as those from DAMMIF/N or electron density from DENSS, with high resolution
6 structural models such as those from x-ray crystallography to see how well
7 they agree. RAW can do that automatically when you generate the models,
8 as described in the :ref:`DAMMIF/N <dammif>` and :ref:`DENSS <denss_s2>` sections
9 of the tutorial. RAW also provides standalone windows for doing the alignment
10 with already generated reconstructions.
11
12 If you use DENSS alignment in RAW, in addition to citing the RAW paper, please cite the
13 DENSS paper: T. D. Grant. Nature Methods (2018) 15, 191–193.
14 DOI: `10.1038/nmeth.4581 <https://doi.org/10.1038/nmeth.4581>`_
15
16 If you use RAW to run CIFSUP, in addition to citing the RAW paper, please
17 cite the paper given in the `CIFSUP manual. <hhttps://biosaxs-com.github.io/atsas/4.0.0/manuals/cifsup.html>`_
18 Note that CIFSUP is only available in ATSAS >=3.1.0. For older versions of ATSAS
19 a similar SUPCOMB window is available, the full tutorial for that can be found
20 in previous versions of this tutorial.
21
22 A video version of this tutorial is available:
23
24 .. raw:: html
25
26 <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/W-7dE1o7-aQ' frameborder='0' allowfullscreen></iframe></div>
27
28 The written version of the tutorial follows.
29
30 Bead models - CIFSUP
31 *************************
32 .. _raw_supcomb:
33
34 CIFSUP from the ATSAS suite can be used to align two PDB/mmCIF files. In this context,
35 one model (the reference) is the high resolution structure while the other
36 (the target) is the bead model reconstruction.
37
38 #. Open the CIFSUP window by selecting Tools->ATSAS->Align (SUPCOMB/CIFSUP) from the menu bar
39
40 |align_atsas_menu_png|
41
42 #. In the window that opens, 'Target' is the model that is aligned, where
43 as 'Reference' is the model that the target is aligned to. In other words,
44 the Reference model stays unchanged, while the Target model is moved to
45 best align with the Reference.
46
47 #. Use the Reference 'Select' button to select
48 **reconstruction_data/gi_complete/1XIB_4mer.pdb** as the reference file.
49
50 * *Tip:* Only the filename will show up in either the Reference or Target
51 box. If you hover your mouse over the filename it will show the full
52 path to the file.
53
54 #. Use the Target 'Select' button to select
55 **reconstruction_data/gi_complete/gi_dammif/refine_glucose_isomerase-1.pdb**
56
57 |align_atsas_select_png|
58
59 #. Click the start button. CIFSUP will run, and you should see the 'Status' update
60 to 'Running alignment' and then 'Alignment finished'.
61
62 |align_atsas_start_png|
63
64 #. When CIFSUP is finished, in the same folder as the target file you will
65 see a **<target_name>_aligned.pdb** file, which is the target model
66 aligned with the reference file.
67
68 #. Advanced settings can be accessed by clicking on the 'Advanced Settings' text
69 to expand the section. These settings are described in the `CIFSUP manual
70 <https://biosaxs-com.github.io/atsas/4.0.0/manuals/cifsup.html>`_.
71
72 |align_atsas_advanced_png|
73
74
75 Electron density
76 *************************
77
78 DENSS include a native tool for aligning two electron density files (.mrc)
79 or an electron density to a PDB file. In this context, one model (the reference)
80 is the high resolution
81
82 #. Open the Electron Density Alignment window by selecting Tools->Electron
83 Density (DENSS) Alignment from the menu bar
84
85 |align_denss_menu_png|
86
87 #. In the window that opens, 'Target' is the model that is aligned, where
88 as 'Reference' is the model that the target is aligned to. In other words,
89 the Reference model stays unchanged, while the Target model is moved to
90 best align with the Reference.
91
92 #. Use the Reference 'Select' button to select
93 **reconstruction_data/gi_complete/1XIB_4mer.pdb** as the reference file.
94
95 * *Tip:* Only the filename will show up in either the Reference or Target
96 box. If you hover your mouse over the filename it will show the full
97 path to the file.
98
99 #. Use the Target 'Select' button to select
100 **reconstruction_data/gi_complete/gi_denss/glucose_isomerase_refine.mrc**
101
102 |align_denss_select_png|
103
104 #. Click the start button. DENSS alignment will run.
105
106 * *Tip:* If there is already a file in the folder with the aligned output
107 filename you will get a prompt to overwrite it.
108
109 * *Tip:* By default, DENSS centers the Reference file. This writes out
110 a file named **<reference_name>_centered.pdb** in the same folder as
111 the reference file, which is what should be compared to the aligned
112 file. You can turn this off in the Advanced Settings.
113
114 |align_denss_start_png|
115
116 #. When alignment is finished, in the same folder as the target file you will
117 see a **<target_name>_aligned.mrc**. Compare this to the **<reference_name>_centered.pdb**
118 file in reference file folder. In this case those names are **glucose_isomerase_refine_aligned.mrc**
119 and **1XIB_4mer_centered.pdb**.
120
121 #. You can change the advanced settings by expanding the Advanced Settings section.
122 These advanced settings are:
123
124 * *Number of cores:* Number of cores to use during alignment
125 * *Enantiomorphs:* Whether to generate enantiomorphs of the Target before doing
126 the alignment.
127 * *Center reference:* Whether to center the reference model at the origin.
128 If used, this creates a **<reference_name>_centered.pdb** file in the same
129 folder as the reference file.
130 * *PDB calc. resolution:* The resolution of the density map created from
131 the Reference PDB model to compare with the Target model. This has
132 no effect if the Reference is already a density.
133
134 |align_denss_advanced_png|
135
136 .. |align_atsas_menu_png| image:: images/align_atsas_menu.png
137 :width: 400 px
138 :target: ../_images/align_atsas_menu.png
139
140 .. |align_atsas_select_png| image:: images/align_atsas_select.png
141 :width: 400 px
142 :target: ../_images/align_atsas_select.png
143
144 .. |align_atsas_start_png| image:: images/align_atsas_start.png
145 :width: 400 px
146 :target: ../_images/align_atsas_start.png
147
148 .. |align_atsas_advanced_png| image:: images/align_atsas_advanced.png
149 :width: 400 px
150 :target: ../_images/align_atsas_advanced.png
151
152
153 .. |align_denss_menu_png| image:: images/align_denss_menu.png
154 :width: 250 px
155 :target: ../_images/align_denss_menu.png
156
157 .. |align_denss_select_png| image:: images/align_denss_select.png
158 :width: 400 px
159 :target: ../_images/align_denss_select.png
160
161 .. |align_denss_start_png| image:: images/align_denss_start.png
162 :width: 400 px
163 :target: ../_images/align_denss_start.png
164
165 .. |align_denss_advanced_png| image:: images/align_denss_advanced.png
166 :width: 400 px
167 :target: ../_images/align_denss_advanced.png