NAME
uvotevgrism - filter a UVOT grism event list and determine wavelength
USAGE
uvotevgrism infile=<filename> outfile=<filename>
DESCRIPTION
This tool operates on grism UVOT level 2 event files. The output file matches the input except for the EVENT extension which is updated to include only those events which fall in the dispersion region.
The dispersion region is a rectangle defined in terms of the source position (0th order right ascension and declination), the angle of the dispersion axis (measured clockwise from the +X axis), pixel width, and wavelength bounds for position on the dispersion axis.
PARAMETERS
- infile [filename]
- UVOT level 2 events file (see SSC UVOT Data Handbook).
- outfile [filename]
- UVOT level 2 events file (see SSC UVOT Data Handbook).
- wavefile [filename]
- Pixel to wavelength conversion calibration file.
- teldeffile [filename]
- Telescope definition file.
- attfile [filename]
- Attitude history file.
- (attlim = 32) [real]
- Attitude extrapolation limit [s]
- ra [real]
- 0th order right ascension [degrees]
- dec [real]
- 0th order declination [degrees]
- (uvang = 207) [real]
- Angle from +X axis to UV dispersion axis [degrees]
- (uvwid = 30) [real]
- Width of UV 1st order dispersion region [pixels]
- (uvmin = 300) [A]
- Wavelength corresponding to lower end of UV extraction region.
- (uvmax = 2000) [A]
- Wavelength corresponding to upper end of UV extraction region.
- (vang = 207) [real]
- Angle from +X axis to V dispersion axis [degrees]
- (vwid = 30) [real]
- Width of V 1st order dispersion region [pixels]
- (vmin = 2000) [A]
- Wavelength corresponding to lower end of V extraction region.
- (vmax = 6000) [A]
- Wavelength corresponding to upper end of V extraction region.
- (chatter = 1) [enumerated integer]
- Standard HEAdas chatter parameter.
A range of 0 to 5 is enforced by the
min and max fields in the parameter file.
- (clobber = no) [boolean]
- Standard HEAdas clobber parameter.
- (history = yes) [boolean]
- Standard HEAdas history parameter.
EXAMPLES
The following example illustrates running uvotevgrism
1. run uvotevgrism specifying input and output event files, attitude file, and source position (ra and dec) on the command line
uvotevgrism infile=sw00070911011ugvb1.unf.fits outfile=evgrism.fits \
ra=286.16 dec=08.17 attfile=sw00070911011snone.att.fits
SEE ALSO
LAST MODIFIED
May 2004