HXDBSTTIME (Jul 2008)            suzaku.hxd              HXDBSTTIME (Jul 2008)

NAME
	hxdbsttime -- fill 'BST_FRZD_TM' in the header of the BURST FITS

USAGE
	hxdbsttime input_name tim_filename leapfile bstidt_fname 
                   hklist_name create_name
		   

DESCRIPTION
	Time assignment for the burst FITS file. Fill the 'FRZD_TMn' and 
        'DATE_FZn' (n=0,1,2,3) keyword in the header of the BURST FITS,
        and modifies 'TM_MODEn (n=0,1,2,3)'. 

PARAMETERS
(read_iomode = create)          
        HXD event fits input I/O mode : overwrite or create 

input_name [filename]
        HXD Burst event fits file name  

create_name [filename]
        HXD event fits output filename. Necessary only when read_iomode is set to create

hklist_name [filename]
        Input of the HXD HK fits file or @HK ASCII file list of the HXD HK files.
        In the hxd/hk directory of the sequence. 

tim_filename [filename]
        TIM File name in the auxil directory of the sequence 

leapfile [filename]
        Input leap-seconds file including the path. This file is located
        in the HEADAS refarea. See enviroment variable $LHEA_DATA.
	If the value is set to "CALDB", the tool automatically access the 
        latest leapsec file in the HEADAS area.

(time_convert_mode = 4)               
        HxdTime2aetime mode.: 1, 2, 3, 4
        1: use internal function in interpolation (TI to aetime).
        2: use telemetry aetime, and simply add sub_aetime
        3: use telemetry aetime, and interpolate event aetime
        4: use astetool, aste_ti2time() with tim FITS file.

bstidt_fname [filename]
	Burst id file. It is stored in the hxd/event_uf directory of the sequence.
	
(num_event = -1)              
        number of event (-1=all, 0=exit)

(event_freq = 10000)           
        Event number printout frequency

(anl_verbose = -1)
        ANL verbose level (-1:full, 0:minimum)

(anl_profile = yes)
        Enable ANL module profiling

EXAMPLES

1.	Fill the 'BST_FRZD_TM' keyword in "ae20040824_1853_1959_hxd_bst_0.fff",
	using HK FITS files listed in "hk.list" and time file named
	"ae20041215_1055_1341.tim"

	% hxdbsttime input_name="ae20040824_1853_1959_hxd_bst_0.fff" \
		hklist_name="@hk.list" leapfile="refdata/leapsec.fits" \
		tim_filename="ae20041215_1055_1341.tim" create_name=output
BUGS

It does not run correctly on all mac platforms 

SEE ALSO


AUTHOR
   Yukikatsu TERADA (Saitama University), Kazutaka YAMAOKA (AOYAMA), 
   Yoshitaka Hanabata (Hiroshima University) and the HXD-WAM team
   suzaku-wam@astro.isas.jaxa.jp

LAST MODIFIED

   July 2008