| 1 |
The Files tab in the Control Panel |
| 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 |
.. _filepanel: |
| 9 |
|
| 10 |
Changing file directories |
| 11 |
------------------------- |
| 12 |
|
| 13 |
There are three ways to change the directory whose contents are displayed in the Files tab: |
| 14 |
|
| 15 |
* Click on the folder icon next to the bar to open a directory window. This allows you to |
| 16 |
select the directory you want to display. |
| 17 |
|
| 18 |
* Type a path into the bar at the top of the Files tab and hit enter to go to a directory. |
| 19 |
|
| 20 |
* Double click the up arrow in the File list (blue arrow with a filename of ‘..’) to navigate |
| 21 |
up a directory level. Double click on any displayed directory to open it and show the contents |
| 22 |
in the Files tab. |
| 23 |
|
| 24 |
**Note:** The Files tab simply displays the files in your system. None of these files are loaded into |
| 25 |
RAW until you take some action on them (for example, :ref:`plotting them <plotfiles>`) |
| 26 |
|
| 27 |
|
| 28 |
Updating the file list |
| 29 |
---------------------- |
| 30 |
|
| 31 |
The file list in the Files tab does not automatically update when new files are placed in the folder. |
| 32 |
In order to update the file list to show new files, you must click the Refresh button (two green arrows |
| 33 |
in a circle) to the right of the Folder button near the top right of the Files tab. |
| 34 |
|
| 35 |
|
| 36 |
Plotting files |
| 37 |
-------------- |
| 38 |
|
| 39 |
.. _plotfiles: |
| 40 |
|
| 41 |
Plotting is done from the Files tab in the Control Panel. It can be done in two ways: |
| 42 |
|
| 43 |
#. Simply double-click an image, compatible ASCII file, or RAW sec file to plot it. |
| 44 |
|
| 45 |
#. Select one or more files to be plotted at the same time and click the “Plot” button |
| 46 |
|
| 47 |
The Calibration, Normalization, Masking, and other Advanced Options will be used to convert |
| 48 |
images into one dimensional scattering profiles when an image is selected and plotted. The |
| 49 |
Normalization settings, including absolute scale factor, counter norms, and solid angle |
| 50 |
correction status, the configuration file used, and the image load path are saved as part |
| 51 |
of the manipulation history for a scattering profile in RAW created from an image. |
| 52 |
|
| 53 |
**Note 1:** Selecting files is as simple as left clicking on them. Multiple files can be |
| 54 |
selected by shift or ctrl (command on OS X) left clicking on the files. |
| 55 |
|
| 56 |
**Note 2:** Some image files can only be loaded if the image type in the Advanced Options |
| 57 |
is set appropriately. |
| 58 |
|
| 59 |
|
| 60 |
Filtering and searching the file list |
| 61 |
------------------------------------- |
| 62 |
|
| 63 |
Below the file list is a filter/search bar. You can either select filters |
| 64 |
from a list or create your own using wildcard characters. The filter bar accepts ‘\*’ as a wildcard |
| 65 |
matching any number of characters and ‘?’ as a wildcard matching a single character. |
| 66 |
|
| 67 |
Examples: |
| 68 |
|
| 69 |
* If you were looking for all files with ‘BSA’ anywhere in the filename you would write: \*BSA\* |
| 70 |
in the filter/search bar. The two \* wildcard matches any characters before and after the ‘BSA’. |
| 71 |
|
| 72 |
* If you wanted all files with ‘BSA’ at the start of the filename you would write BSA\* |
| 73 |
in the filter/search bar. The single \* wildcard will match any characters after the ‘BSA’. |
| 74 |
|
| 75 |
* If you wanted all of the files with ‘BSA’ at the start of the filename and ‘.tiff’ at the end of |
| 76 |
the filename you would write **BSA\*.tiff**. The single \* wildcard will match any characters |
| 77 |
between BSA and .tiff in the filename. |
| 78 |
|
| 79 |
* If you wanted all of the files with ‘BSA_000x.tiff’ where x is a single character, you would write |
| 80 |
**BSA_000?.tiff**. The ? wildcard will match any single alphanumeric character in that position. |
| 81 |
|
| 82 |
|
| 83 |
Sorting the file list |
| 84 |
--------------------- |
| 85 |
|
| 86 |
The columns at the top of the file list, Name, Ext, Modified and Size, show the file name, the |
| 87 |
file extension, the file modified time, and the file size respectively. By clicking on the column |
| 88 |
heading, you can sort the file list by those attributes. By default, the file list is sorted by |
| 89 |
name, ascending (low to high, A to Z). This is indicated by the upward pointing green arrow in the |
| 90 |
Name column heading. Clicking on the Name column heading will switch the order of the sort to |
| 91 |
descending (high to low, Z to A) sort. Clicking again will return it to the ascending sort. Clicking |
| 92 |
on another column heading will sort the file list by that column, and again can be switched between |
| 93 |
ascending and descending. |
| 94 |
|
| 95 |
|
| 96 |
Files tab buttons |
| 97 |
----------------- |
| 98 |
|
| 99 |
Quick reduce |
| 100 |
~~~~~~~~~~~~ |
| 101 |
|
| 102 |
Processes selected images and save them to ASCII files without plotting the scattering profiles using |
| 103 |
the integration parameters (calibration, masking, etc) current set in RAW. |
| 104 |
|
| 105 |
|
| 106 |
System Viewer |
| 107 |
~~~~~~~~~~~~~ |
| 108 |
|
| 109 |
Attempts to open/run the selected file using whatever software is set up in the operating system to |
| 110 |
handle the file format. You can use the 'E' keyboard key as a shortcut. |
| 111 |
|
| 112 |
|
| 113 |
Plot |
| 114 |
~~~~ |
| 115 |
|
| 116 |
This plots the selected files in RAW, assuming the formats can be read by RAW. If the files are |
| 117 |
images, they will be integrated into one dimensional scattering profiles using the integration |
| 118 |
parameters (calibration, masking, etc) set in RAW. Files are shown in the following locations: |
| 119 |
|
| 120 |
* Images (which RAW integrates) and 1D scattering profiles (typically “.dat” files) opened by |
| 121 |
RAW display in the Main Plot tab of the Plot panel. The Manipulation panel shows the items |
| 122 |
in the Main Plot and lets change and process the curves individually. |
| 123 |
|
| 124 |
* IFT files (.out and .ift extensions) are loaded into the IFT Plot Panel of RAW. The IFT panel |
| 125 |
in the Control Panel shows the items in the IFT Plot and lets you change and process the curves |
| 126 |
individually. |
| 127 |
|
| 128 |
* SEC files (.sec extensions) are loaded into the SEC Plot Panel of RAW. The SEC panel in the Control |
| 129 |
Panel shows the items in the SEC plot and lets you change and process the curves individually. |
| 130 |
|
| 131 |
**Note:** If a file has previously been saved from RAW, all of the saved information (see later sections) |
| 132 |
will be loaded when the file is reloaded. For example, if a subtracted scattering profile had a Guinier |
| 133 |
analysis performed on it and was saved as a “.dat” file, when that saved file is loaded back into RAW, |
| 134 |
the Rg and I(0) values will be loaded as well. |
| 135 |
|
| 136 |
|
| 137 |
Show image |
| 138 |
~~~~~~~~~~ |
| 139 |
|
| 140 |
.. _showimage: |
| 141 |
|
| 142 |
Shows the image selected in the file list in RAW’s image plot. You can use the 'S' keyboard key as a |
| 143 |
shortcut. |
| 144 |
|
| 145 |
**Note:** If multiple files are selected, the image shown is from the first file in the list. |
| 146 |
|
| 147 |
|
| 148 |
Clear all |
| 149 |
~~~~~~~~~ |
| 150 |
|
| 151 |
Resets and clears all plots and also clears the item lists in the Manipulation, IFT, and SEC tab. |
| 152 |
|
| 153 |
|
| 154 |
Plot SEC |
| 155 |
~~~~~~~~ |
| 156 |
|
| 157 |
The “Plot SEC” button plots the selected images and/or 1D scattering profiles as a |
| 158 |
:ref:`SEC curve <secplot>`. The images are integrated into 1D scattering profiles. |
| 159 |
|
| 160 |
**Note:** This button can also be used to plot files with the .sec extension that have previously been |
| 161 |
saved by RAW. |
| 162 |
|
| 163 |
|
| 164 |
Manipulating files and folders |
| 165 |
------------------------------ |
| 166 |
|
| 167 |
Files and folders can be manipulated in the Files tab by right clicking on a filename in the file list. |
| 168 |
The pop-up menu has the options to create a new folder, rename a file, copy/cut/paste file(s) or delete |
| 169 |
file(s). |
| 170 |
|
| 171 |
**Note:** These options change the files on disk, not just in RAW! So if you delete a file here, it |
| 172 |
will be deleted from your disk. If you want to work with the files you have loaded into RAW, see the |
| 173 |
sections on the :ref:`Manipulation <manippanel>`, :ref:`IFT <iftpanel>`, and |
| 174 |
:ref:`SEC Control Panels <secplot>`. |
| 175 |
|