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.proand 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 programThe 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