This program is a sub-program of scan2d__define.pro and is dynamically loaded into scan2d__define at the run-time.
NAME:
scan2d::Overlay
PURPOSE:
Using overlay composite image reveals information about the
superposition of the image of selected detectors. It provides
another way of data interpretation.
This method constructs a composite image based on user selected
detectors for a given 2D scanno. The composite image is composed
of the basic composite element area. Each composite element area
consists of ColxRow of squares. In each composite area a single
vaule from each selected image (or detector) is filled in.
Each colored square in the element area represents a value from the
selected detector.
For each detector the values is filled into composite image area
by columns then by rows.
In the basic element area all selected detectors are filled in row
order until the area is full then it re-starts from the first row
again, i.e. if more detectors than the available squares are
selected then the overlay of colored squares may be resulted.
Default 2x2 squares are used for basic element area which can hold
4 detects without overlapping. Each square has width of 2 pixels.
Each detector has a fixed color associated with it, it is linearly
devided into 16 levels. The detector value is linearly interpreted
by these colors (see restriction).
CATEGORY:
Widgets.
CALLING SEQUENCE:
Obj->[scan2d::]Overlay [,Scanno] [,Row=row] [,Col=col] [,Pixels=pixels]
[,Selects=selects] [,Discrete=discrete]
ARGUMENTS:
Scanno: Optional, specifies the corresponding 2D scan seq #, normally
it is internally determined by the [scan2d::View] method.
KEYWORDS:
Col: Specifies the number of squares in the composite area , default 2
Row: Specifies the number of squares in the composite area , default 2
Pixels: Specifies the number of pixels used for each square, default 2
Selects: Specifies the list of selected detectors, default 0,1
Discrete: Plots selected detecor image seperately with info of min and max
RESTRICTION:
The image array size may varies from the scan to scan. In order to
make sure this method works properly, the scan2d::View method has to be
called first to establish the proper image array size for the desired
2D scanno. Then the parameter scanno is not required.
16 colors are used and they are shaded with gray
Detector 1 Red
Detector 2 Green
Detector 3 Blue
Detector 4 Yellow
Detector 5 Cyne
Detector 6 Magenta
Detector 7 Gray
Detector 8 Orange
Detector 9 Light Green
Detector 10 Purple
Detector 11 Gold
Detector 12 Light Orange
Detector 13 Light Cyne
Detector 14 Light purple
Detector 15 Dark Gray
Detector 16 Dark Yellow
The 'Color ...' button let user access various color tables comes with IDL.
The 'myColr' button let user switch back to overlay image color table.
EXAMPLE:
The 2D image file is '/home/oxygen/LEGNINI/data/root/plla.june97.image'
The scanno 29 consists of 10 detectors, with 2D image # 202 to 211.
Example 1 gives the default overlay of detectors 1 and 2 image for
scanno 29 from this file. The panImage method shows all detectors
images for the 2D scan.
The object v2 need to be defined only if it is not yet defined.
filename='/home/oxygen/LEGNINI/data/root/plla.june97.image'
v2 = obj_new('scan2d',file=filename)
v2->view,202
v2->panimage
v2->overlay
Example 2 uses 2x2 composite area with 4 detectors selected, number
of pixels used for each square is 8.
v2->overlay,row=2,col=2,pixels=8,selects=[0,1,8,9]
Toggle the 'myColor' and 'Color ...' buttons from the Overlay window
to access various color map.
MODIFICATION HISTORY:
Written by: Ben-chin Cha, Jan 19, 1998.
xx-xx-xxxx comment
(See scan2d_overlay.pro)