next up previous contents
Next: A. Acronyms Up: Suzaku ABC Guide Previous: 6. XIS Data Analysis   Contents

Subsections


7. HXD Data Analysis

7.1 Introduction

The HXD significantly extends the spectral range of Suzaku (to 600 keV) and has the lowest background rate of any instrument ever operated in the 10-600 keV energy range. Because the HXD is a non-imaging instrument, the analysis of HXD data follows a different path from that used in XIS data analysis. It is much closer to the analysis flow of other collimated instruments, such as Ginga LAC and RXTE PCA. Users familiar with the analysis techniques for either will find much in common in what we describe below.

Users should refer to the outstanding issues in HXD data analysis (Chapter5).

A peculiarity of the HXD that needs to be taken into account is that there are two independent detector systems. These are the GSO/BGO phoswich counters and the PIN silicon diodes. The PIN diodes are sensitive below $\sim 60$keV, while the GSO/BGO phoswich counters detect photons above $\sim 30$keV. The energy resolution of the PIN diodes is $\sim 3.0$keV, while the phoswich counters have a resolution of 7.6 sqrt(E) % (FWHM) where $E$ is the photon energy in MeV. There are a couple of things that users should know about the detectors, in order to understand better the HXD data and their organization.

The HXD sensor (HXD-S) is a composed of 16 main detectors (well units) arranged as a 4 $\times$ 4 array (see top view in Figure 7.1) and 20 surrounding crystal scintillators for active shielding.

Figure 7.1: Schematic picture of the HXD instrument, which consists of two types of detectors: the PIN diodes located in the front of the GSO scintillator, and the scintillator itself.
Image hxd-all-color-2

Each unit actually consists of two types of detectors: Four GSO/BGO phoswich counters, and four 2 mm-thick PIN silicon diodes located inside the well, but in front of the GSO scintillator. One can see the configuration of the sensor units in Figure 7.2.

Figure 7.2: Numbering of the Well and Anti-counter units.
Image hxd-conf

This means that the data (``well'' data) do not initially differentiate between PIN and GSO. The distinction is made later on in the pipeline. For more information about the HXD detector, please see the Suzaku Technical Description at
http://suzaku.gsfc.nasa.gov/docs/suzaku/prop_tools/suzaku_td.

7.2 Content of the Cleaned Event Files

HXD data begin as part of the RPT telemetry downloaded from Suzaku, and is immediately converted into a collection of FITS files by the mk1stfits routine at ISAS. mk1stfits does not reject any events or apply any calibration to the data (see Tabletab:hxdproc below), but merely converts it to FITS files. These files are included in the standard data download in the directory hxd/event_uf.


Table 7.1: Screening applied to cleaned HXD event files
Calibration Item Tool Comments
Time Assignment hxdtime  
Gain History Generation - Obtain latest from HXD team via CALDB
PI Assignment hxdpi  
Grade assignment hxdgrade  


Unless there is an update specific to the data in question, users should assume that these steps need not be repeated.

In addition to the above calibration steps, the event files in the event_cl have been screened using the following (Table7.2) criteria.


Table 7.2: HXD Calibration Steps
Type Criterion Comments
Event by event DET_TYPE=0 GSO events
  DET_TYPE=1 PIN events
  DET_TYPE=2 Pseudo events
GTI AOCU_HK_CNT3_NML_P==1 Attitude control in pointing mode
  ANG_DIST$<$1.5 Instantaneous pointing within 1.5 arcmin of mean.
  HXD_HV_Wn_CAL$>$700 High voltage is not reduced
  HXD_HV_Tn_CAL$>$700 High voltage is not reduced
  SAA_HXD==0 Satellite is outside SAA
  T_SAA_HXD$>$500 Time since SAA passage $>$500 sec
  TN_SAA_HXD$>$180 Time to next SAA passage $>$180 sec
  COR$>$6 Cut-off Rigidity $>$6 GeV
  ELV$>$5 Pointing direction $>$5 deg above Earth
  Telemetry is unsaturated aeNNNNNNNNNhxd_0_tlm.gti


7.3 Spectral Analysis of PIN Data

Since PIN is a collimated instrument, it is not possible to obtain background data from the observation data themselves. Instead, the HXD team has developed and run a model of the time-variable particle background, and made the results available.

Before starting on the usage of these files, we should note the following.

  1. The background model is still under development. The ultimate accuracy is limited by the amount of day and night Earth data that are used to calibrate the background model, and will slowly improve with time. The current uncertainty is estimated to be about 3.2% in the 15-40 keV range (see
    ftp://legacy.gsfc.nasa.gov/suzaku/doc/hxd/suzakumemo-2007-09.pdf).
  2. The background files only model the particle background. The cosmic X-ray background must be evaluated separately.

7.3.1 Download background files

HXD/PIN non X-ray background (NXB) files for data processed using version 2.x are available from the following location:
ftp://legacy.gsfc.nasa.gov/suzaku/data/background/pinnxb_ver2.0/.

This directory is divided into subdirectories by month. For example, background files for observations carried out in 2006 August can be found in the subdirectory 2006_08. Within these monthly directories, individual background files are listed alphabetically. Note these files are named using the sequence number, e.g.,
ae100005010hxd_pinnxb_cl.evt.gz.

These files should only be used with version 2 processed data, and vice versa. One important change from version 1.x background files is that the new background files contain events from all units of PIN, regardless of whether the bias voltage is 500V or 400V.

Currently, however, the V2 PIN background files for the (i) initial operation phase of HXD (launch through 2005 Sep 1) and (ii) the period 2006 March 23 - 2006 May 13, during which some GSO parameters were changed show systematic offset. The workaround is to use V1 background files available at:
http://www.astro.isas.jaxa.jp/suzaku/analysis/hxd/v1/pinnxb/pinnxb_ver1.2_d/.

7.3.2 Spectral Extraction

  1. The background event files have a GTI extension (extension 2). The background estimation is performed only within the GTIs listed. For further filtering, you should make a new GTI by ANDing the GTI from your filtering criteria with the GTI extension of the background files. For example,
    > mgtime "ae100005010hxd_0_pinno_cl.evt+2 ae100005010hxd_pinnxb_cl.evt+2" \
    common.gti AND
    

  2. Extract the source and background spectra, applying the GTI file as generated above. To do so in xselect,
    xsel> filter time file common.gti
    
  3. It is necessary to correct for the dead time of the observed spectrum to apply the background file correctly. The dead time correction tool (hxddtcor, included in the latest release of the Suzaku FTOOLS) updates the EXPOSURE keyword of the spectral file, by comparing the number of pseudo events injected by the analog electronics on-board with that found in the telemetry.

    A pseudo event file filtered with the same GTI as the cleaned event file can be found in the cleaned event file directory in data processed with version 2.x (event_cl/aeNNNNNNNNNhxd_0_pse_cl.evt.gz). This is the most convenient input to hxddtcor, if you are analyzing the cleaned event files. Otherwise, supply the unscreened event file(s) to hxddtcor. The syntax is:

    > hxddtcor ae100005010xd_0_pse_cl.evt ae100005010pin.pha
    
    Note that the EXPOSURE keyword value will be rewritten.

    On the other hand, dead time correction is not necessary for the PIN background files.

  4. The event rate in the PIN background event file is 10 times higher than the real background to suppress the Poisson errors. Therefore, users should increase the exposure time of derived background spectra and light curves by a factor of 10 using, e.g., fv or fmodhead.

7.3.3 Spectral Analysis

Now that spectral files have been extracted and exposure times corrected for the data and the background model, users now need to obtain the appropriate response files. Due to the changes in instrumental settings (bias voltages used on-board and low energy threshold used in processing on the ground), users must now choose PIN response matrices that are appropriate for the epoch of observation, as listed in Table7.3.

In addition, the effective area of the PIN varies within the XIS FOV, because of the passive fine collimator that restricts the HXD FOV (see Figure 8.3
http://suzaku.gsfc.nasa.gov/docs/suzaku/prop_tools/suzaku_td/node11.html of Technical Description). Therefore, users need to select a response appropriate for the source location. For sources that are extended over $\sim$5 arcmin or more, differential vignetting within the source region must be considered. As a special case, the cosmic background can be considered flat over many degrees (ignoring the cosmic variance for the moment), which has to be accounted for using a special response that averages the fine collimator transmission over a wide area of the sky.

The original PI selected either the XIS nominal pointing (the target at the center of the XIS field of view) or the HXD nominal pointing (the target about 5 arcmin off-axis relative to the XIS, but at a point of maximum throughput of the HXD/PIN). The actual pointing can be determined by inspecting the NOM_PNT keyword in the FITS files. Responses are provided for point sources observed at these positions. In addition, we provide a ``flat'' response appropriate for large, extended source such as the Cosmic X-ray background (CXB).


Table 7.3: HXD/PIN response files by epoch; XXXXX=xinom, hxnom, flat
Epoch File(s)
2005 Aug 17 - 2006 May 13 ae_hxd_pinXXXXXe1_20070914.rsp
2006 may 13 - 2006 Oct 2 ae_hxd_pinXXXXXe2_20070914.rsp
2006 Oct 2 - 2007 Jul 28 ae_hxd_pinXXXXXe3_20070914.rsp
2007 Jul 28 - ae_hxd_pinXXXXXe4_20070914.rsp


These files are available from the Suzaku CALDB
http://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/suzaku/ (2007 Sep 15 version or later).

Now users can begin spectral fitting of the HXD/PIN data. In addition to the usual tasks of selecting the appropriate model etc., there are two steps that are needed here.

7.3.3.1 Accounting for the Cosmic X-ray Background

The background event file does not include the cosmic X-ray background (CXB). Since the CXB flux is about 5% of the background for PIN, users need to take it into account after subtracting the non X-ray background, as follows. One method is to estimate the CXB level by using the PIN response for the flat emission distribution (see Table 7.3). They assume that the uniform emission is from the region of 2 deg $\times$ 2 deg.

A ``typical'' CXB spectrum is reported as follows, based on the HEAO-1 results (Boldt 1987
http://adsabs.harvard.edu/cgi-bin/nph-bib_query?bibcode=1987IAUS..124..611B


\begin{displaymath}CXB(E) = 9.0 \times 10^{-9} \times (E/3keV)^{-0.29}
\times \exp{-E/40keV} erg cm^{-2}s^{-1}str^{-1}keV^{-1} \end{displaymath}

Since the flat PIN response files are for 4 square degree field of view, we need to multiply this result by the appropriate ratio (4 deg$^2$ /1 sr). Since 1 sr = 3283 deg$^2$ , this becomes


\begin{displaymath}CXB(E) = 1.097 \times 10^{-11} \times (E/3keV)^{-0.29}
\times \exp{-E/40keV} erg cm^{-2}s^{-1}FOV^{-1}keV^{-1} \end{displaymath}

Converting this into values appropriate for xspec, which assumes the power-law is normalized at 1 keV and is in photons, not ergs, we obtain:


\begin{displaymath}CXB(E) = 9.412 \times 10^{-3} \times (E/1keV)^{-1.29}
\times \exp{-E/40keV} photons cm^{-2}s^{-1}FOV^{-1}keV^{-1} \end{displaymath}

Then we can simulate the CXB contribution to the PIN background with xspec, using

In our case, we take E$_c$ at the lower limit of the model (E=0.0001 keV) and fix it there. E$_f$ is 40 keV. The input to XSPEC looks like:

XSPEC12>model po*highecut

Input parameter value, delta, min, bot, top, and max values for ...
              1       0.01         -3         -2          9         10
1:powerlaw:PhoIndex>1.29
              1       0.01          0          0      1e+24      1e+24
2:powerlaw:norm>9.412e-03
             10       0.01     0.0001       0.01      1e+06      1e+06
3:highecut:cutoffE>0.0001
             15       0.01     0.0001       0.01      1e+06      1e+06
4:highecut:foldE>40

========================================================================
Model powerlaw<1>*highecut<2> Source No.: 1   Active/Off
Model Model Component  Parameter  Unit     Value
 par  comp
1   1       powerlaw   PhoIndex            1.29000      +/-  0.0          
2   1       powerlaw   norm                9.41200E-03  +/-  0.0          
3   2       highecut   cutoffE    keV      1.00000E-04  +/-  0.0          
4   2       highecut   foldE      keV      40.0000      +/-  0.0          
________________________________________________________________________

XSPEC12>
Once this has been set up, users can use the fakeit command using the pinflat response matrix.

NOTE 1
This is the model of the CXB to be convolved with the ``flat'' response. To fit the observed ($-$NXB) spectrum with a model for the source and the model for the CXB, a re-scaled version (using the ratio of XIS nominal or HXD nominal response vs. the flat response) of the model must be used. Although the effects of the CXB should be investigated independently for each observation, one can reproduce the observed counts from the diffuse CXB when using the HXD nominal position response matrix ae_hxd_pinhxnom_20060814.rsp by using 8$\times$10$^{\rm -4}$ as a normalization factor (instead of 9.412$\times$10$^{\rm -3}$) in the previous model.

NOTE 2
For the XIS nominal position, the amplitude of the power law component should be increased by 10% to 8.8$\times$10$^{\rm -4}$, since the CXB is to first order position-independent while the HXD response to a point source at the XIS nominal position is reduced by 10%.

NOTE 3
Alternatively, the NXB background file and the simulated CXB PHA file can be added using mathpha, making sure that the EXPOSURE keyword should be the common value (and not the sum of both exposure times).

Please note that the level of CXB and its point-to-point scatter are an active research topic. Other estimates of CXB spectrum can be converted to xspec models following the same steps as above.

7.3.3.2 Systematic Uncertainties in the Non X-ray Background

The accuracy of the background model is expected to reach as good as 5-10 % of the average background. The background modeling, however, is still under development, and the evaluation of the systematic errors has not been completed yet.

Users are strongly recommended to verify the reliability of the background model:

7.4 Spectral Analysis of GSO Data

As of early January, 2008, the V2 GSO NXB files have just been released by the HXD team. Instructions will be posted on the GOF web site and included in the next version of the ABC guide.

7.5 Timing Analysis of PIN Data

The users can also generate background-subtracted PIN light curves using these background files. In this process, users need to take the dead time into account, using the pseudo event files. Since pseudo events are generated by the HXD analog electronics every 4 seconds for each of 16 units, we expect 16/4 = 4.0 ct/s in the absence of dead time. Therefore, the live time is given by the measured pseudo event rate during the time bin divided by 4.

The following method for correcting for bin-by-bin dead time is recommended only for bins longer than 128 s, to ensure that the dead time estimate is statistically accurate enough.

  1. Merge the GTIs (see Step 1 of Spectral Analysis of PIN Data section).

  2. Extract pure pseudo event light curve (i.e., those pseudo events that have no coincidental trigger flags from the real detectors).

    > fselect infile=ae123456789hxd_0_pse_cl.evt+1 outfile=pseudo_pure.evt \
                           expr ="GRADE_HITPAT<=1&&GRADE_QUALTY==0" histkw=yes
    

    Extract lightcurve from this ``pure'' pseudo event file, while applying the merged GTI file, and save it as pin_pseudo.lc, for example.

  3. Extract the source light curve using the merged GTI file. If this file is called pin_event.lc, the following steps will allow you to create a new RATE column which includes the dead time corrected RATE.

    > fcalc pin_pseudo.lc+1 pin_pseudo_div4.lc DTCOR  "RATE/4"
    > faddcol pin_event.lc+1 pin_pseudo_div4.lc+1 DTCOR
    > fcalc pin_event.lc+1 pin_event_dtcor.lc RATE "RATE/DTCOR"
    > fcalc pin_event_dtcor.lc+1 pin_event_dtcor.lc ERROR "ERROR/DTCOR" clobber=yes
    

    The above steps were: calculate the live time in the DTCOR column of a temporary file, pin_pseudo_div4.lc; copy that column into the light curve file, pin_event.lc; create a new light curve file pin_event_dtcor.lc in which the RATE column is dead time corrected; dead time-correct the ERROR column in that file.

  4. Extract the background light curve, and divide it by 10.

    > fcalc pin_bgd.lc+1 pin_bgd_div10.lc RATE "RATE/10"
    > fcalc pin_bgd_div10.lc+1 pin_bgd_div10.lc ERROR "ERROR/10" clobber=yes
    

    Note that, in addition to this light curve, the observed light curve contains the cosmic X-ray background component, which can be treated as a constant.

7.6 Initial Processing: the details

The remainder of this chapter describes the details of the initial processing for the HXD. These steps, already performed in the processing pipeline, can be repeated by users if necessary.

7.7 Standard Screening

For the HXD, the standard pipeline processing starts with an unfiltered file which contains events from both the GSO and PIN detector. This file contains ``wel" in its filename and the DETNAM keyword has the value ``WELL". We have described the processing steps (in the recommended order) below. We will describe first the processing for the PIN and GSO, and address later the processing for the WAM. Please note that users who only want a quick look at their data should not have to run these routines again but could use the files provided in the products directory

Users are also advised to create a second directory in which the newly processed files will be saved as some of the routines would otherwise just overwrite the existing files. To do so please type:

unix% mkdir event_cl2/; cd event_cl2/
unix% ln -s ../event_uf/aeNNNhxd_M_wel_uf.evt.gz . 
unix% ln -s ../hk/aeNNNhxd_0.hk.gz .
unix% ln -s ../../auxil/aeNNN.tim.gz .

Also please make sure that your CALDB directory is set-up properly. CALDB files are needed for the processing.

7.7.1 Time Assignment

The first step is to calculate the HXD event arrival-time correction. The arrival time of each true event time (in column TIME) is calculated from the HXD internal detector time value and other detector corrections. The computed time is then converted to Suzaku time coordinates using four separate methods (selected using the input parameter ``time_convert_mode"). In addition, the tool hxdtime measures the actual time resolution of ``TIME" during the observation. The standard way to run the hxdtime tool is to type:

hxdtime input_name=aeNNNhxd_M_wel_uf.evt create_name=aeNNNhxd_M_wel_uf2.evt \
leapsec_name=leapsec.fits hklist_name=aeNNNhxd_0.hk tim_filename=aeNNN.tim
where
input_name is the name of the original unfiltered event file in the hxd/event_uf directory
create_name is the name of the new (output) unfiltered event file name
leapsec_name is the name of the latest leap seconds file located in the CALDB (under mission ``gen", under the filename leapsec_010905.fits) and in the HEAsoft refdata area (where a file is simply known as leapsec.fits, whose contents depends on the version of HEAsoft; in the versions released after v6.1.1, it is identical to the leapsec_010905.fits)
hklist_name is the name of the HXD HK file found under hxd/hk
tim_filename is the name of the TIM file, found in auxil

Users may wish to confirm the following hidden parameters

read_iomode=create (a separate output file will be created)
time_change=yes (TIME column will be updated in principle)
grade_change=n (change GRADE_XX or not, no update in principle)
pi_pmt_change=n (change PI_SLOW, PI_FAST or not, no update in principle)
pi_pin_change=n (change PI_PIN or not, no update in principle)
gtimode=y (read and apply GTI extension or not)
gti_time=S_TIME (meaning of TIME in GTI, row level information)
time_convert_mode=4 (aste_ti2time function is used in calculation)
use_pwh_mode=n (use HXD_WEL_PWH extension in HXD HK FITS or not; always no)
num_event=-1 (control value for ANL routine; read all event if -1)
event_freq=10000 (control value for ANL routine; frequency of messages)
anl_verbose=-1 (control value for ANL routine; verbose level)
anl_profile=yes (control value for ANL routine; dump profile or not)

7.7.2 Gain History Generation

After filling in the corrected event time, the next step is to adjust the detector gain for both HXD detectors. In Version 2 processing, the gain history files are generated by the HXD team and provided to the CALDB. We have therefore discontinued the documentation regarding the generation of the HXD gain history.

7.7.3 Pulse Height Corrections

Once the gain drift has been measured, the (time) invariant event pulse-heights (PI) values can be determined. For the HXD, hxdpi calculates the HXD PI columns (PIN[0-3]_PI, SLOW_PI, FAST_PI) based on the relevant _PHA data, the gain history and other calibration data, such as non-linearity in the analog-to-digital conversion. The Gd edge effect is not included in SLOW/FAST_PI. The effect is included in the response matrix table for the GSO.

NOTE: This is the task that takes in the Gain History Files and use them to correct the PI values. Users should obtain the most up-to-date gain history table (for GSO) and the gain history file (for PIN) which are frequently updated by the team in CALDB.

The correct syntax to run the hxdpi task is:

unix% cat > hk_file.list << EOF
../hk/aeNNNNNNNNNhxd_0.hk.gz
../../auxil/aeNNNNNNNNN.ehk.gz
EOF

unix% hxdpi input_name=aeNNNhxd_M_wel_uf2.evt\
create_name=hxd_picorr_evt.fits hklist_name=@hk_list.dat\
hxd_gsoght_fname=CALDB hxd_gsolin_fname=CALDB \
hxd_pinghf_fname=CALDB hxd_pinlin_fname=CALDB

where
input_name is the HXD FITS file input name
create_name is the output name (see below)
hklist_name should be used to pass the HXD HK file name and the extended hk file name using the @list syntax
hxd_gsoght_fname is the GSO gain history table from CALDB
hxd_gsolin_fname is the name of CALDB file containing the GSO integrated non-linearity of ADC
hxd_pinghf_fname is the PIN gain history file from CALDB
hxd_pinlin_fname is the name of CALDB file containing the PIN integrated non-linearity of ADC

Warnings 1) For hxdpi, the hidden parameter read_iomode is set to overwrite by default, so the relevant columns of the input file will be modified. Optionally, select read_iomode=create and specify an output file name using the hidden parameter create_name. The others hidden parameters for this routine are similar to that of hxdtime.

2) In the above, please note that if the CALDB Gain History File does not include the observation date of the event fits file, the tool will run silently without updating the file content. Users are urged to check that their observation date is covered by the CALDB file.

3) The hidden parameter event_freq is by default set to 10000. This is the event print-out frequency. Users may want to increase the value of this parameters to avoid too long screen outputs. Look at the number of events in your initial event file to estimate a reasonable value for that parameter.

The command line would look like:

hxdpi input_name=ae401100010hxd_1_wel_uf2.evt read_iomode=create 
create_name=ae401100010hxd_1_wel_uf2-hxdpi.evt hklist_name=@hk_file.list
hxd_gsoght_fname=CALDB hxd_gsolin_fname=CALDB
hxd_pinghf_fhame=CALDB hxd_pinlin_fname=CALDB
event_freq=500000

7.7.4 Calculating Event Grade

HXD event files have 5 grade columns filled by the hxdgrade routine. The first column is simply GRADE_QUALTY which stores the data quality. All events with a GRADE_QUALTY flag not equal to 0 should be ignored. The two next columns indicate the origin of the event. The column GRADE_PMTTRG is set to 1 for any PMT triggered event while the column GRADE_PINTRG is set for 1 for any PIN triggered event. Column GRADE_PSDSEL gives the GSO likelihood in the Slow Fast diagram while the fifth column GRADE_HITPAT gives the hit pattern grade.

hxdgrade input_name=aeNNNhxd_M_wel_uf2.evt \
hxdgrade_psdsel_fname=CALDB \ hxdgrade_pinthres_fname=CALDB
where
input_name is the HXD FITS file input name
hxdgrade_psdsel_fname is the name of CALDB file containing the GSO PSD selection criteria (specify CALDB to pick the best file automatically; the file should have names like ae_hxd_gxopsd_20060620.fits)
hxdgrade_pinthres_fname is the name of CALDB file containing the PIN lower discriminator threshold (specify CALDB to pick the best file automatically; the file should have names like ae_hxd_pinthr_20060727.fits)

Warning Just as for hxdpi, hxdgrade has an hidden parameter read_iomode set to overwrite by default, so the relevant columns of the input file are modified. User may want to put the read_iomode=create and specify an output file name using the flag create_name.

Up until this step the file contain both GSO and PIN data (WELL data) and have not been separated yet. One can first do a series of cleaning procedures before separating the PIN and the GSO data.

7.8 Extracting Data

One can select for any criteria directly from the FITS file using the tool fselect part of the FTOOLS delivery or within xselect as described in Chapter 6. We show here how to proceed within xselect, as it can apply filters which select user-defined times, or particular event flags. It then uses the filtered events to create a (binned) spectrum (as well as generating the necessary calibration files), a lightcurve, or an exposure map. Some basic parameters to be used for common data screening are in the filter file. The ``select mkf'' command will be used to carry out filter file based data screening, by specifying boolean expression of the parameters and calculating corresponding Good Time Intervals (GTI).

7.8.1 General Selection criteria

The current cuts applied within the standard processing of the data read:
SAA_HXD==0 && T_SAA_HXD>500 && ELV>5 && ANG_DIST<1.5 && HXD_DTRATE<3 && \  
AOCU_HK_CNT3_NML_P==1 && COR>8 && \
HXD_HV_W0_CAL>700 && HXD_HV_W1_CAL>700 && HXD_HV_W2_CAL>700 &&\
 HXD_HV_W3_CAL>700 && HXD_HV_T0_CAL>700 && HXD_HV_T1_CAL>700 &&\
  HXD_HV_T2_CAL>700 && HXD_HV_T3_CAL>700
where
SAA_HXD==0 selects intervals during which Suzaku was outside the SAA, using a map of the SAA determined empirically by the HXD team (not to be changed or omitted)
T_SAA_HXD selects for the minimum time after the SAA passages (standard value but can be experimented with)
ELV selects the elevation of target above Earth limb to at least 5 degrees (standard value but can be experimented with)
ANG_DIST selects the pointing to within 1.5 arcmin of the mean (standard value but can be experimented with)
HXD_DTRATE excludes intervals during which the data rate low, since this means that the telemetry is saturated just with background events (not to be changed or omitted)
AOCU_HK_CNT3_NML_P==1 means normal pointing operation (not to be changed or omitted)
COR selects the geomagnetic cut-off rigidity to be at least 8 GeV/c (standard value but can be experimented with)
HXD_HV_Wn_CAL and HXD_HV_Tn_CA selects for the HXD operating with the usual setting (not to be changed or omitted)

In particular, it is possible to create your own Night Earth HXD data by changing ELV$>$5 with appropriate expressions involving ELV, DYE_ELV (elevation above the Sunlit limb of the Earth), and NTE_ELV (elevation above the night Earth).

within xselect the input would look like:

hakatan-91-event_cl2: xselect
 
                         **  XSELECT V2.4   **
 
> Enter session name >[xsel]  abc-guide
 Setting plot device to /NULL
abc-guide:SUZAKU > read events
> Enter the Event file dir >[./] 
> Enter Event file list >[] ae401100010hxd_1_wel_uf2-hxdgrade.evt
 
 Notes: XSELECT set up for      SUZAKU
 Time keyword is TIME       in units of s
 Default timing binsize =   16.000
 
Setting...
 Image  keywords   = UNITID     UNITID      with binning =    1
 WMAP   keywords   = UNITID     PIN_ID      with binning =    1
 Energy keyword   = PI_PIN                 with binning =    1
 
Getting Min and Max for Energy Column...
Got min and max for PI_PIN:     0    255
 
could not get minimum time resolution of the data read
MJDREF =  5.1544000742870E+04 with TIMESYS = TT
 Number of files read in:  1
 
******************** Observation Catalogue ********************
 
Data Directory is: 
/Volumes/Maison/Directories/Suzaku/MySuz/1E1841-045/v1.2.2.3/401100010/hxd/event_cl2/
HK Directory is:
 /Volumes/Maison/Directories/Suzaku/MySuz/1E1841-045/v1.2.2.3/401100010/hxd/event_cl2/
 
 
        OBJECT      DETNAM      DATE-OBS    DATE-END
      1 1E 1841-045 WELL        2006-04-19T 2006-04-22T
 
abc-guide:SUZAKU-HXD-WELL_PIN > 
abc-guide:SUZAKU-HXD-WELL_PIN > filter mkf
> Boolean expression for filter file selection >[ ] SAA_HXD==0 && T_SAA_HXD>500 && ELV>5 && 
ANG_DIST<1.5 && HXD_DTRATE<3 && AOCU_HK_CNT3_NML_P==1 && COR>8 
&&HXD_HV_W0_CAL>700 && HXD_HV_W1_CAL>700 && HXD_HV_W2_CAL>700 && 
HXD_HV_W3_CAL>700 && HXD_HV_T0_CAL>700 && HXD_HV_T1_CAL>700 && 
HXD_HV_T2_CAL>700 && HXD_HV_T3_CAL>700 
> Enter the filter file directory >[./] ../../auxil
PREFR keyword found in header, using prefr =   0.0
POSTFR keyword found in header, using postfr = 1.0
abc-guide:SUZAKU-HXD-WELL_PIN >

NOTE For data taken between March 14th 2006 to May 13th 2006, the GTI used in all the processing versions before v1.3 do not accurately represent the contamination of the data. The HXD team recommends users to use the GTI intervals they have generated using the processing v1.3 and made available for affected users. For more information, please access http://www.astro.isas.jaxa.jp/suzaku/analysis/hxd/hxdgti/.

7.8.2 Separating PIN and GSO data

At this point, both GSO and PIN are still in the file (even if xselect is reading is as WELL_PIN and this is the time to separate the two detectors. To do this, we will select on the column called DET_TYPE. DET_TYPE==1 selects PIN events while DET_TYPE==0 selects only GSO events.

To select the events to be used further down in the analysis, xselect input should read:

abc-guide:SUZAKU-HXD-WELL_PIN > filter column
> Enter filter on column(s) in the event file >[] DET_TYPE==1
abc-guide:SUZAKU-HXD-WELL_PIN > extract events

for spectral analysis, the HXD team may provide standard GSO responses which are valid only for some limited GRADE values; only events which have such GRADE values should be selected. On the other hand, for light curve analysis, the GRADE selection criterion may be loosened.

NOTE 1 As in the case of the PIN, a couple of keywords need to be modified in the final GSO event file created. The DETNAM keyword should be changed to WELL_GSO and the TIMEDEL keyword should be created - again users should check the value in the event_cl directory version).

7.9 WAM Processing

The HXD Wideband All-Sky Monitor (WAM) utilizes the BGO anti-coincidence detectors to create an all-sky monitor. Although from the same detector, these data are processed independently. There should be no need for the user to reprocess the data from the WAM (the HXD team will analyze the WAM data and make the results public) but we have included the description of the processing pipeline for completeness.

7.9.1 hxdwamtime

The hxdwamtime routine compute the HXD event arrival-time correction. The arrival time for events detected in the WAM is computed in a manner similar to the hxdtime routine, where the conversion to Suzaku time coordinate is done using one of four methods to be specified by the parameter time_convert_mode.

 hxdwamtime input_name=aeNNN_hxd_wam.fff  create_name=aeNNN_hxd_wam.uff \
hklist_name=@hk_list.dat leapsec_name=leapsec.fits tim_filename=aeNNN.tim
where
input_name is the HXD_WAM_FITS file name to archive the time correction
created_name is the HXD_WAM_FITS output name
hklist_name is the HXD_HK_FITS file list name or input as @hk file list
leapsec_name is the name of the leap-seconds file located under the HEAsoft refdata area
tim_filename is the name of the TIM file.

7.9.2 hxdmkwamgainhist

This routine produces a gain history file for the WAM FITS, where gain-correction factor is given as a function of time. It is determined by fitting the data of the 511 keV line, much as the gain histogram is calculated for the HXD GSO from the Gd line. The fitting results are recorded in a log file. The gain history file will be used as input for hxdwampi.

hxdmkwamgainhist input_name=aeNNN_hxd_wam.uff trn_fitlog_name=aeNNN_hxd_wam_fit.log \
trn_gainhist_name=aeNNN_hxd_wamghf.fits  leapsec_name=leapsec.fits
where
input_name is the HXD WAM FITS file name
trn_fitlog_name is the name of the log (ASCII output)
trn_gainhist_name is the name of the gain history file (output) to be used as input for hxdwampi
leapsec_name is the name of the leap-seconds file located under the HEADAS ref area

7.9.3 hxdwampi

The hxdwampi routine calculates the time-invariant pulse-height value for each HXD WAM event, which is stored in the TRN_PI column. By default, the input file is used as the output, although this can be modified by setting the create_name parameter. The gain drift is not corrected in the current hxdwampi, but instead is considered in the response matrix. The task expands the reduced PH table via HXD-DE on-board process. The setting is identified by the column ``TRN_TBL_ID", which is defined in the caldb FITS file named ``ae_hxd_wampht_YYYYMMDD.fits" (currently ``ae_hxd_wampht_20050916.fits").

 hxdwampi input_name = aeNNN_hxd_wam.uff  hklist_name = @hk_list.dat\
 trn_bintbl_name =   CALDB/ae_hxd_wampht_20050916.fits \
trn_gainhist_name = aeNNN_hxd_wamghf.fits
where
input_name is the input HXD WAM file name
hklist_name is the HXD HK FITS file list name or input as @hk file list
trn_bintbl_name is the name of the CALDB file associated with the PH compression process
trn_gainhist_name is the file name of the gain history file output of hxdmkwamgainhist.

7.9.4 hxdwamgrade

This routine calculates the event grade for a WAM event, much as the hxdgrade tool does for a standard HXD event. As with the hxdwampi tool, by default the input event file is also used as the output file, simply modifying the QUALITY column.

hxdwamgrade input_name=aeNNN_hxd_wam.uff  hklist_name=aeNNNhxd_0.hk
where
input_name is the input HXD WAM file name
hklist_name is the name of the input HK file

7.9.5 hxdbsttime

Fill the ``BST_FRZD_TM" keyword in the header of the BURST FITS.

hxdbsttime input_name=aeNNN_hxd_bst_0.fff create_name=aeNNN_hxd_bst_0.uff\
 hklist_name=@hk_list.dat  leapsec_name=leapsec.fits  tim_filename=aeNNN.tim
where
input_name is the HXD WAM FITS file name
create_name is the HXD WAM FITS output name
hklist_name is the HXD HK FITS file list name or input as @hk file list
leapsec_name is the name of the leap-seconds file located under the HEAsoft refdata area
tim_filename is the name of the TIM file.


next up previous contents
Next: A. Acronyms Up: Suzaku ABC Guide Previous: 6. XIS Data Analysis   Contents
Michael Arida 2008-01-11