Debian Codegraph @

docs/source/tutorial/s2_ambimeter.rst

raw
1 Assessing ambiguity of 3D shape information - AMBIMETER in RAW
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _raw_ambimeter:
4
5 It is impossible to determine a provably unique three-dimensional shape from a scattering
6 profile. This makes it important to determine what degree of ambiguity might be expected
7 in our reconstructions. The program AMBIMETER from the ATSAS package does this by comparing
8 the measured scattering profile to a library of scattering profiles from relatively simple
9 shapes. The more possible shapes that could have generated the scattering profile, the greater
10 ambiguity there will be in the reconstruction. We will use RAW to run AMBIMETER. Note that you need
11 :ref:`ATSAS installed <atsas>` to do this part of the tutorial.
12
13 If you use RAW to run AMBIMETER, in addition to citing the RAW paper, please
14 cite the paper given in the `AMBIMETER manual. <https://biosaxs-com.github.io/atsas/4.0.0/manuals/ambimeter.html>`_
15
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/kWShkxtj5iw' 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.out** 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.out** file in the **reconstruction_data/gi_complete**
30 folder.
31
32 |ift_panel_png|
33
34 #. Right click on the **glucose_isomerase.out** item in the IFT list. Select the “AMBIMETER” option.
35
36 #. The new window will show the results of AMBIMETER. It includes the number of shape categories
37 that are compatible with the scattering profile, the ambiguity score (a-score) (log base 10 of the
38 number of shape categories), and the AMBIMETER interpretation of whether or not you can
39 obtain a unique 3D reconstruction.
40
41 * According to the `original paper <https://doi.org/10.1107/S1399004715002576>`_,
42 "an a-score below 1.5 practically guarantees a unique ab initio shape determination,
43 whereas when the a-score is in the range 1.5–2.5 care should be taken, perhaps involving
44 cluster analysis, and for a-scores exceeding 2.5 unambiguous reconstruction without
45 restrictions (for example, on symmetry and/or anisometry) is highly unlikely."
46
47 * *Note:* AMBIMETER can also save the compatible shapes (either all or just the best
48 fit). You can do that by selecting the output shapes to save, giving it a save
49 directory, and clicking run. We won’t be using those shapes in this tutorial.
50
51 |ambimeter_panel_png|
52
53 #. Click “OK” to exit the AMBIMETER window.
54
55 * *Tip:* After exiting the AMBIMETER window the results can be seen in the
56 Information panel when the IFT is selected in the IFTs list.
57
58
59 .. |ift_panel_png| image:: images/ift_panel.png
60 :target: ../_images/ift_panel.png
61
62 .. |ambimeter_panel_png| image:: images/ambimeter_panel.png
63 :width: 400 px
64 :target: ../_images/ambimeter_panel.png