temp2gain HEADAS help file

NAME

temp2gain -- Make a GIS gain history file in FITS format from FRF file.

USAGE

         temp2gain frffile calfile outfile tblfile g2hfile g3hfile method steptime

DESCRIPTION

This task reads a FRF file and makes a GIS gain history file in FITS format which is used for ASCALIN. The GIS gain is calculated with a function of ASCATIME and TEMPERATURE. The parameters of the function are written in the calibration file supported by the GIS team. Don't forget to check the gain history file by fplot(X axis:CAL_START, Y axis:TEMP_S2 FE55_PEAK_S2 TEMP_S3 FE55_PEAK_S3)

PARAMETERS

frffile [file name]

The FRFfile name, you are going to process.

calfile [file name]

The name of the calibration file including time history of calibration parameters (gis_temp2gain.fits). This file is updated every 30 days by the GIS team.

outfile [file name]

The name of the output gain history file in FITS format which is used for ASCALIN.

tblfile [file name]

The table file name in ascii format. The contents are almost the same as outfile.

g2hfile [file name]

The GIS2 LDHIT table file name in ascii format.

g3hfile [file name]

The GIS3 LDHIT table file name in ascii format.

method [integer] (0:Auto, 1:Linear Interpolation, 2:Analytic function).

Method of calculating the GIS gain.

1: By interpolating the monthly coefficients written on the gis_temp2gain.fits.
2: Analytic function calculated from Apr.'93-Jan.'94 data. The parameters are written on gis_temp2gain.fits.
0: Automatically selects "Analytic function" for Apr.1993 - Jan.1994
and "Linear Interpolation" otherwise.

                        you are recommended to select "Auto".

steptime [double precision] (sec)

Time interval while the temperature is averaged. If you set this parameter "0", the temperature is not averaged. Set 1800 if you want to set it as long as used in MKGAINHIST.

(version = 4) [integer]

The version number for file format of output FITS file. You have to set it 4.

(ldh_flag = no) [boolean]

Flag for applying gain correction with LDHIT counting rate. The LDHIT correction function is still under investigation and is not guaranteed. At default, it is set to no.

(nor_fac2 = 1) [double precision]

Normalization Factor for GIS2, with which you can perform a gain correction factor in your custom-made way. When you use ftools-3.5-ASCALIN and want to perform time-dependent Gain Map correction, you can use this gain factor. The nor_fac2 is constant over the whole field of view.

(nor_fac3 = 1) [double precision]

Normalization Factor for GIS3 See above.

(mergesec = 2) [double precision]

Margin Seconds. Start time of the gain history file is (FRFstart time - mergesec), and the end time is (FRFend time + mergesec).

(clobber = no) [boolean]

If true, output file will be overwrite a file of the same name, if it exists.

EXAMPLES

         % setenv LEAPTABLE /xray/h1/adprocess/home/lib/leapsec.dat
         % temp2gain
     temp2gain v4.2
     FRF file name[ft940630_0738.1320G] ft940630_0738.1320G
     Input long term gain parameter file[gis_temp2gain.fits] gis_temp2gain.fits
     Output FITS file name[ft940630_0738.1320.ghf] ft940630_0738.1320.ghf
     Output text file name[ft940630_0738.1320.tbl] ft940630_0738.1320.tbl
     GIS2 LDHIT output text file name[ft940630_0738.1320.g2h] ft940630_0738.1320.g2h
     GIS3 LDHIT output text file name[ft940630_0738.1320.g3h] ft940630_0738.1320.g3h
     Method(0:Auto, 1:Linear Interpolation, 2:Analytic function)[0] 0
     Time interval(sec)[1800] 1800
     GIS2 LD: grad=2.743800e-05, offs=0.999250, thrs=50.000000
     GIS3 LD: grad=1.755900e-05, offs=1.000200, thrs=50.000000
     opening ft940630_0738.1320G
     This is small GIS FRF file
     Index table has been found
     'ft940630_0738.1320G' is successfully opened
     Data Start Time is 47117344.00 (940630 080903)
     Time Margin 2.0 sec included
     'ft940630_0738.1320G' EOF detected, sf=2669
     Data End Time is 47136043.94 (940630 132042)
     Gain History is written in ft940630_0738.1320.ghf

BUGS