3.3.5) The PIA AAP Window

The PIA AAP Window serves to visualize and control the AAP level, including some corrections. It can be reached via the button "Plot and Reduce Data" in the menu of the PIA Measurement Buffer Control Panel. Note that this window is not displayed automatically when processing data from the PIA SPD Data Display Window, but when processing data from the SCP label. The maximum number of opened AAP Windows is restricted to two. Both open at the same time when processing PHT-S data from SCP to AAP, containing the data corresponding to the 64 short wavelength detectors on one and data corresponding to the 64 long wavelength detectors on the other.

This chapter describes the PIA AAP Data Display window and sub-windows directly associated.

Basically, the AAP window (Figure 1) is divided into three rows:

• The upper row: It contains control buttons, main measurement information and in the case of a C100 or C200 measurement detector array pixel buttons.
• The middle row: It shows a number of plots (up to 4) and associated buttons, acting on the displayed plots or the data displayed in the corresponding plot.
• The lower row: It contains several data handling and processing buttons, acting on the whole measurement. It includes a button to chose the number of plots in the middle row.

---

FIGURE 1: The PIA AAP Window 

---

Remark on Upper and Middle Row:

Since the upper row and the middle row are very similar to those of the ERD Window, the user is referred to the ERD description with the following differences for the middle row:

1. Menu bar on top: The submenu offers the following possibilities:
• Mean Flux Density [Jy / beam ] - for the C-arrays; [Jy] for P/PHT-S
• Median Flux Density [Jy / beam] - for the C-arrays; [Jy] for P/PHT-S
• First Quartile Flux Density [Jy / beam ] - for the C-arrays; [Jy] for P/PHT-S
• Third Quartile Flux Density [Jy / beam ] - for the C-arrays; [Jy] for P/PHT-S
• Mean Surface Brightness [MJy / sr]
• Median Surface Brightness [MJy / sr]
• First Quartile Surface Brightness [MJy / sr]
• Third Quartile Surface Brightness [MJy / sr]
• Chopper Position [arcsec]
• Flag
• Raster Point ID
• Declination
• Right Ascension

---

The lower row

Data

This menu bar calls a submenu with the following options:

• Load: This calls the window Please Select a Measurement in order to load a new measurement into the SPD window, activating it for plotting and reduction. The measurement which was displayed still remains in the buffer, but is deactivated from this window.
• Save:
• To AAP buffer: this option can be used for putting the modified data present on the window into the dynamical buffer, together with all the modifications. The same position in the buffer can be used, thus overwriting the data which entered the window, or a new position, creating a new measurement in the general buffer. This allows for a re-call of the corrected data in a later stage, opening again the AAP window.
• to PIA internal file: this calls Please Select a File for Writing window and asks a filename (and directory) under which the data shall be saved (a default name is proposed) in internal PIA format. This gives the possibility of saving the same measurement differently corrected several times, avoiding confusion (several versions in the case of VMS files) or overwriting (in the case of UNIX).

If the associated Compact Status file with the appropriate filename is not found in the directory chosen for saving the file, it will be saved automatically, also in internal format. This makes it possible to reload the data in a later session without loading the data from the FITS files.
• to FITS external file: this saves the measurement in FITS format under the default or user-specified name.  This also lets you choose the contents for the FITS file via a pop-up GUI.
• to special PHT-S FITS: this option is available only for PHT-S measurements, and the content of the resulting FITS file more closely resembles the phtiaap structure.  For example, it has a full header very similar to the header in the phtiaap structure, and it contains most of the phtiaap structure fields including those quartile values.  Also, the resulting FITS file can be read by ISAP, ISO Spectral Analysis Package .
• Print Flux Values: This calls a text window displaying the main AAP results (flux and surface brightness pro detector pixel and raster point and/or chopper plateau) with the possibility of printing or storing the output on file.
• Show Data: This calls the Show Structures -Plot Curves Menu (s.3.4.4) for a complete access to the measurement buffer, allowing for plots, correlations, etc.

Selection

This menu bar calls a submenu with the single option:

• Discard Chopper Plateaux: This calls the PIA Chopper Plateau Selection Window in order to enter which chopper plateaux shall be discarded.


After selection the plots of the AAP Window will be restored with the discarded chopper plateaux being marked by different symbols, depending on the plot symbol style. Note that the selection criteria chosen remain active for all further processing steps within a session until they are modified again. They particularly affect all the pixels of the array detectors. It is not possible by this menu to set the parameters individually for each pixel or a group of pixels.

Corrections

• Assign astronomical coordinates: normally the AAP data contains already the coordinates. But if during the reduction the IRPH file was not found (because the FITS directory which was pointed to did not contain it) the coordinates will be missed at this stage. Changing the FITS directory definition and afterwards pressing this button solves the proble
  wi
• Signal losses in chopped measurements: This option is only active for subtracted chopped measurements which have not been processed by the default "Ramp Pattern" procedure. It corrects for the losses by a subtracted signal from chopping between two fluxes.
• Flat Fielding: median filtering + background: This option allows the user to perform baseline drift corrections and to obtain flat-field factors for C100 and C200 data correcting it. For a full explanation please refer to "The PIA mapping median filtering, smoothing and flat-fielding window" in the PIA Mapping Software section.
• Flat Fielding: normalizing with first Quartile: A very simple way of flat-fielding PHT-C100 and -C200 data, performing a normalization using the computed first Quartiles per detector pixel, as representative for the background. Specially suited for mini-maps.

View

This menu bar calls a submenu for obtaining the following information:

• Header Info: displays FITS header information of the corresponding measurement (including logs of the corrections performed by PIA to the data).
• Compact Status: displays information on instrument configuration present on the Compact Status file of the corresponding measurement.
• Auxiliary Files:
• IS Report: Instrument Station report recorded during the on-line monitoring of the displayed measurement (entries in PISR-FITS files).
• OLP Report: information recorded during the off-line pipeline processing of the displayed measurement (entries in the POLR-FITS files).
• EOHA: Edited Observation History Attributes corresponding to the measurement.
• EOHI: Edited Observation History Information corresponding to the measurement.

Array

This menu bar calls a submenu with additional features for array data. It offers the following options:

• Images: This allows the signal values of all array pixels (for C100, C200) to be viewed in one single plot per raster point. In case of a raster or scanning mode the user is asked for the raster point and chopper plateau to be taken. A PIA XSurface Window is created.
• Spectra: This allows the signal values of all pixels (for PHT-S) to be viewed in one single plot per raster point. A PIA XPlot Window is created.
• Time evolution: This allows the signal values versus pixel number (for C100, C200 and PHT-S) to be viewed in one single plot:
• Time Slices: Calls a PIA Xplot Window to plot histogram of signals versus pixel number for each time step (in different colors),
• 3D View: Calls a PIA XSurface Window to plot a 3D-histogram of signals versus pixel number and time step.

Process

This menu bar calls a submenu in order to process the whole measurement to the next level. The submenu offers the following possibilities:

• Background Subtraction:
• within measurement: This applies only for chopped measurements, which have not been subtracted on an earlier stage. First the chopper steps are plotted in a new PIA XPLOT window. Then the PIA Background Subtraction Window (s.3.3.6) is launched. The background  subtraction is performed within this new window and the result is present in the AAP buffer.

• another measurement: This calls the Window Please Select a Measurement in order to select a background measurement. After selection the subtraction will immediately be performed and the result is present in the AAP buffer.

 

 

NOTE: When returning to the AAP Window the background-subtracted values are not automatically loaded into this window. It is necessary to load them explicitly via the menu button "Data" and "Load" (the new measurement name has the suffix "subtracted").
• Concatenate with a measurement: this option allows for producing a pseudo measurement containing the data from two or several measurements. In this way a very easy concatenation of raster measurements can be performed from which a map mosaic can be derived. This is the option allowing for concatenating all the measurements performed in a sparse map, but it is not restricted to them. Note that it should not be used with P32 observations because of the influence of the chopper.
• as an easy mean for calibration normalisation a median of all signals per measurement can be used to adjust the values from different measurements.

Pixels Choice

This menu bar is active only for C100, C200 and PHT-S data where several pixels are to be analyzed. It calls a submenu with the following options:

Individual Choice: This calls the PIA Display Choice window. For each display window the user can specify the pixel number whose signal will be plotted. After the selection the window will be restored with the plots for the new pixels chosen.

Serial Increment: This selects the next subsequent pixel to each of those shown. When pressing this button, the signal corresponding to pixel N+1 will be plotted in each window containing pixel N.

N Plots

This button allows the number N of plot windows shown in the middle row of the SCP window to be selected. After a selection the window will immediately be restored, containing N plots. Please note that this number will also be used for further main level windows.

HK

This button calls a submenu for accessing the Housekeeping Menu to display the Housekeeping data associated to this measurement, as contained in the corresponding GEHK FITS product.

---

The associated windows

The PIA Chopper Plateau Selection Window

It is the same as described for the SCP Window: see the PIA Chopper Plateau Selection Window in section 3.3.3.

---

 

Chapter history:

Date	Author	Description
13/02/1998	Carlos Gabriel (ESA/VILSPA - SAI)	First Version (V7.0)
23/08/1999	Carlos Gabriel (ESA/VILSPA - SAI)	Update (V8.0)
27/06/2000	CG [input: Min Hur (IPAC)]	Update (V9.0)