![[TOC]](gif/back.gif){kind=small}
The free-hand drawing option of the multiroi_pick program calls the IDL provided DEFROI function to let the user define the rough region of interest. Then the user can use the modifying ROI option to refine the ROI by picking/unpicking the elements from the drawing area. It is possible that the single ROI may be composed by disjoint smaller regions from the drawing area.
It allows the user freely to add a new ROI or delete an existing ROI. For fine meshes it allows the user to add or delete elements from an selected ROI by zoom in the ROI and clicking the elements. Each selected elements is hashed and marked with a number indicates which ROI # it belongs to.
The ROI definition file can be easily created and loaded into multiroi_pick
program, and the statistic report can be easily created and saved for the
selected ROIs.
source /usr/local/rsi/idl_5.2/bin/idl_setupIn order to access IDL programs installed in the local epics/extensions/bin, a user has to make sure that the following two environment variables are set before invoking IDL :
setenv EPICS_EXTENSIONS /usr/local/epics/extensions
setenv IDL_STARTUP $EPICS_EXTENSIONS/bin/$HOST_ARCH/viewer_startup.pro
and make sure the directory /usr/local/epics/extensions/bin/$HOST_ARCH is
in his/her IDL search path.
The W95 display must be properly set first before running IDL on W95. To set the display by use the W95 Start menu
Start->Settings->Control Panel Select the "Display Icon" to invoke the Display Properties dialog Select the "Settings" Tablet, Set the "Color palette" to 256 Color Press the "Apply" button, and confirm it Close the Display Properties dialog
IDL> MULTIROI_PICK, IMThis commnad will automatically load the multiroi_pick.pro program into the IDL session . The variables IM specifies the 2D image array, Before calling the MULTIROI_PICK, the input variable 2D array IM must be defined first.
Because the TV drawing region is only 300x300, for fine meshes of 2D image array, the ROI # for the selected region may be not readable due to the overlap of the numbers of densely selected elements in a small drawing area. Only for coarse 2D image array, the numbers of selected elements can be clearly readable.
A user has to pay attention to both the scroll message text area and the TV message area in order to properly picking and unpicking the elements. Always remember to click the right mouse button to get out of the element picking mode or out of the reading cursor coordinate operation.
If color image exposure problem or something else went wrong in the TV image area, always try to use the RMB (right mouse button) to get out of the TV screen element read mode.
The ROI control consists of following contol buttons:
Help... - Pop up the simple on-line help window
Read ROIs...- Call pickfile dialog to load old ROIs into program
Save ROIs...- Save current ROIs through pickfile dialog, default
filename used 'roi.pick'
Tiff/Pgn/Pict- Save current ROIs to a corresponding output image file
Color... - Calls xloadct to change color table,default Ranbow+White
Refresh - Refresh the TV image area (with no element hashed)
ShowAll ROIs- Redraw the TV ROIs area and generate ROI report and
update scroll report text window (for all ROIs)
ROI# List - Select ROI # desired and update the report text window
(for selected ROI #)
Draw PolyROI- Draw polyROI by free hand drawing for newly added ROI #
LMB : define polygon vertex node
MMB : clear last vertex node
RMB : close the polygon
Modify ROI - Modify the selected ROI #
LMB : picking/unpicking the element
RMB : terminate modification mode
Add ROI - Increase ROI # by one, adds the ROI # to the list box,
and fall into Modifying ROI mode
Del ROI - Delete all the elements corresponding to the selected
ROI # from the ROI list
Zoom Add - Use Zoom box to add elements to a ROI #
LMB : picking new elements to be added
RMB : terminate modification mode
Zoom Del - Use Zoom box to delete elements from a ROI #
LMB : picking old elements to be deleted
RMB : terminate modification mode
Query Image - Display the image value of the mouse position
at the TV top left corner
RMB : terminate query image mode
Offset Val: - Enter the offset value in statistic calculation
(default 0.)
Charsize: - Enter the character size for ROI # marker of the selected
pixel elements (default 1)
Scroll Text - Scroll text area for displaying ROI statistic report
Save As... - Save the scroll text area content as an output report
file, filename must contain the substring '.rpt'
Print - Send the scroll text area content to the PS printer
Clear - Clear the scroll text area
Slider - Set background color to different value
ROIs Tiff - Droplist Tiff/Png/Pict to select the output image type,
default saved as TIFF file
Display the output ROIs image filename, default
roi.pick.tiff
Done - Closes the MULTIROI_PICK program
The output image file is automatically generated from the ROIs definition
file. The default file for the ROIs file is ended with 'roi.pick' string.
The image file will end with 'roi.pick.tiff' or 'roi.pick.png' or
'roi.pick.pict' respectively according the type set by the droplist.
Three types of files can be saved by the multiroi_pick program: ROI definition file, output ROI image file, and ROI report file.
The file name used for multiROI definition file should contain the sub-string 'roi.pick'. It is recommended that the file name should at least include the string of the original scan file name. It is possible to save many different 'roi.pick' files for a given scan file as long as they are uniquely identifiable by the user.
The multiroi_pick program checks whether the read in ROI definition file contains same number of elements as the 2D image array. If the elements of multiROI definition does not agree with the 2D image data array, the ROI # are reset to 0 for whole 2D image array.
The TIFF file is target for various general image displaying tools.
The PNG file is the format readable by the W95 Paint Shop Pro raster image editing program.
The PICT file is target for image displaying program used on the MAC system.
The file name used for multiROI report file should contain the sub-string 'rois.rpt'. It is recommended that the file name should at least include the string of the original scan file name. It is possible to save many different 'rois.rpt' files for a given scan file as long as they are uniquely identifiable by the user.
As long as the multiROI definition file is saved the report file can be easily regenerated.
The typical output for a multiROI report is given below:
=========================== Report generated at: Tue May 1 14:48:57 2001 =========================== REGION OF INTEREST : 1 MINIMUM: 0.494017 I=4 J=3 MAXIMUM: 0.890931 I=4 J=4 TOTAL: 7.51586 AVERAGE: 0.626322 VARIANCE: 0.0381918 DEVIATION: 0.195427 OFFSET: 0.00000 NELEM: 12 N I J IM(I,J)-Offset 0 4 3 0.494017 1 5 3 0.494017 2 3 4 0.494017 3 4 4 0.890931 4 5 4 0.890931 5 6 4 0.494017 6 3 5 0.494017 7 4 5 0.890931 8 5 5 0.890931 9 6 5 0.494017 10 4 6 0.494017 11 5 6 0.494017