HEADAS help file

NAME

uvotinteg

USAGE

uvotinteg infile=<filename> regfile=<filename>

DESCRIPTION

This tool performs integrations on a FITS image over a region.

PARAMETERS

infile [filename]

Input image on which to operate. This image provides WCS information and must be a two dimensional image.

regfile [filename]

Input region file.

operation [AREA|SUM|CENTROID]

The operation to perform. AREA yields the area of the region. SUM yields the sum of pixel values in the region. CENTROID yields the centroid of the pixel values in the region.

(subpixels = 1) [integer]

Subdivision per pixel axis (e.g., with subpixels=2, each input pixel is be divided into 4=2^2 subpixels).

(format = DEFAULT) [string]

Result format. The special value DEFAULT tries to choose a reasonable format based on operation and sysname. For AREA, the default format is 'area: %.3f'. For SUM, the default format is 'sum: %.3f'. For CENTROID/world coordinates, the default format is 'centroid: %.6f,%.6f'; otherwise 'centroid: %.3f,%.3f'. To specify a user format, use printf-like syntax.

(sysname = DEFAULT) [string]

Output system. This is used to control the coordinate system and units of the output. There are 5 special values. NONE applies no units tag. PIXEL applies the pixel tag and outputs results in image coordinates. WORLD gets the units tag from the WCS CUNITs keywords and outputs results in world coordinates. VALUE applies the value tag. DEFAULT is resolved to PIXEL if operation=AREA, VALUE if operation=SUM, or WORLD if operation=CENTROID. Any other string will be treated as the units tag.

(nullarea = false) [boolean]

Whether null pixels should be included by the AREA operation.

result [string]

Output parameter for result.

       OPERATION   FORMAT                  EXAMPLE RESULT
       AREA        $real [pixel]           4.519 [pixel]
       SUM         $real [value]           0.236 [value]
       CENTROID    $real,$real [system]    123.201,-43.388 [deg]
                                           213.273,321.948 [pixel]

outnull [string]

Output parameter for number of null (sub)pixels.

(chatter = 1) [enumerated integer]

Standard HEAdas chatter parameter.

EXAMPLES

The following example illustrates running uvotinteg

      uvotinteg infile=some.img+3 regfile=src.reg operation=SUM

LAST MODIFIED