Appendix B: Internal PIA Buffer Structure Definitions

<!-- crb ini -->
<?php
//phpinfo();
include($_SERVER["DOCUMENT_ROOT"]."/iso/iso_cab.php");
include("this_cab.php"); ?>
<!-- crb end -->

<h1>
Appendix B: Internal PIA Buffer Structure Definitions</h1>
This section lists the definitions of the PIA internal structures, phterd,
phtsrd, phtscp, phtspd, phtaad, phtcs and phtcla. The related common block
can be made available to the IDL environment by the IDL include symbol,
e.g. executing @phterd from the IDL prompt. This will make the ERD Data
structure as defined below avaliable for use under the IDL interactve line
interface environment. For more information on how to access the internal
buffers please refer to chapter 6, <a href="pia_idl_IF.html">Advanced PIA
use - working interactively...</a>
<p>Please note that the common block is an array of structures containing
several 'real' variables (in string, integer, real format) and several
pointers ('handles' in IDL language) to one- and two-dimensional arrays.
In this way a flat architecture is achieved, even for variables representing
one- or two-dimensional arrays of different sizes, according to the sub-instrument
(e.g. the variable phterd.conp is a one-dimensional array with a length
n given by the number of read-outs for a PHT-P1 measurement, while it is
an (11,n) array for a PHT-C100 measurement. The first dimension given by
the 9 detector pixels plus open plus resistor pixel).
<h3>
<a NAME="phterd"></a>PHTERD - Edited Raw Data</h3>

<pre>Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Acquisition date
DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
ORDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Position within the TDT
DIMS&nbsp;&nbsp;&nbsp; Long integer&nbsp;&nbsp;&nbsp; Total number of read-outs
TINT&nbsp;&nbsp;&nbsp; Real&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Integration time
NNDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of non destructive read-outs / ramp
RCHP&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of ramps / chopper plateau
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
RAWP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Unconverted read-out data (DIE output) (Int {p,n}-array)
CONP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Converted read-out data [V] (Real {p,n}-array)
FITV&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Fitted voltages [V] (filled after processing to SRD)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)
TIME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (Real {p,n}-array)
PIXF&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Bit Flags (Int n-array)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; On-target flag
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Read-out status
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper sign
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper on-position flag
CHOP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper position [arcsec] (Int n-array)
STEP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
FCSN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Fine Calibration Source FCS selected (Int n-array)
TEMP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Temperature&nbsp; [K] (Real n-array)
FCS1&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS1 electrical power&nbsp; [mW] (Real n-array)
FCS2&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS2 electrical power&nbsp; [mW] (Real n-array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
RPID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Raster point ID (Byte (2,n)-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIA bitflags (Int {p,n}-array) [See <a href="#flagdef">Flag definitions</a>]

p: number of pixels (P1,P2,P3 = 1, C100=11, C200=6, SS/SL=132)
n: number of read-outs (=DIMS)


</pre>

<h3>
<a NAME="phtsrd"></a>PHTSRD - Signal per Ramp Data</h3>

<pre>Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Acquisition date
DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
ORDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Position within the TDT
DIMS&nbsp;&nbsp;&nbsp; Long integer&nbsp;&nbsp;&nbsp; Total number of read-outs
SLDI&nbsp;&nbsp;&nbsp; Long integer&nbsp;&nbsp;&nbsp; Total number of ramps
RCHP&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of ramps / chopper plateau&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
SLOP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Ramp slopes (Real {p,n}-array)&nbsp;
SLUN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Ramp slopes uncert. (Real {p,n}-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIA bitflags (Int {p,n}-array) [See <a href="#flagdef">Flag definitions</a>]
STIM&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (Real n-array)
CHOP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper position [arcsec] (Int n-array)
STEP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
FCSN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS selected (Int n-array)
TEMP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Temperature&nbsp; [K] (Real n-array)
FCS1&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS1 electrical power&nbsp; [mW] (Real n-array)
FCS2&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS2 electrical power&nbsp; [mW] (Real n-array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
RPID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Raster point ID (Byte (2,n)-array)
RESI&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Effective reset time (Real n-array)
NROS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of read-outs used in ramp (Real n-array)

p: number of pixels (P1,P2,P3 = 1, C100=11, C200=6, SS/SL=132)
n: number of ramps (=SLDI)

</pre>

<h3>
<a NAME="phtscp"></a>PHTSCP - Signal per chopper plateau</h3>

<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Acquisition date
DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
ORDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Position within the TDT
DIMS&nbsp;&nbsp;&nbsp; Long-integer&nbsp;&nbsp;&nbsp; Total number of chopper plateaux
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
TIME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (n-array)
AVER&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Average Signals per Chopper Plateau and Raster point
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [V/s] ({p,n}-array)
AVUN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Avrg.Signal uncertainties per Ch.Pl. and Raster point&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [V/s] ({p,n}-array)
MEDI&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Median Signals/Ch.Pl. and raster [V/s] ({p,n}-array)
Q1ME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; First Quartiles/Ch.Pl. and raster&nbsp; [V/s] ({p,n}-array)
Q3ME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Third Quartiles/Ch.Pl. [V/s] ({p,n}-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIA bitflags (Int {p,n}-array) [See <a href="#flagdef">Flag definitions</a>]
CHOP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper position [arcsec] (Int n-array)&nbsp;
STEP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
FCSN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS selected (Int n-array)
TEMP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Temperature&nbsp; [K] (Real n-array)
FCS1&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS1 electrical power&nbsp; [mW] (Real n-array)
FCS2&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS2 electrical power&nbsp; [mW] (Real n-array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
RPID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Raster point ID (Byte (2,n)-array)
ARSI&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean effective reset time (Real n-array)
ANDR&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean nr. of read-outs used (Real n-array)
AVSD&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Sigma signals' distr [V/s] (Real {p,n}-array)

p: number of pixels (P1,P2,P3 = 1, C100=11, C200=6, SS/SL=132)
n: number of chopper plateaux (=DIMS)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Note: the phtscp structure is also used for accomodating background-subtracted
measurements, in which case DIMS is reduced from the original number of chopper
plateaux to 1, and the values are given by the results of the subtraction.

</pre>

<h3>
<a NAME="phtspd"></a>PHTSPD</h3>

<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Acquisition date
DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
ORDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Position within the TDT
DIMS&nbsp;&nbsp;&nbsp; Long-integer&nbsp;&nbsp;&nbsp; Total number of chopper plateaux
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
RPID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Raster point ID (Byte (2,n)-array)
KYID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Keyword Identifier (Int n-array)
FILT&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Filter wheel position (Int n-array)
APER&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Aperture wheel position (Int n-array)
POLZ&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Polarizer wheel position (Int n-array)
NDRS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of destructive read-outs (Int n-array)
CSTP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
DWEL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper dwell time [s]&nbsp; (Int n-array)
MEAS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Measurement time [s] (Int n-array)
CPOS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper position (Int n-array)
TIME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (n-array)
MNPW&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean in-band power / ch.plateau &amp; raster pos. [W]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)&nbsp;
MNPU&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; MNPW Uncertainty [W] (Real {p,n}-array)
MDPW&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Median of in-band power / ch.plateau &amp; raster pos. [W]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)
Q1PW&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; First quartile of in-band power / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [W] (Real {p,n}-array)
Q3PW&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Third quartile of in-band power / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [W] (Real {p,n}-array)
DEC&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Declination [degrees] (Real n-array)
RA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Right ascension [degrees] (Real n-array)
ROLL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Roll angle [degrees] (Real n-array)
PLEN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Plateau length (Real {p,n}-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIA bitflags (Int {p,n}-array) [See <a href="#flagdef">Flag definitions</a>]


p: number of pixels (P1,P2,P3 = 1, C100=11, C200=6, SS/SL=132)
n: number of chopper plateaux (=DIMS)

Note: the definition of the phtspd structure is strongly influenced by the&nbsp;
pipeline products, to make use of the same arrays, independent of their&nbsp;
processing origins.&nbsp;

Note: the phtspd structure is also used for accomodating background subtracted
measurements, in which case DIMS is reduced from the original number of chopper
plateaux to 1, and the values are given by the results/derivations of the&nbsp;
subtraction.&nbsp;

</pre>

<h3>
<a NAME="phtaap"></a>PHTAAP</h3>

<pre>Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
DIMS&nbsp;&nbsp;&nbsp; Long-integer&nbsp;&nbsp;&nbsp; Total number of chopper plateaux
FILT&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Filter wheel position&nbsp;
APER&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Aperture wheel position&nbsp;
POLZ&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Polarizer wheel position&nbsp;
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
RPID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Raster point ID (Byte (2,n)-array)
KYID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Keyword Identifier (Int n-array)
CSTP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
DWEL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper dwell time [s]&nbsp; (Int n-array)
CPOS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper position (Int n-array)
TIME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (n-array)
MNFL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean flux / ch.plateau &amp; raster pos. [Jy]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)&nbsp;
MNFU&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; MNFL Uncertainty [Jy] (Real {p,n}-array)
MDFL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Median of flux / ch.plateau &amp; raster pos. [Jy]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)
Q1FL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; First quartile of flux / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [Jy] (Real {p,n}-array)
Q3FL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Third quartile of flux / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [Jy] (Real {p,n}-array)
MNBR&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean brightness / ch.plateau &amp; raster pos. [MJy/sr]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)&nbsp;
MNBU&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; MNPW Uncertainty [MJy/sr] (Real {p,n}-array)
MDBR&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Median of brightness / ch.plateau &amp; raster pos. [MJy/sr]
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Real {p,n}-array)
Q1BR&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; First quartile of brightness / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [MJy/sr] (Real {p,n}-array)
Q3BR&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Third quartile of brightness / ch.plateau &amp; raster&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pos. [MJy/sr] (Real {p,n}-array)
DEC&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Declination [degrees] (Real n-array)
RA&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Right ascension [degrees] (Real n-array)
ROLL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Roll angle [degrees] (Real n-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIA bitflags (Int {p,n}-array) [See <a href="#flagdef">Flag definitions</a>]


p: number of pixels (P1,P2,P3 = 1, C100=11, C200=6, SS/SL=132)
n: number of chopper plateaux (=DIMS)

Note: the phtaap structure is also used for accomodating background subtracted
measurements, in which case DIMS is reduced from the original number of chopper
plateaux to 1, and the values are given by the results/derivations of the&nbsp;
subtraction.</pre>

<pre></pre>

<pre></pre>

<h3>
<a NAME="phtcs"></a>PHTCS</h3>

<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Compact Status File name
DIMS&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of measurements comprised in the file
HANDLE&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Structure with tags as shown below&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;


Note: The pointer handle indicates a structure containing all the variables
quoted in the Compact Status Files as produced by the Pipeline (unconverted raw
telemetry values). For the user, however, it is more useful to have access to&nbsp;
the numbers converted into physical meaningful quantities.&nbsp;
The following table shows a static structure as output from the PIA routine&nbsp;
CONV_CS (after e.g. a call CONV_CS, PHTCS(1), CST)&nbsp;&nbsp;


Structure CST
&nbsp;
Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Compact Status File name
DIMS&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Number of measurements comprised in the file
UKST&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Universal Time Key, measurement start time&nbsp;
UKEN&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Universal Time Key, measurement end time&nbsp;
IKST&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Instrument Time Key, measurement start time&nbsp;
IKEN&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Instrument Time Key, measurement end time&nbsp;
UTST&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Universal Time Key, period start time&nbsp;
UTEN&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Universal Time Key, period end time
AOTN&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Observation sequence number
SUBS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Subsystem ('P1', 'C100', ...)&nbsp;&nbsp;&nbsp;
OPFO&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Chopper on position, override flag
F1TS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Selected TRS for FCS1
F2TS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Selected TRS for FCS2&nbsp;
F1PS&nbsp;&nbsp;&nbsp; Real array&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Selected electrical power on FCS1 [mW]
F2PS&nbsp;&nbsp;&nbsp; Real array&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Selected electrical power on FCS2 [mW]
C1PS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Commanded position on wheel I
C2PS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Commanded position on wheel II
C3PS&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Commanded position on wheel III
CMOD&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Chopper mode
CAMP&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Chopper amplitude [arcsec]&nbsp;
CSTE&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Chopper Steps
CINC&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Chopper increment [arcsec]&nbsp;
CRES&nbsp;&nbsp;&nbsp; Integer array&nbsp;&nbsp; Powered cold read-out electronics
DETA&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Detector assembly
DRS&nbsp;&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Data reduction factor
MUX1&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Multiplexer 1 line
MUX2&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Multiplexer 2 line
XSTA&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Multiplexer cross switch status
D1OF&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Digital interface electronics 1, offset [V]
D1GA&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Digital interface electronics 1, gain factor
D2OF&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Digital interface electronics 1, offset [V]
D2GA&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Digital interface electronics 1, gain factor
FREQ&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Frequency [Hz]
NNDR&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Number of non-destructive read-outs
NDR&nbsp;&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Number of destructive read-outs
INTT&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Integration time [s]
MEAT&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Measurement time [s]
MPC1&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Measured position change wheel I
MPC2&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Measured position change wheel II
MPC3&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Measured position change wheel III
MET&nbsp;&nbsp;&nbsp;&nbsp; String array&nbsp;&nbsp;&nbsp; Measured EEUU temperature [0C]</pre>

<h3>
<a NAME="phtcla"></a>PHTCLA</h3>

<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
@phtcla
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
PHTCLA_REC = {PHTCLA_TYPE, $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; UNIT: ` `, $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; DET: ` `, $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ADMN: ` `, $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ORDR: 0,&nbsp; $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; DIMS: 0L, $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; DWEL: 0L, $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; RPID: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; QFLG: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; QSTA: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; STAT: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; CPOS: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS1: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FCS2: HANDLE_CREATE(), $&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TEMP: HANDLE_CREATE(), $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TIME: HANDLE_CREATE(), $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BIAS: HANDLE_CREATE(), $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PIXL: HANDLE_CREATE(), $
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PUNC: HANDLE_CREATE()}
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
PHTCLA = {PHTCLA_TYPE}</pre>

<pre>Name:&nbsp;&nbsp; Typ:&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Contents:

UNIT&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Acquisition date
DET&nbsp;&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector
ADMN&nbsp;&nbsp;&nbsp; String&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Internal measurement name
ORDR&nbsp;&nbsp;&nbsp; Integer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Position within the TDT
DIMS&nbsp;&nbsp;&nbsp; Long-integer&nbsp;&nbsp;&nbsp; Total number of chopper plateaux
HDR&nbsp;&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Header (String array)
TIME&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Time within measurement [s] (n-array)
TKEY&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Instrument time key&nbsp; (Real n-array)
QFLG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Quality flag (n-array)
KYID&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Keyword Identifier (Int n-array)
FILT&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Filter wheel position (Int n-array)
APER&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Aperture wheel position (Int n-array)
POLZ&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Polarizer wheel position (Int n-array)
STAT&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FPC state (Int n-array)
DWEL&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper Dwell Time (Int n-array)
CPOS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Chopper step (Int n-array)
FCS1&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Measured FCS1 power (Real n-array)
FCS2&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Measured FCS2 power (Real n-array)
TEMP&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Detector Temperature (Real n-array)
BIAS&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Measured Bias voltage (Real n-array)
MNSG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Mean signal / ch.plateau [V/s] (Real {p,n}-array)&nbsp;
MNSU&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; MNSG Uncertainty [V/s] (Real {p,n}-array)
MDSG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Median signal / ch.plateau [V/s] (Real {p,n}-array)
Q1SG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; First quartile of signal / ch.plateau [V/s] (Real {p,n}-array)
Q3SG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Third quartile of signal / ch.plateau [V/s] (Real {p,n}-array)
PLEN&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Plateau length (Real {p,n}-array)
FLAG&nbsp;&nbsp;&nbsp; Pointer&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Flag, indicating status of data point for processing
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (Integer {p,n}-array)&nbsp;&nbsp; 0: valid&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 1: uncertainties not valid
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2: not valid&nbsp;


<hr WIDTH="100%"></pre>

<h2>
<a NAME="flagdef"></a>Flag Definitions for the internal dynamic buffers:</h2>
PIA has a bitflag system for giving the status of each data point. The
definition of the flags as well as their severity is given in the file
<b>pia_flaginfo.pro </b>which is reproduced below:
<br>&nbsp;
<pre>;ERD flags</pre>

<pre>Nflag = 9</pre>

<pre>LEX = MAKE_ARRAY(nflag,value='DUMMY')</pre>

<pre>LEX(0) = 'NOTF'</pre>

<pre>LEX(1) = 'DR'</pre>

<pre>LEX(2) = 'OUTVOLT'</pre>

<pre>LEX(4) = 'GENDISC'</pre>

<pre>LEX(5) = 'MANDISC'</pre>

<pre>LEX(6) = 'GLITCH'</pre>

<pre></pre>

<pre>EXPLA = MAKE_ARRAY(nflag,value='')</pre>

<pre>EXPLA(0) = 'Not On target'</pre>

<pre>EXPLA(1) = 'Destructive Read'</pre>

<pre>EXPLA(2) = 'Out of voltage'</pre>

<pre>EXPLA(4) = 'General discard'</pre>

<pre>EXPLA(5) = 'Manual discard'</pre>

<pre>EXPLA(6) = 'Detected glitch'</pre>

<pre></pre>

<pre>severe = INTARR(Nflag)</pre>

<pre>severe(2) = 1</pre>

<pre>severe(4:6) = 1</pre>

<pre></pre>

<pre>flagerd_str = {nflag:nflag, LEX:lex, EXPLA:expla, valflag:2^INDGEN(nflag), $</pre>

<pre>&nbsp;&nbsp;&nbsp; severe:severe}</pre>

<pre></pre>

<pre></pre>

<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</pre>

<pre>; SRD flags</pre>

<pre>Nflag = 10</pre>

<pre>LEX = MAKE_ARRAY(nflag,value='DUMMY')</pre>

<pre>LEX(0) = 'RAMPNDR_2'</pre>

<pre>LEX(1) = 'RAMPNDR_1'</pre>

<pre>LEX(2) = 'NOTF'</pre>

<pre>LEX(3) = 'GENDISC'</pre>

<pre>LEX(4) = 'MANDISC'</pre>

<pre>LEX(5) = 'GLITCH'</pre>

<pre>LEX(6) = 'NOCHOP'</pre>

<pre>LEX(7) = 'MANNMASK'</pre>

<pre></pre>

<pre>EXPLA = MAKE_ARRAY(nflag,value='')</pre>

<pre>EXPLA(0) = '2 readouts/ramp'</pre>

<pre>EXPLA(1) = '1 readout/ramp'</pre>

<pre>EXPLA(2) = 'Not On target'</pre>

<pre>EXPLA(3) = 'General discard'</pre>

<pre>EXPLA(4) = 'Manual discard'</pre>

<pre>EXPLA(5) = 'Detected glitch'</pre>

<pre>EXPLA(6) = 'No valid ch.pos.'</pre>

<pre>EXPLA(7) = 'Not stabilized '</pre>

<pre></pre>

<pre>severe = INTARR(Nflag)</pre>

<pre>severe(1:6) = 1</pre>

<pre>&nbsp;</pre>

<pre>flagsrd_str = {nflag:nflag, LEX:lex, EXPLA:expla, valflag:2^INDGEN(nflag), $</pre>

<pre>&nbsp;&nbsp;&nbsp; severe:severe}</pre>

<pre></pre>

<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</pre>

<pre>; SCP flags</pre>

<pre>Nflag = 10</pre>

<pre>LEX = MAKE_ARRAY(nflag,value='DUMMY')</pre>

<pre>LEX(0) = 'NSIG_1'</pre>

<pre>LEX(1) = 'NSIG_0'</pre>

<pre>LEX(2) = 'NOCHOP'</pre>

<pre>LEX(3) = 'GENDISC'</pre>

<pre>LEX(4) = 'MANDISC'</pre>

<pre>LEX(5) = 'STABIL1'</pre>

<pre>LEX(6) = 'STABIL2'</pre>

<pre>LEX(7) = 'DRIFTMOD'</pre>

<pre></pre>

<pre>EXPLA = MAKE_ARRAY(nflag,value='')</pre>

<pre>EXPLA(0) = 'Only 1 signal'</pre>

<pre>EXPLA(1) = 'No valid signal'</pre>

<pre>EXPLA(2) = 'No valid ch.pos.'</pre>

<pre>EXPLA(3) = 'General discard'</pre>

<pre>EXPLA(4) = 'Manual discard'</pre>

<pre>EXPLA(5) = 'Stability flag 1'</pre>

<pre>EXPLA(6) = 'Stability flag 2'</pre>

<pre>EXPLA(7) = 'Drift model flag'</pre>

<pre></pre>

<pre>severe = INTARR(Nflag)</pre>

<pre>severe(1:4) = 1</pre>

<pre>flagscp_str = {nflag:nflag, LEX:lex, EXPLA:expla, valflag:2^INDGEN(nflag), $</pre>

<pre>&nbsp;&nbsp;&nbsp; severe:severe}</pre>

<pre></pre>

<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</pre>

<pre>; SPD flags</pre>

<pre>Nflag = 10</pre>

<pre>LEX = MAKE_ARRAY(nflag,value='DUMMY')</pre>

<pre>LEX(0) = 'NSIG_1'</pre>

<pre>LEX(1) = 'NSIG_0'</pre>

<pre>LEX(2) = 'NOCHOP'</pre>

<pre>LEX(3) = 'GENDISC'</pre>

<pre>LEX(4) = 'MANDISC'</pre>

<pre>LEX(5) = 'QUALIT1'</pre>

<pre>LEX(6) = 'QUALIT2'</pre>

<pre>LEX(7) = 'BACKSEL'</pre>

<pre></pre>

<pre>EXPLA = MAKE_ARRAY(nflag,value='')</pre>

<pre>EXPLA(0) = 'Only 1 signal'</pre>

<pre>EXPLA(1) = 'No valid signal'</pre>

<pre>EXPLA(2) = 'No valid ch.pos.'</pre>

<pre>EXPLA(3) = 'General discard'</pre>

<pre>EXPLA(4) = 'Manual discard'</pre>

<pre>EXPLA(5) = 'Quality flag 1'</pre>

<pre>EXPLA(6) = 'Quality flag 2'</pre>

<pre>EXPLA(7) = 'Bckgr. position'</pre>

<pre></pre>

<pre></pre>

<pre>severe = INTARR(Nflag)</pre>

<pre>severe(1:4) = 1</pre>

<pre>&nbsp;</pre>

<pre>flagspd_str = {nflag:nflag, LEX:lex, EXPLA:expla, valflag:2^INDGEN(nflag), $</pre>

<pre>&nbsp;&nbsp;&nbsp; severe:severe}</pre>

<pre></pre>

<pre></pre>

<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;</pre>

<pre>; AAP flags</pre>

<pre>Nflag = 10</pre>

<pre>LEX = MAKE_ARRAY(nflag,value='DUMMY')</pre>

<pre>LEX(0) = 'NSIG_1'</pre>

<pre>LEX(1) = 'NSIG_0'</pre>

<pre>LEX(2) = 'NOCHOP'</pre>

<pre>LEX(3) = 'GENDISC'</pre>

<pre>LEX(4) = 'MANDISC'</pre>

<pre>LEX(5) = 'QUALIT1'</pre>

<pre>LEX(6) = 'QUALIT2'</pre>

<pre>LEX(7) = 'BACKSEL'</pre>

<pre></pre>

<pre>EXPLA = MAKE_ARRAY(nflag,value='')</pre>

<pre>EXPLA(0) = 'Only 1 signal'</pre>

<pre>EXPLA(1) = 'No valid signal'</pre>

<pre>EXPLA(2) = 'No valid ch.pos.'</pre>

<pre>EXPLA(3) = 'General discard'</pre>

<pre>EXPLA(4) = 'Manual discard'</pre>

<pre>EXPLA(5) = 'Quality flag 1'</pre>

<pre>EXPLA(6) = 'Quality flag 2'</pre>

<pre>EXPLA(7) = 'Bckgr. position'</pre>

<pre></pre>

<pre>severe = INTARR(Nflag)</pre>

<pre>severe(1:4) = 1</pre>

<pre>&nbsp;</pre>

<pre>flagaap_str = {nflag:nflag, LEX:lex, EXPLA:expla, valflag:2^INDGEN(nflag), $</pre>

<pre>&nbsp;&nbsp;&nbsp; severe:severe}</pre>

<pre></pre>

<pre>piaflag_str = {erd:flagerd_str, srd:flagsrd_str, scp:flagscp_str, $</pre>

<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; spd:flagspd_str, aap:flagaap_str}</pre>

<pre>&nbsp;</pre>

<hr>
<br>&nbsp;
<table>
<caption>History of this Section:</caption>

<tr>
<th>Date&nbsp;</th>

<th>Authors&nbsp;</th>

<th>Description&nbsp;</th>
</tr>

<tr>
<td>04/07/1995&nbsp;</td>

<td>Ingolf Heinrichsen(MPIK)&nbsp;</td>

<td>First Version&nbsp;</td>
</tr>

<tr>
<td>22/07/1996&nbsp;</td>

<td>Carlos Gabriel(ESA/VILSPA-SAI)&nbsp;</td>

<td>General Update&nbsp;</td>
</tr>

<tr>
<td>25/08/1999</td>

<td>Carlos Gabriel(ESA/VILSPA-SAI)&nbsp;</td>

<td>Update (V8.0)</td>
</tr>
</table>

<!-- crb ini -->
</div>
<?php include($_SERVER["DOCUMENT_ROOT"]."/iso/iso_foot.php"); ?>
<!-- crb end -->
Date	Authors	Description
04/07/1995	Ingolf Heinrichsen(MPIK)	First Version
22/07/1996	Carlos Gabriel(ESA/VILSPA-SAI)	General Update
25/08/1999	Carlos Gabriel(ESA/VILSPA-SAI)	Update (V8.0)