NAME

mkfilter2 - Produce an ASCA filter file for XSELECT.


USAGE

        mkfilter2 S0HK S1HK G2HK G3HK rigidityfile frf leapsecfile
               attitudefile Euler_angles(3) bin_width outfile

DESCRIPTION

mkfilter2 is a program to produce a filter file that XSELECT uses. mkfilter2 gets information from HK files (SIS S0-1 and GIS G2-3), frf.orbit, rigidity.data, and attitude frf. To do this, mkfilter2 accesses HK files, NOT telemetry frf.

This is an FTOOLS version of Toshiaki Takeshima's mkfilter2 program, version 2.34.


PARAMETERS

s0_hk [filename]
Name of the SIS0 housekeeping file.

s1_hk [filename]
Name of the SIS1 housekeeping file.

g2_hk [filename]
Name of the GIS2 housekeeping file.

g3_hk [filename]
Name of the GIS3 housekeeping file.

rigidity = /asca/operation/dp10/rigidity.data [filename]
Name of the rigidity data file.

orbit = frf.orbit [filename]
Name of orbit file.

leapsec = $FTOOLS/refdata/leapsec.fits [filename]
Leap seconds file.

attitude [filename, optional]
Name of the attitude file. Optional. If omitted, the values of the euler parameter are used.

euler = "-111.52 157.38 -169.41" [string of 3 numbers]
Euler angles giving the spacecraft orientation. Used if the attitude file is not specified or is out of date, and for bins that are outside the range of the attitude file.

binwidth = 32 [double]
Bin width, in seconds. Recommended values are 16 and 32; at shorter widths some SIS parameters will sometimes be skipped, while at longer widths the sampling frequency of attitude and aspect parameters becomes too low to select data correctly.

outfile [filename]
Name of output file.

(redosatf = yes) [boolean]
Recalculate SIS saturation flags based on telemetry events and bit rate, as previously (default), or use the ones from the HK files?

(clobber = no) [boolean]
Overwrite existing file?


OUTPUT FILE

The filter file contains the following parameters:

          ---------------------------------------------------------------------
          Name                Type        Unit        Comment
          ---------------------------------------------------------------------
          TIME                double        sec        Bin center, in seconds from Jan. 1, 1993
          START                char                Start time of record
          BN_WIDTH        double        sec        Data Bin Width
          BIT_RATE         byte                DP Bit Rate 0:H, 1:M, 2:L
          ACS                byte                ACS Status 0:fine mode, 1:corse mode
          NSAS                float        degree        NSAS cone angle (sun angle)
          Z_ALPHA                float        degree        R.A.(2000) of Z-Axis
          Z_DELTA                float        degree        Dec.(2000) of Z-Axis
          EULER_3                float        degree        3rd Euler Angle (Z-Y-Z)
          SAT_ALT                float        degree        Satellite altitude
          SAT_LON                float        km        Satellite longitude
          SAT_LAT                float        degree        Satellite latitude
          ELV                float        degree        Target elevation from the Earth regde
          COR                float        GeV        Cut Off Rigidity
          FOV                byte                Field of View  0:Sky/1:Night Earth/2:Day Earth
          BR_EARTH        float        degree        Angular distance from Bright Earth
          SAA                byte                Passage of South Atlantic Anomaly 1:yes/0:no
          T_SAA                float        sec        Time after SAA passage (sec)
          SUNSHINE        byte                1:satellite is in daytime/ 0:night
          T_DY_NT                float        sec        Time after day/night transition (sec)
          S0_MODE                byte                SIS_0 observation mode 0:Fnt/1:Brt/2:Fst/3:Frm
          S1_MODE                byte                SIS_1 observation mode 4:DkFrm/5:Hst/6:Intg
          S0_ID                int                SIS_0 CCD ID LIST
          S1_ID                int                SIS_1 CCD ID LIST
          S0_DSCR                byte                SIS_0 Discriminator status
          S1_DSCR                byte                SIS_1 Discriminator status
          SIS_ADRS        byte                SIS Address Dscri 0:in 1:out for each chip
          S0_GRADE        byte                SIS_0 grade discriminate value
          S1_GRADE        byte                SIS_1 grade discriminate value
          S0_EVTR0        int                SIS_0 Chip_0 Event Threshold
          S0_EVTR1        int                SIS_0 Chip_1 Event Threshold
          S0_EVTR2        int                SIS_0 Chip_2 Event Threshold
          S0_EVTR3        int                SIS_0 Chip_3 Event Threshold
          S1_EVTR0        int                SIS_1 Chip_0 Event Threshold
          S1_EVTR1        int                SIS_1 Chip_1 Event Threshold
          S1_EVTR2        int                SIS_1 Chip_2 Event Threshold
          S1_EVTR3        int                SIS_1 Chip_3 Event Threshold
          S0_SPTR0        int                SIS_0 Chip_0 Split Threshold
          S0_SPTR1        int                SIS_0 Chip_1 Split Threshold
          S0_SPTR2        int                SIS_0 Chip_2 Split Threshold
          S0_SPTR3        int                SIS_0 Chip_3 Split Threshold
          S1_SPTR0        int                SIS_1 Chip_0 Split Threshold
          S1_SPTR1        int                SIS_1 Chip_1 Split Threshold
          S1_SPTR2        int                SIS_1 Chip_2 Split Threshold
          S1_SPTR3        int                SIS_1 Chip_3 Split Threshold
          S0_AE                byte                SIS_0 AE Status 0:normal/1:A-off/2:Power off
          S1_AE                byte                SIS_1 AE Status 0:normal/1:A-off/2:Power off
          S0_TEMP                float        deg C        SIS_0 CCD temperature
          S1_TEMP                float        deg C        SIS_1 CCD temperature
          S0_EVNT0        float        evt/sec        SIS_0 chip_0 HK Event number
          S0_EVNT1        float        evt/sec        SIS_0 chip_1 HK Event number
          S0_EVNT2        float        evt/sec        SIS_0 chip_2 HK Event number
          S0_EVNT3        float        evt/sec        SIS_0 chip_3 HK Event number
          S1_EVNT0        float        evt/sec        SIS_1 chip_0 HK Event number
          S1_EVNT1        float        evt/sec        SIS_1 chip_1 HK Event number
          S1_EVNT2        float        evt/sec        SIS_1 chip_2 HK Event number
          S1_EVNT3        float        evt/sec        SIS_1 chip_3 HK Event number
          S0_PIXL0        float        pxl/sec        SIS_0 chip_0 HK Pixel number over threshold
          S0_PIXL1        float        pxl/sec        SIS_0 chip_1 HK Pixel number over threshold
          S0_PIXL2        float        pxl/sec        SIS_0 chip_2 HK Pixel number over threshold
          S0_PIXL3        float        pxl/sec        SIS_0 chip_3 HK Pixel number over threshold
          S1_PIXL0        float        pxl/sec        SIS_1 chip_0 HK Pixel number over threshold
          S1_PIXL1        float        pxl/sec        SIS_1 chip_1 HK Pixel number over threshold
          S1_PIXL2        float        pxl/sec        SIS_1 chip_2 HK Pixel number over threshold
          S1_PIXL3        float        pxl/sec        SIS_1 chip_3 HK Pixel number over threshold
          S0_TELM0        float        evt/sec        SIS_0 chip_0 telemely event number
          S0_TELM1        float        evt/sec        SIS_0 chip_1 telemely event number
          S0_TELM2        float        evt/sec        SIS_0 chip_2 telemely event number
          S0_TELM3        float        evt/sec        SIS_0 chip_3 telemely event number
          S1_TELM0        float        evt/sec        SIS_1 chip_0 telemely event number
          S1_TELM1        float        evt/sec        SIS_1 chip_1 telemely event number
          S1_TELM2        float        evt/sec        SIS_1 chip_2 telemely event number
          S1_TELM3        float        evt/sec        SIS_1 chip_3 telemely event number
          S0_SATF0        byte                SIS_0 chip_0 saturation flag 0:no/ 1:yes
          S0_SATF1        byte                SIS_0 chip_1 saturation flag 0:no/ 1:yes
          S0_SATF2        byte                SIS_0 chip_2 saturation flag 0:no/ 1:yes
          S0_SATF3        byte                SIS_0 chip_3 saturation flag 0:no/ 1:yes
          S1_SATF0        byte                SIS_1 chip_0 saturation flag 0:no/ 1:yes
          S1_SATF1        byte                SIS_1 chip_1 saturation flag 0:no/ 1:yes
          S1_SATF2        byte                SIS_1 chip_2 saturation flag 0:no/ 1:yes
          S1_SATF3        byte                SIS_1 chip_3 saturation flag 0:no/ 1:yes
          S0_DFE0                float        ADU        SIS_0 chip_0 dark frame error
          S0_DFE1                float        ADU        SIS_0 chip_1 dark frame error
          S0_DFE2                float        ADU        SIS_0 chip_2 dark frame error
          S0_DFE3                float        ADU        SIS_0 chip_3 dark frame error
          S1_DFE0                float        ADU        SIS_1 chip_0 dark frame error
          S1_DFE1                float        ADU        SIS_1 chip_1 dark frame error
          S1_DFE2                float        ADU        SIS_1 chip_2 dark frame error
          S1_DFE3                float        ADU        SIS_1 chip_3 dark frame error
          GIS_MODE        byte                GIS observation mode, 0:PH/ 1:MPC/ 2:PCAL
          GHV2_L                byte                GIS HVL2 status 16:off/8:reduction/0-7:level
          GHV3_L                byte                GIS HVL3 status 16:off/8:reduction/0-7:level
          GHV2_H                byte                GIS HVH2 status 16:off/8:reduction/0-7:level
          GHV3_H                byte                GIS HVH3 status 16:off/8:reduction/0-7:level
          G2_LDHIT        float        cnt/sec        GIS_2 Lower Discri Hit counting rate
          G3_LDHIT        float        cnt/sec        GIS_3 Lower Discri Hit counting rate
          G2_H0                float        cnt/sec        GIS_2 HK monitor H0
          G3_H0                float        cnt/sec        GIS_3 HK monitor H0
          G2_H1                float        cnt/sec        GIS_2 HK monitor H1
          G3_H1                float        cnt/sec        GIS_3 HK monitor H1
          G2_H2                float        cnt/sec        GIS_2 HK monitor H2
          G3_H2                float        cnt/sec        GIS_3 HK monitor H2
          G2_L0                float        cnt/sec        GIS_2 HK monitor L0
          G3_L0                float        cnt/sec        GIS_3 HK monitor L0
          G2_L1                float        cnt/sec        GIS_2 HK monitor L1
          G3_L1                float        cnt/sec        GIS_3 HK monitor L1
          G2_L2                float        cnt/sec        GIS_2 HK monitor L2
          G3_L2                float        cnt/sec        GIS_3 HK monitor L2
          G2_CPU_I        float        cnt/sec        GIS_2 HK monitor CPU_IN
          G3_CPU_I        float        cnt/sec        GIS_3 HK monitor CPU_IN
          G2_CPU_O        float        cnt/sec        GIS_2 HK monitor CPU_OUT
          G3_CPU_O        float        cnt/sec        GIS_3 HK monitor CPU_OUT
          G2_TELM                float        cnt/sec        GIS_0 telemely event number
          G3_TELM                float        cnt/sec        GIS_1 telemely event number
          G2_CPU_S        byte                GIS_2 CPU status, run +4, stop +2, error +1
          G3_CPU_S        byte                GIS_3 CPU status, run +4, stop +2, error +1
          GIS_HAMM        byte                GIS Hamming Error 0:off/1:on
          G2_TEMP                float        deg C        GIS_2 temperature
          G3_TEMP                float        deg C        GIS_3 temperature
          G2_HVHMN        float        V        GIS2 HV-H monitor
          G2_HVLMN        float        V        GIS2 HV-L monitor
          G2_HVHCM        float        uA        GIS2 HV-H current monitor
          G3_HVHMN        float        V        GIS3 HV-H monitor
          G3_HVLMN        float        V        GIS3 HV-L monitor
          G3_HVHCM        float        uA        GIS3 HV-H current monitor
          G2_DEADT        float                GIS_2 Dead time correction factor (0-1)
          G3_DEADT        float                GIS_3 Dead time correction factor (0-1)
          RBM_TEMP        float        deg C        RBM temperature
          GIS_RBMF        byte                RBM flag status of GIS 0:off/1:on
          SIS_RBMF        byte                RBM flag status of SIS 0:off/1:on
          RBM_CONT        float        cnt/sec        RBM counting rate
          ETI                int                Extended TI counter
          ANG_DIST        float        degree        Ang. Distance of FOV from specified direction
          ---------------------------------------------------------------------


AUTHOR

          Toshiaki Takeshima
          NASA Goddard Space Flight Center
          Code 662 / XTE SOF
          Greenbelt MD 20771, USA
          Phone 703-286-5090
          Email toshiaki.takeshima@gsfc.nasa.gov

For FTOOLS assistance and to report bugs, contact the FTOOLS Development Team at NASA Goddard Space Flight Center, http://heasarc.gsfc.nasa.gov/cgi-bin/ftoolshelp, or the ASCA Guest Observer Facility, ascahelp@olegacy.gsfc.nasa.gov.

CATEGORY

August_1998 ftools.asca