STScI Logo

pllist xray.ximages


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · TIME_REQUIREMENTS
BUGS · SEE_ALSO

NAME

pllist -- display a pixel mask

USAGE

pllist mask

DESCRIPTION

pllist displays the mask values of the chosen area of a pixel mask. It will sub-sample large mask areas so as to be able to display them within the specified number of columns and rows. The subsampled row number is given at the left and the last two digits of the subsampled column number appear at the bottom (one above the other).

PARAMETERS

mask = "" prompt = mask data file

The pixel mask file.

(disp_mode = "zoom") [string]

Specify area of mask to display. The word full specifies that the entire mask area be displayed. The word zoom specifies that only the area of the mask with non-zero values be displayed. In this case, pllist computes the smallest subsection which includes all non-zero mask values. Any subsection can be specified by giving four integers, separated by spaces, in the format x1 x2 y1 y2. The three modes can be mixed in one spcification. If 0 is given for x1 or y1 in a subsection specification, the zoom limits are applied to that axis. If -1 is given for x1 or y1 in a subsection specification, the full field of that axis will be used for the display. When 0 or -1 is used as the x1 or y1 value, the corresponding x2 or y2 entry is not used, but an integer value must be given. The keyword names can be abbreviated in the specification.

(ncols = 80) [int]

The number of columns to display. The pixel mask is sub-sampled to display the required number of columns.

(nrows = 30) [int]

The number of rows to display. The pixel mask is sub-sampled to display the required number of rows.

EXAMPLES

1. Display a pixel mask using 30 rows for the display. The mask was made by using the region:


       annulus(449.74,409.2,0,200,n=3)&pie(449.74,409.2,0,360,n=3)

and reference image i296. This produces 9 different regions in a pixel mask of dimension 1024 x 1024.

cl> pllist i296.pl disp_mode="zoom"


mask_name:      i296.pl
mask_type:      region
ref_file:       i296.qp
xdim:           1024
ydim:           1024
scale:          none
regions:        ANNULUS 449.74 409.2 0. 200. n=3. & 
 PIE 449.74 409.2 0. 360. n=3. 

      2222222223333333333333333444444444444444445555555555555555566666666
      5566788990112234455677889001123344566778990012233455667889901122344
      0628406284062840628406284062840628406284062840628406284062840628406
from  250 ------------------------------------------------------- to  650
 609: ................................339................................
 595: .....................3333333333333999999999999.....................
 581: .................3333333333333333399999999999999999................
 567: .............33333333333333333333399999999999999999999.............
 553: ...........3333333333333333333333399999999999999999999999..........
 539: ........333333333333333333333222228888899999999999999999999........
 525: .......333333333333333322222222222888888888889999999999999999......
 511: .....333333333333332222222222222228888888888888899999999999999.....
 497: ....333333333333322222222222222222888888888888888889999999999999...
 483: ...33333333333322222222222222222228888888888888888889999999999999..
 469: ..3333333333332222222222222221111177777888888888888888999999999999.
 455: .33333333333322222222222221111111177777777888888888888899999999999.
 441: .333333333332222222222221111111111777777777788888888888999999999999
 427: .333333333332222222222211111111111777777777788888888888899999999999
 413: 3333333333332222222222211111111111777777777778888888888899999999999
 399: .333333333332222222222211111111444444777777778888888888899999999999
 385: .333333333332222222222211114444444444444477788888888888899999999999
 371: .333333333332222222222255444444444444444444558888888888999999999999
 357: ..3333333333322222255555555444444444444445555555588888999999999999.
 343: ..333333333333355555555555555555444555555555555555555999999999999..
 329: ...3333333366666555555555555555555555555555555555555666669999999...
 315: ....33366666666666555555555555555555555555555555556666666666699....
 301: ......66666666666666655555555555555555555555555666666666666666.....
 287: .......66666666666666666655555555555555555566666666666666666.......
 273: .........6666666666666666666666666666666666666666666666666.........
 259: ............66666666666666666666666666666666666666666666...........
 245: ...............66666666666666666666666666666666666666..............
 231: ...................666666666666666666666666666666..................
 217: .........................666666666666666666........................

TIME REQUIREMENTS

BUGS

SEE ALSO

help plcreate for mask creation and a different example of a pllist type display.

Documentation on region filtering (help regions ) for a description of the spatial filter user interface.

Documentation on QPOE filtering (help qpoe ) for a description of the QPOE filter user interface.

Documentation on file extensions (help extensions ) for a description of PROS file extensions.

Documentation on coordinates (help coords ) for a description of PROS coordinate conventions.


Source Code · Search Form · STSDAS