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