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