NAME

cellmap -- copies a qpoe file and creates a detect cell size resolution image

USAGE

cellmap

DESCRIPTION

CELLMAP copies a qpoe file and creates an image with a specified cell size. Each image pixel represent 1/3 of the detect cell in size. If, after blocking the image size is > 512x512 pixels the image is subsectioned and the center 512x512 image is written out.

Cellsizes common to the Telescope and instrument are offered as detect cell choices.

PARAMETERS

qpoe = "" prompt = Input xray Qpoe

Required Input qpoe filename at full resolution.

image = "" prompt = Output xray Image

Required Output image file name.

rh_cellsize = "" prompt = ROSAT HRI Cellsize in arcsecs -

                                 9 | 12 | 24 | 36 | 48          

Cellsizes for ROSAT HRI qpoe.

rp_cellsize = "" prompt = ROSAT PSPC Cellsize in arcsecs -

				 30[h/b]| 45[s]| 60[s/h/b]| 120[s/h/b]

Cellsizes for ROSAT PSPC qpoe.

eh_cellsize = "" prompt = Einstein HRI Cellsize in arcsecs -

			         12 | 24 | 48

Cellsizes for Einstein HRI qpoe.

ei_cellsize = "" prompt = Einstein IPC Cellsize in arcsecs -

				 144 [h/b]| 240 [s]

Cellsizes for Einstein IPC qpoe.

eband = "" prompt = Energy Band (soft|hard|broad)

Energy band. Prompted when instrument is PSPC or IPC. Choice of Soft, hard, or broad. The PI filter appropriate to the band choice is appended to the qpoe filename. PI bands must be respecified when running BEPOS.

(query = yes) [boolean]

Indicates whether the task is being run from the cl or ldetect. If yes, the auto params are queried, if no, they will be passed from the preceeding task. (Not a user-param).

(clobber = no) [boolean]

Boolean flag specifying whether or not the output Table file can be overwritten, if it already exists.

EXAMPLES

1. Run CELLMAP on ROSAT HRI data at 12" detect cell size resolution. The blocked data is > 512, so the center 512x512 image is saved.

de> cellmap
Input xray Qpoe: xdata$rh110267.qp
Output xray image : harlac12
ROSAT HRI Cellsize in arcsecs - 6|9|12|24|36|48: 12

xdata$rh110267.qp[bl=8][256:767,256:767] -> harlac12.imh
add harlac12.imh,cellsize = 12
harlac12.imh updated
xdata$rh110267.qp

2. Run CELLMAP on ROSAT PSPC data at 30" detect cell size resolution, and broad energy band. The blocked data is > 512, so the center 512x512 image is saved.

de> cellmap
Input xray Qpoe (xdata$rh110267.qp): xdata$rp110590.qp
Output xray image  (harlac12): .
ROSAT PSPC Cellsize in arcsecs - 30 [h/b]| 45 [s]| 60 [s/h/b]| 120 [s/h/b]: 30
Energy Band (soft|hard|broad) (broad):

xdata$rp110590.qp[bl=20,pi=11:235][128:639,128:639] -> ./rp110590.imh
add ./rp110590.imh,cellsize = 30
./rp110590.imh updated

TIME REQUIREMENTS

BUGS

SEE ALSO

Documentation on running ldetect (a detect task which runs the 5 detect tasks in sequence). (help ldetect )

Documentation giving an overview of the detect package and run order of tasks. (help using_detect )

Documentation on the detect algorithms and philosophy along with limitations in (help explain_detect ).