Debian Codegraph @

docs/source/manual/The_Files_tab_in_the_Control_Panel.rst

raw
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