Debian Codegraph @

docs/source/tutorial/s4_export_plots.rst

raw
1 Exporting plot data
2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3 .. _raw_export_plot:
4
5 This tutorial covers how to export plot data in RAW for using in other programs.
6 This is intended to be distinct from saving data in formats that RAW knows how
7 to read (e.g. .dat, .ift, .hdf5 for profiles, IFTs, and series respectively), as
8 the export formats cannot be read back into RAW. Exporting data in this way is
9 most useful for generating your own figures in other software.
10
11 The written version of the tutorial follows.
12
13
14 Exporting plot data as csv
15 ***************************
16
17 The following plots let you right click on the plot and export the data shown on
18 the plot as a csv file:
19
20 * Guinier fit (not the Guinier axes on the Profiles plot panel)
21 * Dimensionless Kratky
22 * Comparison (Residuals and Ratios)
23 * CRYSOL
24 * IFT plot panel
25
26 We will demonstrate how to do this using the Guinier fit plot.
27
28 #. Load the **glucose_isomerase.dat** dataset in the reconstruction_data folder.
29
30 #. Open the Guinier fit window by selecting the profile in the control
31 panel and clicking the "Guinier" button.
32
33 * *Tip:* For the IFT plot panel, the top and bottom plot (P(r) functions and
34 data/fit in q space) export separately, so if you want both you will
35 need to right click and export from both the top and bottom plot.
36 For the other windows listed above, all data on all plots shown is
37 exported at once.
38
39 #. In the Guinier fit window, right click on the plot and select "Export
40 Data as CSV".
41
42 |export_guinier_png|
43
44 #. Give the file an appropriate name and location and save the file.
45
46 Note: Comma separated value (.csv) files can be read directly by most
47 spreadsheet programs like Excel. They are text files that can be opened
48 and examined directly in a text editor.
49
50
51 Exporting SVD, EFA, and REGALS plot data
52 *****************************************
53
54 SVD, EFA, and REGALS plot data (including the singular values, autocorrelations,
55 forward and backward EFA plots and EFA and REGALS result plots) can be saved
56 from the various analysis windows.
57
58 #. Load the **phehc_sec.hdf5** file in the series_data folder.
59
60 #. Open the SVD window by right clicking on the phehc_sec.hdf5 series item
61 and selecting "SVD".
62
63 #. Use the "Save Plotted Values" button to save the plotted Singular Values and
64 AutoCorrelation values as a .csv file.
65
66 * Tip: If you want to save more values, increase the end value of the
67 plot indexes.
68
69 #. Use the "Save All" button to save the singular values, autocorrelation values,
70 and the left and right singular vectors as a .csv file.
71
72 |export_svd_png|
73
74 #. Close the SVD window and open the EFA window. Proceed with the EFA analysis
75 until you reach the final results page.
76
77 #. Use the "Save EFA Data (not profiles)" button to save the EFA results that
78 aren't the profiles in a .csv file. This includes metadata, the concentration
79 profiles, the chi^2 vs. frame, the forward and backward EFA data, the full
80 singular values and the left and right singular vectors for the number of
81 components selected for EFA.
82
83 |export_efa_png|
84
85 #. Close the EFA window and open the REGALS window. Proceed with the REGALS
86 analysis until you reach the final results page.
87
88 #. Use the "Save REGALS data (not profiles)" button to save the REGALS results
89 that aren't the profiles in a .csv file. This includes metadata, the
90 concentration profiles, the smoothed concentration profiles, the chi^2 vs.
91 frame, the component P(r) functions if calculated, the forward and
92 backward EFA data, the full singular values and the left and right singular
93 vectors for the number of components selected for REGALS.
94
95 |export_regals_png|
96
97
98 Exporting series plot data
99 ***************************
100
101 Series plot data (including the integrated intensity vs. frame and Rg vs. frame
102 values) can be saved from the Series control panel.
103
104 #. Load the **baseline.hdf5** file in the series_data folder.
105
106 #. In the Series control panel, right click on the **baseline.hdf5** item and
107 select "Export data".
108
109 #. Save the .csv file with an appropriate filename and location. This file
110 contains some metadata, and the integrated intensity, mean intensity,
111 if appropriate intensity in a fixed q range or at a fixed q value,
112 subtracted intensity (integrated, mean, q range and q value), Rg,
113 Rg uncertainty, I(0), I(0) uncertainty, MW and MW uncertainty from Vc,
114 MW from Vp, and filename for each frame.
115
116 |export_series_png|
117
118
119 Saving reconstruction plots
120 *****************************
121
122 The reconstruction plots (dammif/n residual plots and denss residual,
123 convergence and fsc plots) are automatically saved as
124 **<prefix>_dammif_results.pdf** or **<prefix>_denss_results.pdf**. However,
125 the data that makes the plots is not necessarily saved.
126
127 For DAMMIF/N results, if you want to recreate the residuals plots you can
128 load the **.fir** file, which has the fit and experimental data, and open those
129 two curves in the Comparison window to make a residual plot. The residual
130 data can be exported from there. Alternatively, you could calculate the
131 normalized residual directly from the data and fit.
132
133 For the DENSS results, the convergence data is saved in the **_by_step.fit** files,
134 the fsc data is saved in the **_fsc.dat file**, and the fit data is saved in the
135 **_map.fit** for each individual model.
136
137
138 .. |export_guinier_png| image:: images/export_guinier.png
139 :target: ../_images/export_guinier.png
140
141 .. |export_svd_png| image:: images/export_svd.png
142 :target: ../_images/export_svd.png
143
144 .. |export_efa_png| image:: images/export_efa.png
145 :target: ../_images/export_efa.png
146
147 .. |export_regals_png| image:: images/export_regals.png
148 :target: ../_images/export_regals.png
149
150 .. |export_series_png| image:: images/export_series.png
151 :target: ../_images/export_series.png
152 :width: 400 px