Mask Editor is intended for interactive selection of good and bad regions on 2D image and preparation of output files with direct and inversed masks. It works as a basic graphical editor with specific output.
User Interface
User interface of the Mask Editor works in a single window containing three pannels; graphical window, left-hand and bottom side control bars. Content and functionality of these panels is described below. Most of control buttons have tool tip hints; when coursor stops for a few seconds on control button, a pop-up window uppears with explanation of functionality of this button.
Graphical window
Graphical window contains image and spectrum. When cursor moves on image or spectrum, its coordinates are displayed near cursor. Cursor pattern is changed from "cross" to "pointing finger" when it is located on active form boarder.
Left control bar
Left control bar consists of stack of buttons, which are functionally splitted for four groups; Forms, Modes, I/O, and Satus, which content and functionality is explained in this section.
Forms
Forms are represented by geometry objects Rectangle, Circle, Polygon, Wedge, and Line, which can be used to compose the mask regions. All forms behave about the same way depending on Mode, as explained below.
Modes
Section of modes contain Zoom, Add, Move, Select, and Remove buttons with functionality literally explained by their names.
Zoom
Mode Zoom works for image and spectrum.
Add
Add is an input method for forms. All forms, except Polygon, are presented by two 2D points each on image coordinate system. Input method for these forms is the same; in mode Add click-drug-release the left mouse button. Two points will be defined for click and release positions of the mouse.
Polygon is presented by the N 2D points, where N is a number of vertexes.
The N-1 points are entered by the left mouse button click, while the N-th point is indicated by the right mouse button click.
Move
Select
Forms can be used as regular "positive" for ROI, and selected (inversed) "negative" for blemish mask.
Remove
I/O
Load Image
Loads and displays image from text file. The file name is selected through the standard pop-up dialog window.
Load Forms
Loads and displays forms from text file. The file name is selected through the standard pop-up dialog window.
Save Forms
Saves forms in text file. The file name is selected through the standard pop-up dialog window.
Save Mask
Saves "ROI" (positive) mask in text file. The file name is selected through the standard pop-up dialog window.
Save inv-M(ask)
Saves "blemish" (negative) mask in text file. The file name is selected through the standard pop-up dialog window.
Print Forms
Prints current forms from the list.
Clear Forms
Removes forms from image and from the list.
Status panel
Status panel is a single button-like panel, displaying short status messages.
Bottom control bar
Bottom control bar contains "Help", "Reset", "Save", "ELog", "Close" buttons, "N bins" editable field, "Grid", and "Log" check boxes.
Help
Shows pop-up windows with help info about navigation.
Reset
Restores original image size and spectral limits.
Save
Saves content of graphical window in png file. The file name is selected through the standard pop-up dialog window.
ELog
Serves to submit message in ELog. The content of graphical window will be added as attachment. Destination of the message is selected through the custom pop-up dialog window.
Close
Closes the Mask Editor application.
Grid
On/Off coordinate grid on image and spectrum.
Log
Serves as a switch between linear and log scale.
N bins
"N bins" field can be used to change a number of bins in spectrum. Spectrum will redraw, when edition is ended (press Enter on keyboard or change focus on other field).
How to run Mask Editor
Mask Editor is developed as a part of the integrated data processing environment for XCS time correlation experiments. In this project the Mask Editor is integrated as one of the system GUIs. Also it can be executed as a stand-alone application named med. Stand-alone version of the Mask Editor can launched on any of psana or psexport node using command-line interface, for example, for all default parameters:
sit_setup med
List of optional parameters
> med -h
Usage: med [options]
Optional input parameters.
Options:
-h, --help show this help message and exit
-i IFNAME, --fname_img=IFNAME
input image file name
-o OFNAME, --fname_fig=OFNAME
output png file name for current canvas
-m MFNAME, --path_mask=MFNAME
common path to I/O files with mask
-t TITLE, --title=TITLE
initial title of the garphical window
-x XC, --xc=XC x coordinate of the center for Wedges
-y YC, --yc=YC y coordinate of the center for Wedges
-p PICKER, --picker=PICKER
distance in pix, where object line can be reaced by
mouse
-w LW, --lw=LW object line width
-c COL, --color=COL color of the form lines "b"-blue, "k"-black, etc.
-v, --verbose allows print on console
-q, --quiet supress print on console
I/O of forms
Forms can be saved in file, loaded from file and displayed on image, printed on console monitor, and cleared/removed from image. This can be done using simple data representation for each form, which is quite self-explained in case of pront or text-file format:
Form parameters for composition of the mask Rectangle 48.00 50.00 262.00 380.00 1 b False False Rectangle 987.00 853.00 255.00 380.00 1 w True False Wedge 716.76 674.72 541.18 197.61 -171.39 174.59 1 b False False Wedge 674.48 667.64 585.84 386.69 174.75 186.99 1 b False False Circle 712.00 674.00 262.00 1 b False False Circle 1068.00 180.00 112.00 1 b False False Circle 191.00 898.00 117.00 1 b False False Circle 752.00 1098.00 53.00 1 w True False Line 689.79 1252.80 624.50 223.22 1 w True False Line 829.99 1252.80 244.47 388.46 1 b False False Line 836.67 1303.98 268.07 541.89 1 w True False Line 692.02 1315.11 669.35 827.50 1 b False False Polygon 1 w True False 10 400 373 620 ... Polygon 1 b False False 6 329 674 683 ...
Demonstration of features
Overview
Content Tools