xrtproducts help file

NAME

xrtproducts -- Generate high level product data files from a cleaned event file.

USAGE

xrtproducts infile outdir [parameter = ]

DESCRIPTION

'xrtproducts' extracts high level product data files, i.e. spectra, light curves and images, for the XRT Photon Counting (PC), Windowed Timing (WT) and Photodiode (PD) modes data using as input the calibrated and screened event file (Level 2). For the XRT Image mode data, 'xrtproducts' produces a sky coordinates image plot.

The Photon Counting mode products are: spectrum, light curve and image. The source spectrum and light curve are extracted by filtering the data on a spatial region in sky coordinates. If the parameter 'regionfile' is set to DEFAULT the user, through the parameters 'ra', 'dec' and 'radius', can specify the Right Ascension and Declination of the center and the radius of a circular extraction region. A region file with an arbitrary shape can be input through the parameter 'regionfile'. This file should have a format compatible with 'xselect' and 'ds9'. A full field of view image in sky coordinates in the 0.5-10 keV band is produced if the parameter 'imagefile' is different from 'NONE'.
Windowed Timing mode products are: spectrum, light curve and image. The WT mode has only information in one one spatial dimension. If the parameter 'regionfile' is set to DEFAULT the user, through the parameters 'ra', 'dec' and 'radius', can specify the Right Ascension and Declination of the center and the radius of a circular extraction region. A region file with an arbitrary shape can be input through the parameter 'regionfile'. An image in RAW coordinates is produced if the parameter 'imagefile' is different from 'NONE'
Low rate and Piledup Photodiode modes products are: spectrum and light curve. The PD modes, Low Rate and Piledup, do not have spatial information and all the events are used to create a spectrum and a light curve.
Image mode products are: image plot. The task'xrtproducts' generates a plot of the full field of view image in sky coordinates.

Spectra and light curves for all modes are not background subtracted. For the PC and WT modes, the region definition is assumed to be always in sky coordinates. The user can set the binsize (in seconds) and the minimum and maximum PI channels of the extracted light curve via the parameters 'binsize', 'pilow' and 'pihigh', respectively. Moreover, the user can apply a time filter to the event file providing in input a fits GTI file (parameter 'gtifile').

If the parameter 'phafile' is different from 'NONE' the spectrum is extracted and the ARF file is calculated via the task 'xrtmkarf'. Only for PC and WT modes, the arf calculation takes into account an input exposure map if the parameter 'expofile' is different from 'NONE'. The ARF file can also be generated by running separately 'xrtmkarf' (see 'xrtmkarf' help).

By setting the parameter 'plotdevice' to GIF or PS, the user can choose the device for the plots of the image, light curve and spectrum generated.

PARAMETERS

infile [file name]: Name of the input FITS event file to be processed. Unix-compressed file are allowed.
regionfile [file name]: Name of the region file for spatial filtering. If DEFAULT a standard spatial region is used for products extraction. For PC and WT modes the standard spatial region is a CIRCLE specified through the parameters 'ra', 'dec' and 'radius'.
outdir [directory name]: Directory for the output files.
stemout [string]: Stem for the output files. Input 'DEFAULT' to use Standard Naming Convention.
ra [string]: Right Ascension (J2000.0) of the center of the region to be used for spatial filtering.
dec [string]: Declination (J2000.0) of the center of the region to be used for spatial filtering.
radius [real]: Radius of the circular region for spatial filtering in pixel (only for PC and WT).
binsize [real]: Bin size (seconds) for the light curve. If <0 a default value is used (2.51 s for PC, 1 s for WT and PD, 0.1 s for WT in SETTLING mode).
(display = no): If 'yes' is input, plots the image of the field on the screen.
(lcfile = DEFAULT) [file name]: Name of the output light curve file or DEFAULT to use stem or NONE for none.
(phafile = DEFAULT) [file name]: Name of the output spectrum file or DEFAULT to use stem or NONE for none.
(imagefile = DEFAULT) [file name]: Name of the output image file or DEFAULT to use stem or NONE for none.
(gtifile = NONE) [file name]: Name of the input GTI file for spectrum and light curve extraction or NONE for none
(arffile = DEFAULT) [file name]: Name of the output ARF file. DEFAULT to use stem.
(rmffile = CALDB) [file name]: Name of the input RMF file. If set to CALDB (default), use the file in the Calibration Database.
(mirfile = CALDB) [file name]: Name of the input mirror on-axis effective area file. If set to CALDB (default), use the file in the Calibration Database. Used only if parameter 'inarffile' is NONE.
(transmfile = CALDB) [file name]: Name the input filter transmission file. If set to CALDB (default), use the file in the Calibration Database. Used only if parameter 'inarffile' is NONE.
(inarffile = CALDB) [file name]: Name of the input on-axis Ancillary Response Function (ARF) file. If set to 'CALDB' (default value), use the file in the Calibration Database. If set to NONE the on-axis ARF is calculated using the parameters 'mirfile' and 'transmfile'.
(psffile = CALDB) [file name]: Name the input psf FITS file. If CALDB is input (default), use the file in the Calibration Database.
(vigfile = CALDB) [file name]: Name input vignetting FITS file.If CALDB is input (default), use the file in the Calibration Database.
(psfflag = yes) [boolean]: If set to 'yes', correct for the PSF when calculates the ARF.
(extended = no) [boolean]: Extended source flag for ARF generation.
(arfboxsize = 20) [integer]: Size in pixel for the subimage boxes for ARF generation (used if extended=yes).
(expofile = NONE) [file name]: Name of the input exposure map file or NONE for none.
(plotdevice = gif): Device for plots (gif or ps).
(pilow = 30) [integer]: Minimum PI value for light curve extraction
(pihigh = 1000) [integer]: Maximum PI value for light curve extraction
(clobber = no): If set to 'yes', overwrite the output files with same name if they exist.
(chatter = 3) [integer]: Verbosity Level from 0 to 5.
(history = yes) [boolean]: If set to 'yes', include history records.
(cleanup = yes) [boolean]: If set to 'yes', delete temporary files.

EXAMPLES

From a Photon Counting mode event file generates spectrum, light curve and image of a source included in the region of 20 pixels radius centered on celestial coordinates (RA,Dec)=(43.5645,45.2048). The binsize of the light curve has been set to 100 s.
```
>  xrtproducts infile=sw00073125003xpcwnpocl.evt stemout=DEFAULT 
regionfile=DEFAULT outdir=./ binsize=100 ra=43.5645 dec=45.2048 radius=20
```

BUGS

LAST MODIFIED

August 2010