30.01.2013 Views

The SWIFT BAT Software Guide Version 6.3 30 ... - HEASARC - Nasa

The SWIFT BAT Software Guide Version 6.3 30 ... - HEASARC - Nasa

The SWIFT BAT Software Guide Version 6.3 30 ... - HEASARC - Nasa

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

D.2. <strong>BAT</strong>CELLDETECT 113<br />

in instrumental sky coordinates, and are meant to be interpolated to the desired sampling.<br />

<strong>The</strong> WCS keywords must specify the image coordinate systems.<br />

(keepbits = “ALL”) [string ]<br />

Integer number of bits of precision to keep in the output images. A value of ALL means<br />

keep all bits. A positive value indicates that ‘keepbits’ bits of precision should be preserved,<br />

and the other bits should be set to zero. Fewer kept bits means the output images are more<br />

compressible, at the expense of lost precision. For background and variance maps, a straight<br />

number of bits are kept (thus preserving the same relative precision across the map). For<br />

significance maps, ‘keepbits’ prescribes the number ofnoise bits to keep; more bits may be<br />

kept if a pixel is significantly above the noise (thus preserving the same noise quantization<br />

error across the map).<br />

(npixthresh=20) [integer ]<br />

Minimum number of pixels in the background window to enable source detection. Setting this<br />

parameter to a high number will prevent detections based on only a few background pixels.<br />

(posfitwindow=0) [real ]<br />

<strong>The</strong> position ‘window’ radius, in degrees, used for all position fits, including known sources.<br />

<strong>The</strong> window is the allowed region over which the centroid position is allowed to vary during the<br />

position fit, regardless of the error radius specified for the source. Typically, this parameter<br />

will only be used if the attitude solution is suspected to be incorrect. A value of zero indicates<br />

that the window size is determined by the error radius specified in the catalog, if any. This<br />

parameter is basically an override for the ERR RAD column. See “Fitting For Position and<br />

Flux” above.<br />

(possyserr=0) [real ]<br />

Systematic position error, in degrees, to be added in quadrature to each position error radius<br />

reported in the output catalog. This parameter allows one to specify a minimum systematic<br />

position error for every reported detection (which is separate from posfitwindow, which<br />

controls the position determination process itself).<br />

(keepkeywords=“*APP,CLEANLEV”) [string ]<br />

A comma separated list of keywords or keyword wildcard patterns. <strong>The</strong> matching keywords<br />

are transferred to the output catalog, under a column of the same name. This is a way<br />

to automatically keep track of corrections that have been applied to the input image. <strong>The</strong><br />

CFITSIO wildcard patterns are: ‘?’ will match any single character at that position in the<br />

keyword name; ‘*’ will match any length (including zero) string of characters; and ‘#’ will<br />

match any consecutive string of decimal digits (0 - 9).<br />

(hduclasses=”-VIGNETTING,-BKG VARIANCE,-BKG STDDEV,-SIGNIFICANCE”) [string<br />

]<br />

List of comma-separated image type filters, used to accept or reject images based on their<br />

HDUCLASn keywords. This is useful for files that contain different kinds of image extensions.<br />

A minus sign “-” indicates exclusion. Each image is checked for each of the HDUCLASn<br />

keywords. If any of the keyword values matches an excluded list member, then that image is<br />

rejected for analysis. List members without a minus sign must be present. A value of NONE<br />

indicates no filtering (i.e. all images are accepted).<br />

(sortcolumns=“-KNOWN,-SNR/UNKNOWN,RA OBJ”) [string ]

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!