Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/eventdef.html
Jump to: Description ยท See Also


AHELP for CIAO 4.15

eventdef

Context: chandra

Synopsis

Column definition in Chandra event files

Description

The following show the available options for setting the event definition for the Chandra event processing tools (acis_process_events, hrc_process_events, and tg_resolve_events). The "Data Products" Guide - available from the CIAO manuals page - contains a detailed explanation of the columns. The meaning of the DataType column is given below.

Valid ACIS event definitions: acis_process_events

EventDef Column DataType
time TIME d
expno EXPNO l
bias [BIAS] s
bias# BIAS# s
pha PHA s,l
pha_ro PHA_RO s,l
pha_mean|corn_pha CORN_PHA s
phas [PHAS] s
phas# PHAS# s
rawphas [RAW_PHAS] s
rawphas#|raw_phas# RAW_PHAS# s
total_amp TOT_AMP s
fltgrade|flt_grd FLTGRADE s
grade GRADE s
energy ENERGY s,l,f,d
pi PI s,l
ccdid|ccd_id CCD_ID s
ccdnode|ccd_node|node_id|nodeid NODE_ID s
fep_id FEP_ID s
detx|det_x DETX s,l,f,d
dety|det_y DETY s,l,f,d
det DET=(DETX,DETY) s,l,f,d
ccdx|ccd_x CCDX s
ccdy|ccd_y CCDY s
ccd CCD=(ccdx,ccdy) s
chipx|chip_x CHIPX s
chipy|chip_y CHIPY s
chip CHIP=(CHIPX,CHIPY) s
chipy_tg CHIPY_TG f,d
chipy_zo CHIPY_ZO f,d
tdetx|tdet_x TDETX s,l,f,d
tdety|tdet_y TDETY s,l,f,d
tdet TDET=(TDETX,TDETY) s,l,f,d
x X s,l,f,d
y Y s,l,f,d
sky SKY=(X,Y) s,l,f,d
trow TROW s
sky_1D SKY_ID s,l,f,d
status STATUS x,s

acis_process_events also recognizes and will propagate the tg_resolve_events columns. This is mostly to support ACIS+HETG datasets taken in Continuous Clocking (CC) mode.

Valid HRC event definitions: hrc_process_events

EventDef Column DataType
time TIME d
cp_x|crsu|coarsex|coarse_x CRSU s
cp_y|crsv|coarsey|coarse_y CRSV s
au1|ax1 AU1 s
au2|ax2 AU2 s
au3|ax3 AU3 s
av1|ay1 AV1 s
av2|ay2 AV2 s
av3|ay3 AV3 s
pha PHA s
pi PI s
amp_sf amp_sf s
sumamps sumamps s
samp samp f
chip_id chip_id s
rawx|raw_x RAWX l
rawy|raw_y RAWX l
raw RAW=(RAWX,RAWY) l
detx|det_x DETX s,l,f,d
dety|det_y DETY s,l,f,d
det DET=(DETX,DETY) s,l,f,d
chipx|chip_x CHIPX s
chipy|chip_y CHIPY s
chip CHIP=(CHIPX,CHIPY) s
tdetx|tdet_x TDETX s,l,f,d
tdety|tdet_y TDETY s,l,f,d
tdet TDET=(TDETX,TDETY) s,l,f,d
x X s,l,f,d
y Y s,l,f,d
sky SKY=(X,Y) s,l,f,d
status|stat status x,l

Valid grating event definitions: tg_resolve_events.

EventDef Column DataType
tg_r tg_r f,d
tg_d tg_d f,d
rd rd=(tg_r,tg_d) f,d
gdpx gdpx s,us,l,ul
gdpy gdpy s,us,l,ul
gdp gdp=(gdpx,gdpy) s,us,l,ul
tg_part tg_part s
tg_m tg_m s,us,l,ul
tg_mlam tg_mlam f,d
tg_lam tg_lam f,d
tg_srcid tg_srcid s
tg_smap tg_smap s

These are in addition to all the HRC defintions, and all the ACIS definitions except: rawphas, corn_pha, total_amp, and trow.

The following are the supported datatypes

Token Data Types
s short
l|i long
f|r float
d double
x bit
us unsigned short
ul unsigned long
ub byte
q boolean
c text/string

Note: It is possible to specify a datatype other than the supported types for the various columns identified above; however, the results will be unpredictable and may cause the tools to exit ungracefully.

See Also

tools
acis_build_badpix, acis_clear_status_bits, acis_detect_afterglow, acis_find_afterglow, acis_process_events, acis_streak_map, acisreadcorr, combine_grating_spectra, destreak, detilt, dewiggle, dmtype2split, hrc_build_badpix, hrc_dtfstats, hrc_process_events, mktgresp, readout_bkg, symmetrize, tg_bkg, tg_choose_method, tg_create_mask, tg_findzo, tg_resolve_events, tgdetect, tgdetect2, tgextract, tgextract2, tgidselectsrc, tgmask2reg, tgmatchsrc, tgsplit