
=========================================================
NOTE!!!!
THIS FILE IS NO LONGER UP-DATED.  IT CONTAINS OLD INFORMATION.
PLEASE INSTEAD LOOK TO EDI_PISO_OUTPUT_DEFS.TXT FOR THE LATEST
VARIABLE DESCRIPTIONS!!!!!!!  PPQ, SEPT. 12TH, 2003


*********************************************************
Electron Drift Instrument (EDI) Prime Parameter (PP) Variable Definitions
These are currently the four EDI output variables:
   V_ed_xyz_gse__
   E_xyz_gse__
   Reduced_chi_sq__
   Status__
Written: February 1st, 2002
         Pamela A. Puhl-Quinn (ppq@mpe.mpg.de)

*********************************************************
*********************************************************
Name: V_ed_xyz_gse__
Type: REAL4
Size: 3
Fill: -1e+31
Units: km/s
Coord: GSE
Defn: Electron drift velocity perpendicular to the magnetic field;
      Corrected for the SC motion
*********************************************************
Name: E_xyz_gse__
Type: REAL4
Size: 3
Fill: -1e+31
Units: mV/m
Coord: GSE
Defn: Perpendicular electric field
      Corrected for the SC motion
*********************************************************
Name: Reduced_chi_sq__
Type: REAL4
Size: Scalar
Fill: -1e+31
Units: unitless
Coord: N/A
Defn: Reduced chi-squared of the Triangulation analysis fit;
      Only valid if the end method used was triangulation;
      If other method used, this variable is given a value of -1.0
*********************************************************
Name: Status__
Type: UINT1
Size: 7
Fill: 255
Units: varies (see below)
Coord: N/A
Defn: See below
Note: These 7 variables are either all fill, or all non-fill,
      never mixed (so that QSAS won't have problems)
*********************************************************

=========================================================
Sbyte0: Quality
     Sbyte0 = 0 ---> 'BAD'
     Sbyte0 = 1 ---> 'CAUTION'
     Sbyte0 = 2 ---> 'GOOD'

Triangulation -----------------------------------------
'BAD':  rchi2 gt 20 or derror/d gt 1
'GOOD': rchi2 lt 5 and derror/d lt .30
'CAUTION': Everything that's left

Poorman's ToF -----------------------------------------
'BAD':  derror/d gt 1
'GOOD': derror/d lt .3
'CAUTION': Everything that's left

Simultan ToF ------------------------------------------
'BAD':  derror/d gt 1
'GOOD': derror/d lt .3
'CAUTION': Everything that's left

Richman's ToF -----------------------------------------
'BAD':  derror/d gt 1
'GOOD': derror/d lt .3
'CAUTION': Everything that's left

=========================================================   
Sbyte1: Percentage of 1keV beams used in entire spin
        (If 100, then we're not in energy switching;
         If 0, then we're at 0.5keV;
         Else, we're in energy switching mode)
=========================================================   
Sbyte2: Percentage of Class-A beams used in entire spin
=========================================================   
Sbyte3: Method Papertrail and Ambiguity Flag

 Bits 0-4 reflect the value of the control parameter pp_method:
 If Bits 0-4 aren't set, then pp_method = 0 -- Forced TRI
 Bit 0 set if pp_method = 1 -- TRI/PMT/SMT examined - Logic Chain 1
 Bit 1 set if pp_method = 2 -- Forced PMT
 Bit 2 set if pp_method = 3 -- TRI/PMT/SMT examined - Logic Chain 2
 Bit 3 set if pp_method = 4 -- TRI/PMT/SMT examined - Logic Chain 3
 Bit 4 set if pp_method = 5 -- Forced SMT
 Bit 0 and 1 set if pp_method = 6 -- Forced PMT/SMT
 Bit 0 and 2 set if pp_method = 7 -- TRI/RMT examined
 Bit 0 and 3 set if pp_method = 8 -- Forced RMT

 If Bits 5-6 aren't set, then method used in the end was Triangulation (TRI)
 Bit 5 set if method used in the end was Poorman's ToF (PMT)
 Bit 6 set if method used in the end was Simultan ToF (SMT)
 Bit 5 and 6 set if method used in the end was Richman's ToF (RMT)

 Bit 7:  Not set = No 180-degree ambiguity in drift step
         Set     = 180-degree ambiguity exists


=========================================================  
Sbyte4: Percentage of Triangulation outliers 
        (only reported for triangulation results)

=========================================================
Sbyte5: Magnitude percentage error in inertial frame

=========================================================
Sbyte6: Azimuthal error in degrees in inertial frame