| 1 |
The Manipulation Panel and Main Plot Window |
| 2 |
============================================ |
| 3 |
|
| 4 |
**WARNING:** The manual is current several versions out of date. While it may |
| 5 |
still be useful for some users, please refer to the tutorial for the most |
| 6 |
up-to-date information. |
| 7 |
|
| 8 |
.. _manippanel: |
| 9 |
|
| 10 |
When individual scattering profiles are loaded, they are placed in the Manipulation tab |
| 11 |
of the Control Panel, and displayed in the Main Plot window. This section will cover the |
| 12 |
features of the Manipulation panel and the Main Plot Panel. |
| 13 |
|
| 14 |
|
| 15 |
The Manipulation Panel |
| 16 |
---------------------- |
| 17 |
|
| 18 |
The Manipulation Panel refers to the panel that is shown in the Control Panel when the |
| 19 |
Manipulation Tab is selected. |
| 20 |
|
| 21 |
The panel consists of two parts. The top part is where individual scattering profiles |
| 22 |
that are loaded into RAW are shown. The bottom part consists of buttons that allow you |
| 23 |
to manipulation these scattering profiles. Further manipulation of the scattering profiles |
| 24 |
can be done from the right click (context) menu and from the Tools menu. |
| 25 |
|
| 26 |
An individual item in the Manipulation Panel list is called a manipulation data item. |
| 27 |
|
| 28 |
All items loaded into the manipulation panel are initially displayed in the top plot of |
| 29 |
the Main Plot. |
| 30 |
|
| 31 |
|
| 32 |
Manipulation Data Items |
| 33 |
~~~~~~~~~~~~~~~~~~~~~~~ |
| 34 |
|
| 35 |
When a new item is plotted, a data item is added to the manipulation list in the manipulation |
| 36 |
tab. This allows you to control the properties of the data item, and |
| 37 |
perform manipulations and analysis on it. |
| 38 |
|
| 39 |
The name of the data item is displayed at the top of each item. If an item is given a |
| 40 |
different name for the plot legend, this legend name is displayed in [square brackets] |
| 41 |
next to the item name. On the same line as the item name, on the right side of the data |
| 42 |
item, there are a :ref:`series of buttons <manipitembuttons>` that can be used for further |
| 43 |
manipulation of the data item. |
| 44 |
|
| 45 |
**Note:** If there is a \* to the left of the item name (between the checkbox and the item |
| 46 |
name), it indicates there are unsaved changes to the item. This can occur if you change the |
| 47 |
scale, offset, or q range of the item, if the item is a newly created scattering profile (such |
| 48 |
as integrated from an image, or an averaged or subtracted item), if there is new analysis |
| 49 |
information associated with the item (such as Rg and I0), and from binning and interpolating |
| 50 |
the scattering profile. |
| 51 |
|
| 52 |
|
| 53 |
Offsetting, scaling and adjusting the q-range of a data item |
| 54 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 55 |
|
| 56 |
Each data item lets the user interactively adjust the scaling, offset and q-range by using |
| 57 |
the spin-buttons or entering values in the associated text field and hitting enter. These |
| 58 |
changes will be updated on the scattering profile displayed on the main plot. |
| 59 |
|
| 60 |
*Offset and Scale* |
| 61 |
|
| 62 |
The spin-buttons in the scaling and offset boxes will adjust the last digit of the displayed |
| 63 |
number by 1. So if the scale is 1.0, using the up spin button will adjust it 1.1, while the |
| 64 |
down spin button will adjust it to 0.9. If the scale was set to 1.15, the up button would adjust |
| 65 |
it to 1.16, while the down button would adjust it to 1.14. |
| 66 |
|
| 67 |
The scale can never be set to zero by the spin buttons, so if it is adjusted down in a way that |
| 68 |
would do so, it starts adjusting the next significant figure. For example, if you use the down |
| 69 |
button on a scale of 0.1, the new scale will be 0.09. A negative scale factor is treated like |
| 70 |
a positive scale factor (the absolute value of the scale factor is applied), thought it can |
| 71 |
cause unexpected behavior from the spin buttons. |
| 72 |
|
| 73 |
*Q-range* |
| 74 |
|
| 75 |
Adjusting q Min and q Max can be done in two ways. Each q limit has two boxes associated |
| 76 |
with it. The left box for each displays the actual q value, and a q value can be typed |
| 77 |
into those boxes. As there are a finite set of points in q space, RAW will automatically |
| 78 |
determine the nearest q point, and set the q value to this nearest point. The box on the |
| 79 |
right is the (0 indexed) point in the q vector. That is, if for q Min the value reads 15, |
| 80 |
then the scattering profile is being displayed starting at point number 15 in the q vector |
| 81 |
(note that this is the 16th point of the q vector, because it is zero indexed). The spin |
| 82 |
buttons adjust these point numbers, so if you use the up spinner on q Min, it will start |
| 83 |
at the next point in the q vector. |
| 84 |
|
| 85 |
|
| 86 |
Showing/Hiding data items on the Main plot |
| 87 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 88 |
|
| 89 |
To show/hide the scattering profile associated with a data item on the plot, click the |
| 90 |
checkbox next to the sample filename. If the checkbox is checked, the item is currently |
| 91 |
shown on the Main plot, if the checkbox is unchecked, the item is currently hidden on the |
| 92 |
main plot. |
| 93 |
|
| 94 |
|
| 95 |
Data item buttons |
| 96 |
~~~~~~~~~~~~~~~~~ |
| 97 |
|
| 98 |
.. _manipitembuttons: |
| 99 |
|
| 100 |
On the right of the top line of the data item (the same line as the item name and show/hide |
| 101 |
checkbox) are a series of buttons for controlling the data item. In order of left to right, |
| 102 |
these buttons have the following properties. |
| 103 |
|
| 104 |
*Collapse/Expand item controls* |
| 105 |
|
| 106 |
.. _manipcollapse: |
| 107 |
|
| 108 |
In order to see more data items in the list, or to prevent accidental changes to the q Min, |
| 109 |
q Max, Scale, or Offset values, the controls for a data item can be hidden using the triangle |
| 110 |
button in the upper right of the data item. Note that the direction of the triangle switches |
| 111 |
when it is toggled. If the triangle is pointing up, the controls are expanded, if the triangle |
| 112 |
is pointing down the controls are collapsed. |
| 113 |
|
| 114 |
*Extended Info* |
| 115 |
|
| 116 |
By hovering the mouse over the i in the blue circle button, a tooltip will appear which shows |
| 117 |
more information about the item, including Rg and MW. |
| 118 |
|
| 119 |
*Locate Line* |
| 120 |
|
| 121 |
The target button is used to highlight the scattering profile on the graph that is associated |
| 122 |
with the data item. When the target is pressed, it ‘bolds’ the line of the scattering profile |
| 123 |
(increases the line width by several points). When the target is pressed again, the line width |
| 124 |
is set back to normal. You can tell if a line is currently bolded, as the target will be orange |
| 125 |
instead of grey. |
| 126 |
|
| 127 |
*Line Properties* |
| 128 |
|
| 129 |
.. _maniplineprop: |
| 130 |
|
| 131 |
The colored line button has two purposes. First, the color matches the current color of the |
| 132 |
scattering profile in the Main Plot. Second, when pressed it opens a |
| 133 |
:ref:`line properties dialog <lineproperties>` which allows you to set the legend label; |
| 134 |
the line style, width, and color; the data point marker style, size, line color, and fill |
| 135 |
color; and the error bar line style, width, and color. |
| 136 |
|
| 137 |
*Mark* |
| 138 |
|
| 139 |
The star button marks an item. This is used when doing operations such as subtraction, syncing, |
| 140 |
superimposing or merging. In those cases, the marked (also referred to as starred) item has a |
| 141 |
special significance. |
| 142 |
|
| 143 |
|
| 144 |
Selecting data items |
| 145 |
~~~~~~~~~~~~~~~~~~~~ |
| 146 |
|
| 147 |
.. _selectmanipitem: |
| 148 |
|
| 149 |
A single data item can be selected by clicking on the item name in the Manipulation list |
| 150 |
(similar to how you would select files in your system file browser). When an item is selected, |
| 151 |
the color of the item background changes from white to gray. If the |
| 152 |
item is currently selected, clicking on it will cause it to be unselected. Note that for a regular |
| 153 |
click, all other selected items will be unselected when a new item is selected. |
| 154 |
|
| 155 |
Multiple items may be selected in two ways. If the Control key (Command key on Macs) is held down |
| 156 |
while clicking on items, each item that is clicked on will be added to the set of selected items. |
| 157 |
If a single item is first selected and then the Shift key is held down and another item is selected, |
| 158 |
all of the items in the list between the two items will be selected (including the second item that |
| 159 |
is clicked on). |
| 160 |
|
| 161 |
All of the items in the list can be selected in two ways. The first is using the |
| 162 |
:ref:`select all button <manipselectall>`, the second is pressing Ctrl-A (Cmd-A), |
| 163 |
the Control (Command) key and the A key at the same time when you are in the Manipulation |
| 164 |
panel. All items can be unselected by clicking in a empty spot of the Manipulation list |
| 165 |
(but not above or below the list), or by clicking on an already selected item. |
| 166 |
|
| 167 |
**Note:** If you have a set of selected items and wish to remove some, holding down the Control |
| 168 |
(Command) key and clicking on selected items will deselect them without affecting the other selected |
| 169 |
items. |
| 170 |
|
| 171 |
|
| 172 |
The top buttons of the Manipulation Panel |
| 173 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 174 |
|
| 175 |
The Manipulation Panel has a set of five buttons at the top of the panel. These buttons have the |
| 176 |
following effects, listed from left to right. |
| 177 |
|
| 178 |
*Show All* |
| 179 |
|
| 180 |
Clicking on the button that looks like an eye will show all scattering profiles. This is the |
| 181 |
same as if you manually set all of the show/hide checkboxes in the data items to on. |
| 182 |
|
| 183 |
*Hide All* |
| 184 |
|
| 185 |
Clicking on the button that looks like an eye with a red x through it will hide all scattering |
| 186 |
profiles. This is the same as if you manually set all of the show/hide checkboxes in the data |
| 187 |
items to off. |
| 188 |
|
| 189 |
*Select All* |
| 190 |
|
| 191 |
.. _manipselectall: |
| 192 |
|
| 193 |
Clicking on the button that looks like a spreadsheet with selected cells will select all of |
| 194 |
the Manipulation items. |
| 195 |
|
| 196 |
*Collapse All* |
| 197 |
|
| 198 |
Clicking on the button that looks like an upward pointing arrow with a box under it will |
| 199 |
collapse all of the data item controls. This is the same as if you manually toggled the |
| 200 |
Expand/Collapse button for each data item to the collapse position. |
| 201 |
|
| 202 |
*Expand All* |
| 203 |
|
| 204 |
Clicking on the button that looks like a downward pointing arrow with a box over it will |
| 205 |
expand all of the data item controls. This is the same as if you manually toggled the |
| 206 |
Expand/Collapse button for each data item to the expand position. |
| 207 |
|
| 208 |
|
| 209 |
Synchronizing settings for several data items |
| 210 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 211 |
|
| 212 |
Settings for several data items can be easily synchronized. |
| 213 |
|
| 214 |
#. Click the star icon on the data item you want the other items synchronized to. |
| 215 |
|
| 216 |
#. :ref:`Select <selectmanipitem>` one or more data items, you wish to synchronize with |
| 217 |
the starred item. |
| 218 |
|
| 219 |
#. Click the “Sync” button |
| 220 |
|
| 221 |
#. Select what parameters you want synchronized |
| 222 |
|
| 223 |
#. Hit the “OK” button |
| 224 |
|
| 225 |
Parameters that can be synchronized in this way are: q min, q max, n min, n max, scale, offset, |
| 226 |
line style, line width, and line marker. |
| 227 |
|
| 228 |
|
| 229 |
Renaming a data item |
| 230 |
~~~~~~~~~~~~~~~~~~~~ |
| 231 |
|
| 232 |
Data items can be renamed by selecting the data item of interest and selecting “Rename” in the |
| 233 |
right click popup menu. |
| 234 |
|
| 235 |
|
| 236 |
**Note:** While no characters are expressly forbidden in the filename, RAW does not sanitize |
| 237 |
file names before saving, and thus special characters such as ‘/’ and ‘\\’ are likely to cause |
| 238 |
problems when the file is saved. |
| 239 |
|
| 240 |
|
| 241 |
Saving data items |
| 242 |
~~~~~~~~~~~~~~~~~ |
| 243 |
|
| 244 |
.. _savingdata: |
| 245 |
|
| 246 |
All scattering profiles can be saved to a standard 3 column ASCII format with a header. To save: |
| 247 |
|
| 248 |
#. Select the item(s) to be saved. |
| 249 |
|
| 250 |
#. Click the “Save” button or select “Save selected file(s)” from the right click menu. |
| 251 |
|
| 252 |
#. In the window that pops up, navigate to the directory in which you want to save the files. |
| 253 |
|
| 254 |
#. If you are saving a single item, the window will give you an opportunity to rename |
| 255 |
your file if desired. Click “Save” when ready. |
| 256 |
|
| 257 |
#. If you are saving multiple items, you simply need to select the folder for the items to |
| 258 |
be saved in, and click “Open”. The items will be saved with the same names displayed |
| 259 |
in the Manipulation Panel, in the folder that you chose. |
| 260 |
|
| 261 |
Items are saved in a standard format with three columns of data. These columns have listed headers, |
| 262 |
and are Q, I, and Error in I respectively. Depending on your settings, at the bottom (default) or |
| 263 |
top of the file there will be a “Header”. This header contains any information loaded as ‘Header’ |
| 264 |
information from the image or separate header file, the normalization factor, any notes you made in |
| 265 |
the Notes section of the information box, any analysis results (such as Rg, MW), and the manipulation |
| 266 |
history saved by the averaging, subtracting, merging, rebinning, and interpolating functions (see |
| 267 |
following sections). |
| 268 |
|
| 269 |
The files are saved with a “.dat” extension, which is the standard for scattering profiles and |
| 270 |
can be read in by most standard SAXS processing software (including Scatter, Primus, and |
| 271 |
programs in the ATSAS package). The files are simply text files, and can be opened and viewed |
| 272 |
in any standard text editor. The header is saved in the JSON format. |
| 273 |
|
| 274 |
|
| 275 |
Removing data items from the manipulation list |
| 276 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 277 |
|
| 278 |
To remove one or more data items, select them and do one of the following: |
| 279 |
|
| 280 |
#. Press the “Delete” key on the keyboard |
| 281 |
|
| 282 |
#. Click the “Remove” button |
| 283 |
|
| 284 |
#. Select “Remove” from the right click menu |
| 285 |
|
| 286 |
|
| 287 |
Averaging data |
| 288 |
~~~~~~~~~~~~~~ |
| 289 |
|
| 290 |
.. _average: |
| 291 |
|
| 292 |
Averaging data is an important part of processing SAXS data. At the moment in RAW, |
| 293 |
data can only be averaged if the q vectors match exactly. To average data: |
| 294 |
|
| 295 |
#. :ref:`Select <selectmanipitem>` two or more data items that should be averaged. |
| 296 |
|
| 297 |
#. Either click the “Average” button or right-click on a selected item and choose |
| 298 |
“Average” from the popup menu. |
| 299 |
|
| 300 |
After averaging, a new data item will be displayed in the manipulation panel with the |
| 301 |
filename in green and an 'A\_' prefix. All averaged items are initially displayed on |
| 302 |
the top plot of the Main plot, regardless of where the items being averaged are displayed. |
| 303 |
|
| 304 |
A record of which profiles were averaged is saved in the metadata for the averaged |
| 305 |
profile. This can be viewed within RAW by right clicking on the item and selecting |
| 306 |
“Show history”, or externally if the scattering profile is saved as a .dat file and |
| 307 |
opened by an external text editor. This history contains all of the history of the |
| 308 |
individual files, so if you average a set of averaged (or subtracted) files, you can |
| 309 |
dig down through the metadata to see what files were used at each step. |
| 310 |
|
| 311 |
|
| 312 |
Subtracting data |
| 313 |
~~~~~~~~~~~~~~~~ |
| 314 |
|
| 315 |
.. _subtract: |
| 316 |
|
| 317 |
Subtracting data is an important part of processing SAXS data. RAW can handle subtracting |
| 318 |
data that has different q vectors, as long as there is a region of overlap between the q |
| 319 |
vectors. Data subtraction is done in the following way: |
| 320 |
|
| 321 |
#. Click the star icon on the data item to mark the scattering profile that should be |
| 322 |
used for subtraction (typically the background or buffer scattering profile). |
| 323 |
|
| 324 |
#. :ref:`Select <selectmanipitem>` another data item, or multiple items. |
| 325 |
|
| 326 |
#. Either click the “Subtract” button or right-click and select “Subtract” |
| 327 |
from the popup menu. Note: this subtracts the marked item (step 1) from the |
| 328 |
selected items (step 2). |
| 329 |
|
| 330 |
After subtraction, a new data item will be displayed in the Manipulation panel with the |
| 331 |
filename in red and a 'S\_' prefix. All subtracted items are initially displayed on the |
| 332 |
bottom plot of the main plot, regardless of where the items being subtracted are displayed. |
| 333 |
|
| 334 |
A record of which profiles were involved in the subtraction is saved in the metadata for |
| 335 |
the subtracted profile This can be viewed within RAW by right clicking on the item and |
| 336 |
selecting “Show history”, or externally if the scattering profile is saved as a .dat file |
| 337 |
and opened by an external text editor. This history contains all of the history of the |
| 338 |
individual files, so if you subtract a set of averaged (or subtracted) files, you can dig |
| 339 |
down through the metadata to see what files were used at each processing step. |
| 340 |
|
| 341 |
Data with different q vectors is handled as follows. First, the range of overlap is established. |
| 342 |
Second, RAW checks whether these overlapping regions have matching q vectors, if so, RAW carries |
| 343 |
out the subtraction. If not, RAW bins both curves so that the q vectors in the overlapping region |
| 344 |
match, and then carries out the subtraction. |
| 345 |
|
| 346 |
|
| 347 |
Superimposing data |
| 348 |
~~~~~~~~~~~~~~~~~~ |
| 349 |
|
| 350 |
.. _superimpose: |
| 351 |
|
| 352 |
Scattering profiles can be superimposed on each other automatically. This function tries to |
| 353 |
calculate a scale and an offset that minimizes difference between two or more curves using a |
| 354 |
least-squares method. To superimpose: |
| 355 |
|
| 356 |
#. Click the star icon on the data item you want the other items superimposed to. |
| 357 |
|
| 358 |
#. :ref:`Select <selectmanipitem>` one or more data items, that you wish to superimpose onto |
| 359 |
the starred item. |
| 360 |
|
| 361 |
#. Click the “Superimpose” button |
| 362 |
|
| 363 |
|
| 364 |
Merging data |
| 365 |
~~~~~~~~~~~~ |
| 366 |
|
| 367 |
.. _merge: |
| 368 |
|
| 369 |
Merging scattering profiles is typically done if you have measured multiple q ranges |
| 370 |
using different detectors. RAW can merge these profiles into one single profile. To merge |
| 371 |
profiles in RAW: |
| 372 |
|
| 373 |
#. Click the star icon on one of the curves. This items name will be used for the name |
| 374 |
of the merged item, otherwise it does not matter. |
| 375 |
|
| 376 |
#. :ref:`Select <selectmanipitem>` one or more data items, that you wish to merge together |
| 377 |
with the starred item |
| 378 |
|
| 379 |
#. Click the “Merge” button, select “Merge” from the right click menu, or select “Merge” |
| 380 |
from the Tools->Operations menu. |
| 381 |
|
| 382 |
After merging, a new data item will be displayed in the Manipulation panel with a filename |
| 383 |
with a 'M\_' prefix. All merged items are initially displayed on the top plot of the Main |
| 384 |
plot, regardless of where the items being merged are displayed. |
| 385 |
|
| 386 |
Merging will average together the overlapping regions, if any exist. It can be done on an |
| 387 |
arbitrary number of data items, and is done in serial. So first the two items with the two |
| 388 |
lowest q vectors are merged, then that item is merged with the data item with the next lowest |
| 389 |
q vector, and so on. For example, if you had selected items with a minimum q vector of 0.01, |
| 390 |
0.25, and 0.75, it would first merge the 0.01 and 0.25 items, and then merge that resulting |
| 391 |
item with the 0.75 item. |
| 392 |
|
| 393 |
A record of which profiles were merged is saved in the metadata for the averaged profile. |
| 394 |
This can be viewed within RAW by right clicking on the item and selecting “Show history”, |
| 395 |
or externally if the scattering profile is saved as a .dat file and opened by an external |
| 396 |
text editor. |
| 397 |
|
| 398 |
**Note:** If items are merged without an overlap region, there will simply be no data in |
| 399 |
those intervening points. |
| 400 |
|
| 401 |
|
| 402 |
Rebinning data |
| 403 |
~~~~~~~~~~~~~~ |
| 404 |
|
| 405 |
.. _rebin: |
| 406 |
|
| 407 |
Rebinning scattering profiles is typically done to improve signal to noise of individual |
| 408 |
points. As most scattering profiles are significantly oversampled (compared to the Shannon |
| 409 |
sampling frequency), there is no loss of information from doing this. To rebin curves in RAW: |
| 410 |
|
| 411 |
#. :ref:`Select <selectmanipitem>` one or more data items, that you wish to rebin with the |
| 412 |
same binning factor. |
| 413 |
|
| 414 |
#. Select “Rebin” from the right click menu, or select “Rebin” from the Tools->Operations menu. |
| 415 |
|
| 416 |
#. Select the bin reduction factor, and if you want logarithmic binning check the logarithmic |
| 417 |
box. Note: the log binning is log base 10. |
| 418 |
|
| 419 |
#. Click “OK”. |
| 420 |
|
| 421 |
After rebinning, a new data item will be displayed in the Manipulation panel with a filename |
| 422 |
with an 'R\_' prefix. All rebinned items are initially displayed on the top plot of the Main |
| 423 |
plot, regardless of where the items being rebinned are displayed. |
| 424 |
|
| 425 |
A record of which profiles were averaged is saved in the metadata for the rebinned profile. |
| 426 |
This can be viewed within RAW by right clicking on the item and selecting “Show history”, or |
| 427 |
externally if the scattering profile is saved as a .dat file and opened by an external text editor. |
| 428 |
|
| 429 |
**Note:** The bin reduction factor can be thought of as how many q points will go into a single |
| 430 |
bin in the new profile. So a bin reduction factor of 2 will result in half as many q points in |
| 431 |
the new profile, with each q point being the average of two q points from the previous profile |
| 432 |
(note that this may not quite be true for q points at the start and end of the profile). Rebinning |
| 433 |
will slightly reduce the q range of the scattering profile, as the new q value will be less than |
| 434 |
the extreme values in each bin. |
| 435 |
|
| 436 |
|
| 437 |
Interpolating data |
| 438 |
~~~~~~~~~~~~~~~~~~ |
| 439 |
|
| 440 |
.. _interpolate: |
| 441 |
|
| 442 |
RAW can interpolate a scattering profile to find values at all points in a reference q vector. This |
| 443 |
can be useful for creating scattering profiles with perfectly matched q-vectors. To interpolate |
| 444 |
curves in RAW: |
| 445 |
|
| 446 |
#. Click the star icon on the scattering profile you wish to interpolate to. The q vector |
| 447 |
for this profile will be used as the interpolation points for the other profile(s). |
| 448 |
|
| 449 |
#. :ref:`Select <selectmanipitem>` one or more data items, that you wish to interpolate to match |
| 450 |
the q vector of the starred item |
| 451 |
|
| 452 |
#. Select “Interpolate” from the right click menu, or select “Interpolate” from the Tools->Operations menu. |
| 453 |
|
| 454 |
After interpolating, a new data item will be displayed in the Manipulation panel with a |
| 455 |
filename with an 'I\_' prefix. All interpolated items are initially displayed on the top |
| 456 |
plot of the Main plot, regardless of where the items being merged are displayed. |
| 457 |
|
| 458 |
Interpolation works as follows: The overlapping q region is found for the two curves. |
| 459 |
Within this region, for every point in the q vector of the reference (starred) scattering |
| 460 |
profile an intensity value is found from the item being interpolated via linear interpolation |
| 461 |
(using the scipy.interpolate.interp1d function). A new scattering profile is then created |
| 462 |
from these interpolated values and the reference q vector. |
| 463 |
|
| 464 |
A record of which profiles were averaged is saved in the metadata for the averaged profile. |
| 465 |
This can be viewed within RAW by right clicking on the item and selecting “Show history”, |
| 466 |
or externally if the scattering profile is saved as a .dat file and opened by an external text editor. |
| 467 |
|
| 468 |
|
| 469 |
Converting q-scale |
| 470 |
~~~~~~~~~~~~~~~~~~ |
| 471 |
|
| 472 |
Q-values may sometimes be in inverse angstroms (1/Å), while others use inverse nanometers (1/nm). |
| 473 |
The q vector can be multiplied or divided by 10 to accommodate for this difference when comparing |
| 474 |
two curves on different q-scales. |
| 475 |
|
| 476 |
#. Select the data item(s) to be scaled and right-click on them. |
| 477 |
|
| 478 |
#. Select the “Convert q-scale” option and choose whether to adjust the q-scale upwards or |
| 479 |
downwards by a factor of 10. |
| 480 |
|
| 481 |
**Note:** All of the processing in RAW assumes that the scattering profiles are in inverse angstroms. |
| 482 |
|
| 483 |
|
| 484 |
Normalizing by concentration |
| 485 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 486 |
|
| 487 |
.. _normbyconc: |
| 488 |
|
| 489 |
The overall intensity of the scattering profile should be proportional to the concentration, |
| 490 |
so it can be useful to normalize scattering profiles by the measured concentration value. To do so: |
| 491 |
|
| 492 |
#. Set the concentration of the item in the :ref:`Information panel <infopanel>` or |
| 493 |
the :ref:`MW window <molweightwindow>`. |
| 494 |
|
| 495 |
#. Select the item to be normalized. |
| 496 |
|
| 497 |
#. Right click on the item and select “Normalize by conc” |
| 498 |
|
| 499 |
**Note:** This function simply calculates 1/conc and sets that value as the scale factor. This is |
| 500 |
equivalent to doing the same calculation and manually setting the scale factor of the scattering profile. |
| 501 |
|
| 502 |
|
| 503 |
Saving analysis results |
| 504 |
~~~~~~~~~~~~~~~~~~~~~~~ |
| 505 |
.. _saveresults: |
| 506 |
|
| 507 |
After analyzing the data using the Guinier, MW, BIFT, or GNOM panels, the resulting parameters |
| 508 |
such as Rg, I(0), MW, Dmax, and others can be saved to a comma separated format that easily loads |
| 509 |
into a spreadsheet program such as Excel. To do so: |
| 510 |
|
| 511 |
#. Select the data items of interest. |
| 512 |
|
| 513 |
#. Right-click on a selected data item and select “Save all analysis info” |
| 514 |
|
| 515 |
#. Choose a name and a location for the .csv file |
| 516 |
|
| 517 |
#. Load the .csv file into a spreadsheet program. |
| 518 |
|
| 519 |
This saves a spreadsheet where each row is an individual scattering profile, and each column |
| 520 |
an analysis parameter. |
| 521 |
|
| 522 |
|
| 523 |
Saving select data item information |
| 524 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 525 |
|
| 526 |
Information about data items including any analysis parameters, header file information, |
| 527 |
image header information, scale factor, offset, concentration, and notes can be selectively |
| 528 |
saved to a comma separated format that easily loads into a spreadsheet program such as Excel. |
| 529 |
To do so: |
| 530 |
|
| 531 |
#. Select the data items of interest |
| 532 |
|
| 533 |
#. Right-click on a selected data item and select “Save item info” |
| 534 |
|
| 535 |
#. A window will pop up with two panels. The panel on the left is all of the information available |
| 536 |
about the selected items, sorted into appropriate categories (such as Image Header and Guinier Analysis). |
| 537 |
|
| 538 |
#. In the window, select the information of interest in the left hand panel by clicking |
| 539 |
(including Ctrl and Shift clicking) on it. |
| 540 |
|
| 541 |
#. Once all of the variables of interest are selected (blue), click the “->” button to put them in the |
| 542 |
list of data that will be saved. They should appear in the right hand panel. |
| 543 |
|
| 544 |
#. If you accidentally selected an item, select the item and click the “<-“ button to remove it from |
| 545 |
the list of data to be saved. |
| 546 |
|
| 547 |
#. You can add additional items to the list by repeating steps 4 and 5 until everything you want |
| 548 |
to save is selected. |
| 549 |
|
| 550 |
#. Click the “OK” button. |
| 551 |
|
| 552 |
#. Choose a name and a location for the .csv file |
| 553 |
|
| 554 |
#. Load the .csv file into a spreadsheet program. |
| 555 |
|
| 556 |
This saves a spreadsheet where each row is an individual scattering profile, and each column one of |
| 557 |
the selected variables. |
| 558 |
|
| 559 |
**Note:** This differs from the save function described :ref:`above <saveresults>` in two ways. First, it |
| 560 |
allows you select which information you want to save. Second, it can save header information and |
| 561 |
other parameters about the scattering profile beyond the analysis information. |
| 562 |
|
| 563 |
|
| 564 |
Data point browsing |
| 565 |
~~~~~~~~~~~~~~~~~~~ |
| 566 |
|
| 567 |
The q, I, and I error values for each individual point in a scattering profile on the data |
| 568 |
curve can be inspected using the data browser. To do so: |
| 569 |
|
| 570 |
#. Right-click on the data item of interest. |
| 571 |
|
| 572 |
#. Select “Show data” in the popup menu. |
| 573 |
|
| 574 |
|
| 575 |
Displaying the detector image |
| 576 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 577 |
|
| 578 |
If the plotted data was loaded from an image, the image can be shown in the Image tab of |
| 579 |
RAW. To do so, right-click on the data item of interest and click “Show image” in the popup menu. |
| 580 |
|
| 581 |
|
| 582 |
Displaying the header information |
| 583 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 584 |
|
| 585 |
If the plotted data has header information, either from an image header or separate |
| 586 |
header file, this can be displayed in RAW. To do so, right-click on the data item of |
| 587 |
interest and click “Show header” in the popup menu. |
| 588 |
|
| 589 |
|
| 590 |
Displaying the history information |
| 591 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 592 |
|
| 593 |
If the plotted data has history information, either from integration of an image or from |
| 594 |
manipulation inside RAW such averaging or subtraction, this can be displayed in RAW. To do |
| 595 |
so, right-click on the data item of interest and click “Show history” in the popup menu. |
| 596 |
|
| 597 |
|
| 598 |
The Manipulation data item right click menu options |
| 599 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 600 |
|
| 601 |
.. _maniprightclick: |
| 602 |
|
| 603 |
When you right click on a data item, a popup menu is shown. This section describes what |
| 604 |
each item on the menu does. |
| 605 |
|
| 606 |
*Subtract* |
| 607 |
|
| 608 |
Carries out :ref:`subtraction <subtract>`. |
| 609 |
|
| 610 |
*Average* |
| 611 |
|
| 612 |
Carries out :ref:`averaging <average>`. |
| 613 |
|
| 614 |
*Merge* |
| 615 |
|
| 616 |
Carries out :ref:`merging <merge>`. |
| 617 |
|
| 618 |
*Rebin* |
| 619 |
|
| 620 |
Carries out :ref:`rebinning <rebin>`. |
| 621 |
|
| 622 |
*Interpolate* |
| 623 |
|
| 624 |
Carries out :ref:`interpolation <interpolate>`. |
| 625 |
|
| 626 |
*Use as MW Standard* |
| 627 |
|
| 628 |
.. _mwstandard: |
| 629 |
|
| 630 |
Sets the selected item to be the MW standard used in the :ref:`I(0) reference MW <molweightmethods>` |
| 631 |
calculation method. To do this the concentration must be set, for example |
| 632 |
in the Information Panel (it can also be set in the MW panel). A Guinier fit must also |
| 633 |
have been done, as this requires a known I(0) value for the reference scattering profile. |
| 634 |
In the popup window that opens, enter the known protein MW in units of kDa. |
| 635 |
|
| 636 |
*Normalize by conc* |
| 637 |
|
| 638 |
:ref:`Normalizes the profile by the concentration <normbyconc>`. |
| 639 |
|
| 640 |
*Remove* |
| 641 |
|
| 642 |
Removes the item. |
| 643 |
|
| 644 |
*Guinier fit* |
| 645 |
|
| 646 |
Opens the Guinier fit analysis panel for the selected scattering profile. |
| 647 |
|
| 648 |
*Molecular Weight* |
| 649 |
|
| 650 |
Opens the molecular weight analysis panel for the selected scattering profile. |
| 651 |
|
| 652 |
*BIFT* |
| 653 |
|
| 654 |
Opens the Bayesian indirect Fourier transform (BIFT) analysis panel for the selected scattering profile. |
| 655 |
|
| 656 |
*GNOM (ATSAS)* |
| 657 |
|
| 658 |
Opens the GNOM analysis panel for the selected scattering profile. Note: this option is |
| 659 |
only available if RAW has detected a valid ATSAS package installation. |
| 660 |
|
| 661 |
*SVD* |
| 662 |
|
| 663 |
Opens the singular value decomposition (SVD) analysis panel for the selected scattering |
| 664 |
profiles (must have at least 2 profiles selected). |
| 665 |
|
| 666 |
*EFA* |
| 667 |
|
| 668 |
Opens the evolving factor analysis (EFA) panel for the selected scattering profiles |
| 669 |
(must have at least 2 profiles selected). |
| 670 |
|
| 671 |
*Convert q-scale* |
| 672 |
|
| 673 |
Has a submenu with two options: **q * 10** which multiples the scattering profile q vector |
| 674 |
by a factor of 10, and **q / 10** which divides the scattering profile q vector by a factor of 10. |
| 675 |
|
| 676 |
*Show image* |
| 677 |
|
| 678 |
If the scattering profile was integrated from an image, and the image is still in the same |
| 679 |
location as when the profile was first integrated, it displays the image in the Image Plot |
| 680 |
Panel. |
| 681 |
|
| 682 |
*Show data* |
| 683 |
|
| 684 |
Shows the q, I(q) and I_error(q) data. |
| 685 |
|
| 686 |
*Show header* |
| 687 |
|
| 688 |
Shows the header information. |
| 689 |
|
| 690 |
*Show history* |
| 691 |
|
| 692 |
This shows the history of the scattering profile. |
| 693 |
|
| 694 |
*Move to top plot* |
| 695 |
|
| 696 |
Moves the scattering profile to the top subplot of the Main plot (no effect if the |
| 697 |
scattering profile is already plotted on the top plot). |
| 698 |
|
| 699 |
*Move to bottom plot* |
| 700 |
|
| 701 |
Moves the scattering profile to the bottom subplot of the Main plot (no effect if the |
| 702 |
scattering profile is already plotted on the top plot). |
| 703 |
|
| 704 |
*Save all analysis info* |
| 705 |
|
| 706 |
Saves all of the analysis info of the selected data item(s). |
| 707 |
|
| 708 |
*Save item info* |
| 709 |
|
| 710 |
Saves select item info. |
| 711 |
|
| 712 |
*Save selected file(s)* |
| 713 |
|
| 714 |
Saves the selected data item(s). |
| 715 |
|
| 716 |
|
| 717 |
The Manipulation panel bottom buttons |
| 718 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 719 |
|
| 720 |
There are six buttons at the bottom of the Manipulation panel. They are: |
| 721 |
|
| 722 |
*Save* |
| 723 |
|
| 724 |
This button saves the selected data item(s). |
| 725 |
|
| 726 |
*Sync* |
| 727 |
|
| 728 |
This button syncs the settings of the selected data item(s) to the starred data item. |
| 729 |
|
| 730 |
*Remove* |
| 731 |
|
| 732 |
This button removes the selected data item(s) from the Manipulation panel. |
| 733 |
|
| 734 |
*Superimpose* |
| 735 |
|
| 736 |
This button superimposes the selected data item(s) onto the starred data |
| 737 |
item. |
| 738 |
|
| 739 |
*Average* |
| 740 |
|
| 741 |
This button averages the selected data item(s). |
| 742 |
|
| 743 |
*Subtract* |
| 744 |
|
| 745 |
This button subtracts the selected data item(s). |
| 746 |
|
| 747 |
|
| 748 |
The Main Plot window |
| 749 |
-------------------- |
| 750 |
|
| 751 |
The Main Plot window displays individual scattering profiles associated with |
| 752 |
items in the Manipulation panel. It has two subplots, which by default are |
| 753 |
titled “Main Plot” (top) and “Subtracted” (bottom). Any item that is initially |
| 754 |
loaded is plotted on the top plot. |
| 755 |
|
| 756 |
|
| 757 |
The features that are general between all of the plots are described :ref:`elsewhere <genplotpanel>`. |
| 758 |
This section will describe features unique to this plot. |
| 759 |
|
| 760 |
|
| 761 |
Changing axes and plot types |
| 762 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 763 |
|
| 764 |
.. _manipplottypes: |
| 765 |
|
| 766 |
Right-click in the plot window to view a pop-up menu with different axis settings. |
| 767 |
|
| 768 |
The available plot modes are: |
| 769 |
|
| 770 |
* Lin-Lin |
| 771 |
|
| 772 |
* Log-Lin |
| 773 |
|
| 774 |
* Log-Log |
| 775 |
|
| 776 |
* Lin-Log |
| 777 |
|
| 778 |
* Guinier plot (ln(I(q)) vs. q\ :sup:`2`\ ) |
| 779 |
|
| 780 |
* Porod plot (q\ :sup:`4`\ I(q) vs. q) |
| 781 |
|
| 782 |
* Kratky plot (q\ :sup:`2`\ I(q) vs. q) |
| 783 |
|
| 784 |
|
| 785 |
The Main plot toolbar |
| 786 |
~~~~~~~~~~~~~~~~~~~~~ |
| 787 |
|
| 788 |
In addition to the plot toolbar buttons :ref:`shared by all of the plots <navbar>`, the Main |
| 789 |
plot has the following buttons: |
| 790 |
|
| 791 |
|100000000000002200000021727FD1590D192861_png| |
| 792 |
|
| 793 |
Toggle errorbars. Shows the errorbars on the plotted curves. |
| 794 |
|
| 795 |
|100000000000001F00000021D9FCD008A5DADBD2_png| |
| 796 |
|
| 797 |
Top/Bottom plot. Shows both the top and the bottom plot. |
| 798 |
|
| 799 |
|100000000000001F00000020F81C3AA753AFD388_png| |
| 800 |
|
| 801 |
Top plot. Shows only the top plot. |
| 802 |
|
| 803 |
|1000000000000022000000213F375FFE6DB9D8A9_png| |
| 804 |
|
| 805 |
Bottom plot. Shows only the bottom plot. |
| 806 |
|
| 807 |
|
| 808 |
Moving profiles between plots |
| 809 |
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 810 |
|
| 811 |
Scattering profiles can be moved between the top and bottom plots. To do so: |
| 812 |
|
| 813 |
#. Select the data item(s) of interest in the Manipulation panel. |
| 814 |
|
| 815 |
#. Right-click on a selected data item and select “Move to top plot” or |
| 816 |
“Move to bottom plot” from the popup menu. |
| 817 |
|
| 818 |
|
| 819 |
Setting the legend label |
| 820 |
~~~~~~~~~~~~~~~~~~~~~~~~ |
| 821 |
|
| 822 |
Instead of the filename showing in the legend, a special label can be created for that data item. |
| 823 |
|
| 824 |
#. Click on the :ref:`Line Properties <maniplineprop>` button of the data item. |
| 825 |
|
| 826 |
#. In the Line Properties window that pops up, enter the desired legend label in the Legend Label box. |
| 827 |
|
| 828 |
#. Click “OK”. |
| 829 |
|
| 830 |
The new legend label will be shown in [square brackets] next to the data item name. To revert to t |
| 831 |
he standard label (the filename), erase the custom label. |
| 832 |
|
| 833 |
|
| 834 |
Locating data items |
| 835 |
~~~~~~~~~~~~~~~~~~~ |
| 836 |
|
| 837 |
The data item associated with a plotted scattering profile can be quickly found by clicking |
| 838 |
plotted curve. When a curve is clicked on, it will flash ‘bold’ (increased line weight), and |
| 839 |
the associated data item will be selected in the Manipulation panel. |
| 840 |
|
| 841 |
**Note:** If there are other selected items in the Manipulation panel, they will be unselected. |
| 842 |
|
| 843 |
|
| 844 |
.. |100000000000001F00000020F81C3AA753AFD388_png| image:: images/100000000000001F00000020F81C3AA753AFD388.png |
| 845 |
|
| 846 |
|
| 847 |
.. |100000000000001F00000021D9FCD008A5DADBD2_png| image:: images/100000000000001F00000021D9FCD008A5DADBD2.png |
| 848 |
|
| 849 |
|
| 850 |
.. |1000000000000022000000213F375FFE6DB9D8A9_png| image:: images/1000000000000022000000213F375FFE6DB9D8A9.png |
| 851 |
|
| 852 |
|
| 853 |
.. |100000000000002200000021727FD1590D192861_png| image:: images/100000000000002200000021727FD1590D192861.png |
| 854 |
|