Operators/Tools/Interactive/LabelImageEditor - Revision history

Moeller: /* Label Image Editor */

2021-04-09T14:26:48Z

Label Image Editor

← Older revision		Revision as of 16:26, 9 April 2021
Line 6:		Line 6:

	The ''Label Image Editor'' is available since release version 1.8.8 of MiToBo.<br/>		The ''Label Image Editor'' is available since release version 1.8.8 of MiToBo.<br/>
	In MiToBo/MiToBo plugins ~~release~~ 1.8.13.1 it got a rich feature ~~update~~.		In MiToBo/MiToBo plugins releases 1.8.13.1 and 2.1.2 it got rich feature updates.

	===== Latest News =====		===== Latest News =====
	The editor got latest updates in MiToBo/MiToBo plugins 1.9.		The editor got latest updates in MiToBo/MiToBo plugins 2.1.2 (April 2021).

	===== Name of Plugin/Operator =====		===== Name of Plugin/Operator =====
Line 22:		Line 22:
	* images provided in an input folder are subsequently displayed to the user		* images provided in an input folder are subsequently displayed to the user
	* regions, i.e. connected components, can be removed and joined by simple mouse-clicks		* regions, i.e. connected components, can be removed and joined by simple mouse-clicks
	* additional boundaries can be added by drawing free-hand lines		* additional boundaries can be added by drawing free-hand lines with configurable line width
	* region labels can be adjusted to enhance visibility		* region labels can be adjusted to enhance visibility
	* region re-labeling is supported to guarantee unique labels		* region re-labeling is supported to guarantee unique labels
	* holes within regions can be filled		* holes within regions can be filled
			* missing regions in terms of small holes can automatically filled in
			* support for up to 65535 labels

	===== Usage =====		===== Usage =====
Line 65:		Line 67:
	<br>		<br>
	The following table lists all available operations available in the editor window:		The following table lists all available operations available in the editor window:
	{\|class="wikitable"		{\|class="wikitable"
	\|Operation		\|style="width: 15%;"\|Operation
	\|How to do it		\|How to do it
	\|-		\|-
Line 76:		Line 78:
	\|-		\|-
	\|''draw a new boundary''		\|''draw a new boundary''
	\|keep left mouse button pressed and drag the mouse; this will add a one-pixel wide free-hand line to the label image		\| keep left mouse button pressed and drag the mouse, this will add a one-pixel wide free-hand line to the label image; note that you can configure the line width via the 'Options' button
			\|-
			\|''fill-in a missing region<br> (new in version 2.1.2)''
			\|press 'Ctrl' and 'Shift' and left-click into the missing region area; be sure that the area is fully enclosed by other regions, open background sections cannot be filled properly
	\|}		\|}

Line 103:		Line 108:
	\|-		\|-
	\|''Fix Borders''		\|''Fix Borders''
	\|remove all background pixels with more than one foreground label in their ~~3x3~~ neighborhood		\|remove all background pixels with more than one foreground label in their neighborhood; the size of the neighborhood to be considered can be configured via the 'Options' button, and sometimes it is necessary to re-run the command several times to remove all non-border pixels between two region parts
	\|''Alt + b''		\|''Alt + b''
	\|-		\|-
Line 113:		Line 118:
	\|undo the last action; IMPORTANT: only the most recent action can be undone!		\|undo the last action; IMPORTANT: only the most recent action can be undone!
	\|''Alt + u''		\|''Alt + u''
			\|-
			\|''Options''
			\|opens a window with configuration options, e.g., for setting the line width in drawing or the maximum boundary width
			\|''Alt + o''
	\|-		\|-
	\|''Quit''		\|''Quit''
Line 124:		Line 133:
	=== Updates ===		=== Updates ===
	----<br>		----<br>

			'''April 2021'''
			* The editor got some updates in MiToBo 2.1.2 and MiToBo-plugins 2.1.2, respectively. Background regions can now be filled-in, more labels are supported and some parameters be configured by the user.

	'''January 2019'''		'''January 2019'''

Moeller at 07:57, 19 February 2020

2020-02-19T07:57:36Z

← Older revision		Revision as of 09:57, 19 February 2020
Line 9:		Line 9:

	===== Latest News =====		===== Latest News =====
	The editor got latest updates in MiToBo/MiToBo plugins 1.~~8.17~~.		The editor got latest updates in MiToBo/MiToBo plugins 1.9.

	===== Name of Plugin/Operator =====		===== Name of Plugin/Operator =====

Moeller: /* Technical Details */

2020-02-04T15:19:26Z

Technical Details

← Older revision		Revision as of 17:19, 4 February 2020
Line 136:		Line 136:
	The label editor relies on analyzing and manipulating the grayscale values of segmented regions in a given image.<br> In detail, the most important functions are implemented as follows:		The label editor relies on analyzing and manipulating the grayscale values of segmented regions in a given image.<br> In detail, the most important functions are implemented as follows:
	* deleting regions:<br> the grayscale value at the mouse-click position is determined and all pixels in the image sharing this value are set to black		* deleting regions:<br> the grayscale value at the mouse-click position is determined and all pixels in the image sharing this value are set to black
	* joining regions:<br> upon clicking into the first region its grayscale value is internally stored;<br> when the user clicks into the second region which is to be merged with the first one<br> the grayscale value at the click position is extracted and all pixels with this value are relabeled with the formerly stored grayscale value of the first region		* joining regions:<br> upon clicking into the first region its grayscale value is internally stored;<br> when the user clicks into the second region which is to be merged with the first one<br> the grayscale value at the click position is extracted and all pixels with this value are relabeled with the formerly stored grayscale value of the first region;<br> important: after doing the join both joined regions share the same grayscale value, however, are not connected to each other; hence, to get a valid label image again you should run the "Fix Borders" function
	* relabel image:<br> the image is thresholded with a threshold of zero to get a binary image of background and labeled regions;<br> then a sequential component labeling is run on the image which assigns consecutive grayscale labels to all connected components in the foreground of the image		* relabel image:<br> the image is thresholded with a threshold of zero to get a binary image of background and labeled regions;<br> then a sequential component labeling is run on the image which assigns consecutive grayscale labels to all connected components in the foreground of the image
	* adjust contrast:<br> the image is relabeled, however, the target labels are equidistantly spread over just the upper two third of the available grayscale range;<br> the underlying motivation for this is given by the observation that low grayscale values are hard to distinguish from the background, thus, brighter labels improve visibility		* adjust contrast:<br> the image is relabeled, however, the target labels are equidistantly spread over just the upper two third of the available grayscale range;<br> the underlying motivation for this is given by the observation that low grayscale values are hard to distinguish from the background, thus, brighter labels improve visibility
	* fix borders:<br> this functions seeks to eliminate borders between regions with identical labels which may for example occur after joining two regions;<br> for removing borders for each background pixel in the image the grayscale values in a 7x7 neighborhood of the pixel are analyzed,<br> and if there is only a single grayscale value found and more than half of the analyzed neighborhood pixels share this value, the corresponding background pixel gets the value as well;<br> the neighborhood is currently fixed to 7x7, thus, borders which are wider cannot be closed, and it has to be noted that sometimes the function has to be run several times to remove all pixels belonging to a single border		* fix borders:<br> this functions seeks to eliminate borders between regions with identical labels which may for example occur after joining two regions;<br> for removing borders for each background pixel in the image the grayscale values in a 7x7 neighborhood of the pixel are analyzed,<br> and if there is only a single grayscale value found and more than half of the analyzed neighborhood pixels share this value, the corresponding background pixel gets the value as well;<br> the neighborhood is currently fixed to 7x7, thus, borders which are wider cannot be closed, and it has to be noted that sometimes the function has to be run several times to remove all pixels belonging to a single border

Moeller at 15:14, 4 February 2020

2020-02-04T15:14:24Z

← Older revision		Revision as of 17:14, 4 February 2020
Line 134:		Line 134:
	=== Technical Details ===		=== Technical Details ===
	----<br>		----<br>
	The label editor relies on analyzing and manipulating the grayscale values of segmented regions in a given image.<br> In detail, the ~~different~~ functions are implemented as follows:		The label editor relies on analyzing and manipulating the grayscale values of segmented regions in a given image.<br> In detail, the most important functions are implemented as follows:
	* deleting regions:<br> the grayscale value at the mouse-click position is determined and all pixels in the image sharing this value are set to black		* deleting regions:<br> the grayscale value at the mouse-click position is determined and all pixels in the image sharing this value are set to black
	* joining regions:<br> upon clicking into the first region its grayscale value is internally stored;<br>		* joining regions:<br> upon clicking into the first region its grayscale value is internally stored;<br> when the user clicks into the second region which is to be merged with the first one<br> the grayscale value at the click position is extracted and all pixels with this value are relabeled with the formerly stored grayscale value of the first region
	when the user clicks into the second region to ~~merge~~ the grayscale value at the click position is extracted and all pixels with this value are relabeled with the formerly stored grayscale value of the first region		* relabel image:<br> the image is thresholded with a threshold of zero to get a binary image of background and labeled regions;<br> then a sequential component labeling is run on the image which assigns consecutive grayscale labels to all connected components in the foreground of the image
			* adjust contrast:<br> the image is relabeled, however, the target labels are equidistantly spread over just the upper two third of the available grayscale range;<br> the underlying motivation for this is given by the observation that low grayscale values are hard to distinguish from the background, thus, brighter labels improve visibility
			* fix borders:<br> this functions seeks to eliminate borders between regions with identical labels which may for example occur after joining two regions;<br> for removing borders for each background pixel in the image the grayscale values in a 7x7 neighborhood of the pixel are analyzed,<br> and if there is only a single grayscale value found and more than half of the analyzed neighborhood pixels share this value, the corresponding background pixel gets the value as well;<br> the neighborhood is currently fixed to 7x7, thus, borders which are wider cannot be closed, and it has to be noted that sometimes the function has to be run several times to remove all pixels belonging to a single border

Moeller: /* Technical Details */

2020-02-04T15:01:38Z

Technical Details

← Older revision		Revision as of 17:01, 4 February 2020
Line 134:		Line 134:
	=== Technical Details ===		=== Technical Details ===
	----<br>		----<br>
	The label editor ~~got latest updates~~ in ~~MiToBo/MiToBo plugins 1.8.17~~.		The label editor relies on analyzing and manipulating the grayscale values of segmented regions in a given image.<br> In detail, the different functions are implemented as follows:
			* deleting regions:<br> the grayscale value at the mouse-click position is determined and all pixels in the image sharing this value are set to black
			* joining regions:<br> upon clicking into the first region its grayscale value is internally stored;<br>
			when the user clicks into the second region to merge the grayscale value at the click position is extracted and all pixels with this value are relabeled with the formerly stored grayscale value of the first region

Moeller at 14:54, 4 February 2020

2020-02-04T14:54:12Z

← Older revision		Revision as of 16:54, 4 February 2020
Line 129:		Line 129:

	'''March 2018'''		'''March 2018'''
	* The LabelImageEditor has been released in MiToBo 1.8.8 and MiToBo-plugins 1.8.8, respectively.		* The LabelImageEditor has been released in MiToBo 1.8.8 and MiToBo-plugins 1.8.8, respectively.<br><br>
			<p>

	=== Technical Details ===		=== Technical Details ===
			----<br>
	The label editor got latest updates in MiToBo/MiToBo plugins 1.8.17.		The label editor got latest updates in MiToBo/MiToBo plugins 1.8.17.

Moeller at 14:51, 4 February 2020

2020-02-04T14:51:27Z

← Older revision		Revision as of 16:51, 4 February 2020
Line 130:		Line 130:
	'''March 2018'''		'''March 2018'''
	* The LabelImageEditor has been released in MiToBo 1.8.8 and MiToBo-plugins 1.8.8, respectively.		* The LabelImageEditor has been released in MiToBo 1.8.8 and MiToBo-plugins 1.8.8, respectively.

			=== Technical Details ===
			The label editor got latest updates in MiToBo/MiToBo plugins 1.8.17.

Moeller: /* Usage */

2020-02-04T14:49:57Z

Usage

← Older revision		Revision as of 16:49, 4 February 2020
Line 43:		Line 43:
	<br>		<br>
	* Input data:<br>The operator reads the contents of a given input image directory and displays all images one after the other to the user. <br>The user can edit the images, i.e. remove labeled regions, by clicking with the left mouse button somewhere into the region to remove.<br> Clicking the "Next" button at the top of the editor window will save the current image to disk and proceed with the next image in the folder. <br><br>		* Input data:<br>The operator reads the contents of a given input image directory and displays all images one after the other to the user. <br>The user can edit the images, i.e. remove labeled regions, by clicking with the left mouse button somewhere into the region to remove.<br> Clicking the "Next" button at the top of the editor window will save the current image to disk and proceed with the next image in the folder. <br><br>
	* Output data:<br>For each input image the operator will save a corresponding output image, either in the same folder or a specific output folder if provided.<br> Output images will share the name of the corresponding input image extended with substring "-edited".		* Output data:<br>For each input image the operator will save a corresponding output image, either in the same folder or a specific output folder if provided.<br> Output images will share the name of the corresponding input image extended with substring "-edited".<br> Note, all images are relabeled automatically before saving to ensure consecutive labels in the resulting edited images. <br> Consecutive labels are a pre-requisite for some other MiToBo tools which can be used in further processing steps, like the [[Applications/FeatureColorMapper\|FeatureColorMapper]].

	<br>		<br>

Moeller at 14:17, 4 February 2020

2020-02-04T14:17:19Z

← Older revision		Revision as of 16:17, 4 February 2020
Line 9:		Line 9:

	===== Latest News =====		===== Latest News =====
	The editor got ~~an update~~ in MiToBo/MiToBo plugins 1.8.13.~~1. Now much more editing functionality is available!~~		The editor got latest updates in MiToBo/MiToBo plugins 1.8.17.

	===== Name of Plugin/Operator =====		===== Name of Plugin/Operator =====

Moeller: /* Label Image Editor */

2019-01-21T10:29:59Z

Label Image Editor

← Older revision		Revision as of 12:29, 21 January 2019
Line 84:		Line 84:
	\|Button		\|Button
	\|Function		\|Function
			\|Keyboard Shortcut
	\|-		\|-
	\|''Next''		\|''Next''
	\|save current changes and jump to next image		\|save current changes and jump to next image
			\|''Alt + n''
	\|-		\|-
	\|''Skip''		\|''Skip''
	\|cancel current image, don't save anything and jump to next image		\|cancel current image, don't save anything and jump to next image
			\|''Alt + s''
	\|-		\|-
	\|''Contrast''		\|''Contrast''
	\|adjust labels to optimize visibility, i.e., shift labels into upper third of gray-scale range with maximal distances between them		\|adjust labels to optimize visibility, i.e., shift labels into upper third of gray-scale range with maximal distances between them
			\|''Alt + c''
	\|-		\|-
	\|''Relabel''		\|''Relabel''
	\|relabel the image, i.e., make sure that every region gets a unique label		\|relabel the image, i.e., make sure that every region gets a unique label
			\|''Alt + r''
	\|-		\|-
	\|''Fix Borders''		\|''Fix Borders''
	\|remove all background pixels with more than one foreground label in their 3x3 neighborhood		\|remove all background pixels with more than one foreground label in their 3x3 neighborhood
			\|''Alt + b''
	\|-		\|-
	\|''Fill Holes''		\|''Fill Holes''
	\|fill background regions enclosed by a single region with the region label		\|fill background regions enclosed by a single region with the region label
			\|''Alt + h''
	\|-		\|-
	\|''Undo''		\|''Undo''
	\|undo the last action; IMPORTANT: only the most recent action can be undone!		\|undo the last action; IMPORTANT: only the most recent action can be undone!
			\|''Alt + u''
	\|-		\|-
	\|''Quit''		\|''Quit''
	\|save current changes and quit the editor window		\|save current changes and quit the editor window
			\|''Alt + q''
	\|}		\|}