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.