3.2) The Data Selection Windows

3.2.1) The PIA Files Control Window

This Window serves to control the selecting and reading of files into the buffers. It is reached from the PIA Main Window via the pull down menu "Files" and select the "FileView" menu item.

This chapter describes the PIA Files Control Window shown in Figure 1 and all its related items.


FIGURE 1: The PIA Files and Buffer Control Window


Basically the window may be divided into four rows:

  1. The top line: It contains the menu buttons.
  2. The upper row: It contains selection boxes for file type, detector and various data formats.
  3. The middle row: It contains selection boxes for directories, file names and various buttons for various actions like reading files and showing file information.
  4. The bottom line: It display warning messages and other useful information.


The Top Line

It has the following menu buttons:

Quit

Closes the window.

Note that the actual measurement data remain in the buffer and can be recalled at any time causing this window to pop up again.

Help

Calls the present page of the PIA User Manual.


The Upper Row

This row serves for the preselection for the filenames. This is done via three criteria:

File Type:

This selection box offers the various file types.

Detectors:

This selection box offers the various detectors.

Select Files From:

These selection buttons switch between the various file formats. The directory which is searched for is displayed in the righthand field.

There are three file formats to be chosen from:

Filters:

This field displays the filename pattern for which the directoy is scanned. You can change the file filters to select the set of files.


The Middle Row

This row serves to select a file in order to either read it into the measurements buffers or to display some information corresponding to it (eg its header contents).

Subdirectories:

This selection box allows the directory to be modified and is then used for scanning for the files with the filename filter pattern shown in the filter box. The modification can be done only step by step one directory up or down within the directory tree. The full pathname of the selected directory is displayed in the field to the righthand side of the selection buttons in the upper row.

Files:

This selection box lists the files according to the preselection above.

Note that a file has to be selected explicitly by clicking on it with the mouse.

Read Multiple Files

This radio button switches between the two modes:

  1. Reading only the selected file from the file selection box.
  2. Select first several files and then read them at once.

Depending if the read multiple files mode is selected or not, the description of a button for marking a file as selected reads Add file => or Read File.

Show File Info

This radio button switches on/off of the following mode:

  1. Enable or disable showing the FITS file information at the panel below the show header button when the file is selected. It shows the number of rows and columns in the FITS file.

Read File / Add File =>

This action button starts reading the selected file in case of single files reading, or adds the selected file into the righthand selection box in case of multiple files reading.

Show Header

This action button displays the header of the selected file (both for FITS or internal files). Note that the files corresponding to higher level of reduction (SRD, SCP,...) include information about the processing steps which were already performed, parameters used, etc (the lines begin with "PR...").

Selected Files for Reading

This selection box is used for the multiple file reading. It displays the filenames of the selected files.

Read All

This action button starts reading all the files displayed in the selection box above.

Remove

This action button removes the marked file from the selection box above.


The Bottom Line

It displays informative or warning messages.


Chapter history:

Date Author Description
15/05/1996 Martin Haas (MPIA) First Version
23/05/1996 Wai-Ming Tai (DIAS) Updated Version
10/06/1997 Carlos Gabriel (ESA/VILSPA-SAI) Update (V6.3)
15/10/1997 Carlos Gabriel (ESA/VILSPA-SAI) Update (V6.5)