CONVREGION

Description:

convregion converts region information in sky coordinates (RA,Dec) into region information in detector coordinates (DETX,DETY). It operates in three modes where 1) region input and output files are used, 2) ascii file lists of region descriptors are both input and output, and 3) region descriptors for individual regions are input on the command line and output on the screen. Currently only circular and elliptical regions are supported.

Requirements:

The current location should be the working directory.

A region information file with entries in celestial coordinates with RA and Dec in decimal degrees, the radius in circular regions in arc minutes or the semi-major and semi-minor axes in arc minutes for elliptical regions, and the rotation angle in decimal degrees for elliptical regions.

Calling Parameters:

mode – mode=1 uses fits region files for both input and output. mode=2 uses ASCII files for both input and output. Each line is an ordered groups of SHAPE, RA, DEC, R (for elliptical regions the semi-major and semi-minor axes are stored in R), and ROTANG (ROTANG is not included for circular regions. mode=3 uses direct input of parameters, with output to the screen.

inregion – Input region file (either .fits format or ASCII). An example ASCII file:

 
ELLIPSE  84.7 -68.35 4.0 2.0 25.0
!ELLIPSE 84.5 -68.45 5.0 3.0 25.0
ellipse  84.3 -68.55 6.0 4.0 25.0
!ellipse 84.1 -68.65 7.0 5.0 25.0
CIRCLE   84.7 -68.65 4.0
!CIRCLE  84.5 -68.55 5.0
circle   84.3 -68.45 6.0
!circle  84.1 -68.35 7.0

outregion – Output region file (either .fits format or ASCII, will be the same format as the input file).

imagefile – Sky coordinate image used to extract the observation coordinates and roll angle.

In addition, only for mode=3: shape, ra, dec, radius or semimajor and semiminor, and rotangle (elliptical regions only) can be input parameters.

Output:

mode=1 – User named region fits file

mode=2 – User named file containing region data

mode=3 – Screen output with region data

Example:

convregion mode=1 inputfile=input-radec.fits outputfile=output-det-mos1.fits imagefile=mos1S001-fovimt.fits

convregion mode=2 inputfile=input.txt outputfile=output-det-mos1.txt imagefile=mos1S001-fovimt.fits

convregion mode=3 imagefile=mos1S001-fovimt.fits shape=CIRCLE ra=84.7 dec=-68.35 radius=5.0