NAME
sxssamcnt - Calculate the local time at fine resolution in Hitomi SXS
files for later synchronization with the GPS-related time in final
time assignment.
USAGE
sxssamcnt infile outfile
DESCRIPTION
The sxssamcnt task calculates the SXS local time and fills the
sample count column(s) that represent the fine time resolution
assigned internally by the instrument electronics. This is used to
assign time using the ahtime task. After sxssamcnt is executed,
ahtime synchronizes the fine local time to the TT time (obtained via
the GPS). It may be applied to SXS (pixel and antico) event,
diagnostic mode, lost GTI, and HK files. The diagnostic mode files that
this task is applied to are the pixel WaveForm Ring-Buffer (WRFB),
antico and pixel noiserec, and pixel pulserec data files.
The input file columns required to calculate sample count depend on
file type, and may be specified using the appropriate subset of
'col1', 'col2', 'col3', col4', and 'col5' parameters. For pixel
event and diagnostic files, by default these are (col1) TRIG_LP,
a rough event trigger time, (col2) TIME_VERNIER, a fine time
correction, (col3) WFRB_WRITE_LP, a reference for TRIG_LP, and
(col4) WFRB_SAMPLE_CNT, a reference for SAMPLECNT. For antico event
and diagnostic files, by default, these are (col1) TRIG_LP, (col3)
WFRB_WRITE_LP, (col4) WFRB_SAMPLE_CNT, and (col5) FLG_EVENT_LOST;
For HK files, by default, these are (col1) LATCH_SAMPLE_CNT1, a
reference for SAMPLECNT, and (col2) LATCH_BASE_CNT1, a fine clock
value. For lost GTI files, by default, these are (col1) EL_#_LP,
which is the TRIG_LP for the beginning and end of the interval, (col3)
WFRB_WRITE_LP, and (col4) WFRB_SAMPLE_CNT. The hash (#) symbol for
the lost event file directs the task to calculate two sample count
values using values in the columns EL_START_LP and EL_STOP_LP. For
antico and lost GTI files, the value(s) specified by the
parameter(s) 'timever1' and 'timever2' set the TIME_VERNIER (fine
time correction) used in the sample count calculation(s). Since
antico event times and lost GTI are used in event screening, this
allows for some margin and/or offset relative to pixel events.
The result of the sample count calculation is written in the column(s) set by the
parameter 'outcol'. The file type determines the default number of
columns and column names: SAMPLECNT for antico and sxs hk files,
SAMPLECNT1 and SAMPLECNT2 for lost GTI files (corresponding to
EL_START_LP and EL_STOP_LP, respectively), and SAMPLECNT and
SAMPLECNTTRIG for pixel files. SAMPLECNTTRIG, is derived in a
similar manner to the other local time values, and enables the
calculation of the event trigger time by ahtime. SAMPLECNT for pixel
files, which enables the calculation of the event arrival time by ahtime,
is derived from a polynomial function of SAMPLECNTTRIG, whose
coefficients are stored in CALDB.
PARAMETERS
- infile [filename]
- Input SXS event file name. This file may be one of several types,
containing either pixel events, antico events,
specific types of diagnostic modes, HK data, or lost GTI data.
- outfile [filename]
- Output SXS event file name with the sample count column(s)
relevant for the type of file specified by 'infile'.
- (col1 = DEFAULT) [string]
- Column name for the rough local time. If 'col1=DEFAULT', this is
set to TRIG_LP for pixel, antico, pulserec, and noiserec event files;
to LATCH_SAMPLE_CNT1 for SXS HK extensions; and to EL_#_LP for lost
GTI, where # indicates that both START and STOP times are
processed.
- (col2 = DEFAULT) [string]
- Column name for the fine local time correction. If 'col2=DEFAULT',
this is set to TIME_VERNIER for pixel and pulserec event files and to
LATCH_BASE_CNT1 for an SXS HK extension. For other file types this
parameter is ignored.
- (col3 = DEFAULT) [string]
- Column name for the reference for rough local time. If
'col3=DEFAULT', this is set to WFRB_WRITE_LP for pixel, antico,
pulserec, noiserec, and lost GTI files. For HK files this parameter is
ignored.
- (col4 = DEFAULT) [string]
- Column name for the reference sample count. If 'col4=DEFAULT',
this is set to WFRB_SAMPLE_CNT for pixel, antico, pulserec, noiserec,
and lost GTI files. For HK files this parameter is ignored.
- (col5 = DEFAULT) [string]
- Column name that specifies whether an antico event is a lost
antico event. If 'col5=DEFAULT', this is set to FLG_EVENT_LOST, and
the SAMPLECNT column is set to its null value if FLG_EVENT_LOST=1. If
the input file is not an antico file this parameter is ignored.
- (timever1 = DEFAULT) [integer]
- Time (in units of 5 microsecond ticks) to be added to the local
time calculation. For lost GTI files, this value is added to the
sample count corresponding to the START time. For antico events this
value is added to the SAMPLECNT column. Default values are 23 for lost
GTI, and 0 for antico events.
- (timever2 = DEFAULT) [integer]
- Time (in units of 5 microsecond ticks) to be added to the local
time calculation. For lost GTI files, this value is added to the
sample count corresponding to the STOP time. The default value is -8
for lost GTI.
- (outcol = DEFAULT) [string]
- Output column name for the calculated local time. If set to
DEFAULT, the name is SAMPLECNT for antico, pulserec, and noiserec
files, and SXS HK extensions. For lost GTI files, by default the
columns are SAMPLECNT1 and SAMPLECNT2, otherwise the names of the
two columns are generated by appending '1' and '2' to the string
specified by 'outcol'. For pixel events, by default, the columns are
SAMPLECNT and SAMPLECNTTRIG; otherwise use the 'outcol' string for
one file name and generate the second by appending the string 'TRIG'
to 'outcol'.
- (buffer = -1) [integer -1|0|N]
- Rows to buffer (-1=auto, 0=none, N>0=numrows).
- (clobber = no) [boolean yes|no]
- Overwrites the existing output file if set to yes.
- (chatter = 1) [integer 0|1|2|3]
- Chatter level for output. Set to 0 to suppress output,
or to 1, 2, or 3 for increasing the chatter of the output.
- (logfile = !DEFAULT) [string DEFAULT|NONE|file name]
- Log file name. If set to DEFAULT, uses the name of the task and, if
preceded by "!", overwrites the file if it exists. If set to NONE, no
log file is created.
- (debug = no) [boolean yes|no]
- Diagnostic output is printed to the screen if set to yes.
- (history = yes) [boolean yes|no]
- Records tool parameters in HISTORY.
EXAMPLES
- Calculate SAMPLECNT for the SXS HK file hk_in.fits, creating an
output HK file (hk_out.fits) with the SAMPLECNT column populated
according to the values in the LATCH_SAMPLE_CNT1 and LATCH_BASE_CNT1
columns.
sxssamcnt hk_in.fits hk_out.fits
- Calculate SAMPLECNT for the SXS pixel event file event_in.fits,
creating an output event file (event_out.fits) with the SAMPLECNT
column populated according to the values in the WFRB_SAMPLE_CNT,
WFRB_WRITE_LP, TRIG_LP, and TIME_VERNIER columns.
sxssamcnt event_in.fits event_out.fits
- Calculate SAMPLECNT for an SXS antico event file antico_in.fits,
creating an output event file (antico_out.fits) with the SAMPLECNT
column populated according to the values in the WFRB_SAMPLE_CNT,
WFRB_WRITE_LP, TRIG_LP, and FLG_EVENT_LOST columns.
sxssamcnt antico_in.fits antico_out.fits
- Calculate the start and stop SAMPLECNT values for the lost GTI
file lost_in.gti, creating an output event file (lost_out.gti) with
the SAMPLECNT1 and SAMPLECNT2 columns populated according to the
values in the WFRB_SAMPLE_CNT, WFRB_WRITE_LP, and TRIG_LP
columns. Shrink each interval by extending the GTI START times by 30
ticks and curtailing the STOP times by 15 ticks..
sxssamcnt lost_in.gti lost_out.gti timever1=30 timever2=-15
SEE ALSO
ahtime
LAST MODIFIED
Februart 22, 2024