===== ThedParticle_a =====


<code>
Definition of ground analysed HED particle, sub-type 'a'

 Version 1.1

 Level(s): 3

 Format(s): f10,f30,f40,f50


 ThedParticle_a::
    stopDet : BYTE       Stopping detector
    discr   : BYTE       Discriminator bits.                                         (1)
    pri     : BYTE       Onboard priority: 1=PR1, 3=PR3, 17=PR1 (e-corr),            (2)
                         19=PR3 (e-corr).
                         Electron correction (e-corr) indicates that the
                         particle was given an electron status by the H/W
                         but this was changed by the on-board interrupt
                         handler based on D1 pulse height.
    obCat   : BYTE       On-board category bits:
                            b7 = Affected by S1H2X E-edge amplifier breakdown        (3)
                            b6 = RESERVED
                            b5 = RESERVED
                            b4 = RESERVED
                            b3 = Heavy PHA section
                            b2 = Helium PHA section
                            b1 = Light PHA section (includes rescued data)
                            b0 = Rescued PHA section (b1 bit set also)
    l2ind   : LONG       Level-2 PHA event index                                     (4)
    coord   : FLOAT[4]   S-detector coordinates S1x,S1y,S2x,S2y [mm]
    ene     : FLOAT[7]   Detector energies (S1x,S1y,S2x,S2y,D1,D2 and D3) [keV]
    pid     : FLOAT      particle ID from the onground analysis (SClev2to3)


 1) Discrimation bits are valid only for MAINT-mode data, otherwise all 0.

 2) e-corr information in pri is consistently valid only from OSS-2.40
    onwards (since 19 April 2000). A couple of earlier versions offer it also:
    OSS-2.30 (23-24 Feb 2000) and OSS-2.31 (14-29 Mar 2000).

 3) The S1H2X warning flag (obCat b7) is set by the SClev1to2 program. The flag 
    is set if the particle has been subject to on-board trajectory check based on 
    the estimated S1X-coordinate from the affected S1X-half (S1H2X). The flag is 
    not set for particles that have been written to the PHA table without 
    coordinate calculation (most of the 'heavy'-particles) or which have entered 
    through the non-affected half (S1H1X).

    The flag is valid only from OSS-2.50 onwards (since 3 July 2001).

 4) Index of this particle in the level-2 PHA record file for this day. Some of
    the PHA events will be discarded during the ground analysis so there is no
    one-to-one match between the level-2 and level-3 particle entries. So if you
    need to get the matching level-2 PHA record for any level-3 particle, you can
    (and must) use this index to identify the corresponding level-2 entry.



 VERSION HISTORY:

 1.1 - 2016-10-14

       Corrected the description of the obCat bits b4-b7 (ER)


 1.0 - 2006-11-21

       First version for automated (on-need) structure definition (ER)


</code>