HXDWAMTIME (July 2008) suzaku.hxd HXDWAMTIME (July 2008) NAME hxdwamtime -- fill the TIME column for the WAM_ANTI transient FITS. USAGE hxdwamtime input_name tim_filename leapfile hklist_name DESCRIPTION Carry out HXD event arrival-time correction. The arrival time of each transient histogram 'TIME' is calculated from 'TRNTIME'(24-bit time counter in HXD-AE) and 'TI' (DP time), by referring to the 'HXD_TLATCH_TIME' ('TI' at the origin of 'TRNTIME'), and the 'HXD_AE_TM_LATCH_TM' (latched value in HXD-AE) columns in HK file, The arrival time 'TIME' is finally converted into aetime (Suzaku time coordinate) by either of three methods specified with the parameter "time_convert_mode". In addition, the hxdscltime add the unit of 'TRNTIME' by refereing to 'TRN_TIME_MODE', and measure the actual time resolution of 'TIME' during the observation to revice the 'TIMEDEL' keyword. PARAMETERS (read_iomode = create) HXD WAM fits input I/O mode : overwrite or create (time_change = y) HXD WAM fits update TIME : y or n (pi_change = n) HXD WAM fits update PI : y or n (quality_change = n) HXD WAM fits update GRADE : y or n (gtimode = y) HXD WAM fits using GTI : y or n (gti_time = S_TIME) HXD WAM fits using time : TIME or S_TIME input_name HXD WAM fits file name create_name HXD WAM fits created file name hklist_name HXD HK fits file or @HK file list. leapfile 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. tim_filename TIM File name (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 WAM aetime 4: use astetool, aste_ti2time() with tim FITS file. (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 (chatter = 2) message chatter level (0:min, 2:norm, 5:max) EXAMPLES Calculate arrival time 'TIME' for the event file named "ae20041215_1055_1341_hxd_wam.fff", and create an event FITS "ae20041215_1055_1341_hxd_wam.uff", using HK FITS listed in "hk.list", TIM file named "ae20041215_1055_1341.tim" and leapsec FITS, "leapsec.fits": ft> hxdwamtime create_name="ae20041215_1055_1341_hxd_wam.uff" \ input_name="ae20041215_1055_1341_hxd_wam.fff" \ leapfile="leapsec.fits" \ hklist_name="@hk.list" \ tim_filename="ae20041215_1055_1341.tim" BUGS SEE ALSO AUTHOR Yukikatsu TERADA (Saitama Univ), Ryouhei MIYAWAKI (Univ. of Tokyo) and the HXD-WAM team suzaku-wam@astro.isas.jaxa.jp. LAST MODIFIED July 2008