NAME

uvotconvreg

USAGE

uvotconvreg infile=<filename> wcsfile=<filename> outfile=<filename>

DESCRIPTION

This tool converts region files to ASCII or FITS format.

ASCII regions are converted to linear FITS coordinates.

FITS regions are written using the ACS-FITS-REGION 1.0: McDowell, Rots: FITS REGION Binary Table Design.

PARAMETERS

infile [filename]
Input region file.

wcsfile [filename]
Input HDU containing WCS definition. This HDU must contain a two dimensional image.

outfile [filename]
Output region file.

(outtype = ASCII) [ASCII|FITS]
Output region format.

(wcs = -) [string]
Optional alternate WCS version code. This can be used to specify an alternate WCS system to load from wcsfile.

(clobber = no) [boolean]
Overwrite existing output files?

(history = yes) [boolean]
Write HISTORY keywords to (FITS) output?

(chatter = 1) [enumerated integer]
Standard HEAdas chatter parameter.

EXAMPLES

1. The following example illustrates running uvotconvreg to create an ASCII region:

      uvotconvreg infile=src.reg wcsfile=some.img+3 regfile=src.reg outfile=ascii.reg

2. The following example illustrates running uvotconvreg to create a FITS region:

      uvotconvreg infile=src.reg wcsfile=some.img+3 regfile=src.reg outfile=fits.reg outtype=FITS

SEE ALSO

LAST MODIFIED

June 2010