Operators/Tools/Interactive/LabelImageEditor: Difference between revisions
From MiToBo
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 3: | Line 3: | ||
== Label Image Editor == | == Label Image Editor == | ||
[[File:MTBOperatorControlFrame-LabelImageEditor.png| | [[File:MTBOperatorControlFrame-LabelImageEditor.png|400px|right|link=]] | ||
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/> | ||
| Line 24: | Line 24: | ||
===== Usage ===== | ===== Usage ===== | ||
The editor is dedicated to the analysis of label images. In a label image each region or connected component, respectively, is assumed to be marked with a unique intensity or color value, i.e. all of its pixels should share this value. The editor allows to remove regions from such images by just clicking somewhere into a region to be removed. The region will then be removed by setting all its pixels to a value of zero.<br> | The editor is dedicated to the analysis of label images. In a label image each region or connected component, respectively, is assumed to be marked with a unique intensity or color value, i.e. all of its pixels should share this value. The editor allows to remove regions from such images by just clicking somewhere into a region to be removed. The region will then be removed by setting all its pixels to a value of zero.<br> | ||
The editor takes as input a directory from where the images are loaded one after the other. Once an image is displayed to the user edit operations can be performed. Subsequently by clicking the "Next button | The editor takes as input a directory from where the images are loaded one after the other. Once an image is displayed to the user edit operations can be performed. Subsequently by clicking the "Next" button the current image can be saved to disk and the next image is loaded. Pressing the "Quit" button will terminate the editor.<br> | ||
<br><br> | |||
'''Important notice:''' There is currently no ''Undo'' function. If you accidentally deleted too many regions, either run the editor once again on the complete directory or copy the corresponding image to a separate folder and run the editor on that folder. Results of a former run will be overwritten without further inquiry. | '''Important notice:''' There is currently no ''Undo'' function. If you accidentally deleted too many regions, either run the editor once again on the complete directory or copy the corresponding image to a separate folder and run the editor on that folder. Results of a former run will be overwritten without further inquiry. | ||
[[File:MTBOperatorControlFrame-LabelImageEditor-MainWindow.png|400px|right|link=]] | |||
<br> | |||
To run the LabelImageEditor perform the following steps: | To run the LabelImageEditor perform the following steps: | ||
* install MiToBo by following the instructions on the [[Installation]] page | * install MiToBo by following the instructions on the [[Installation]] page | ||
* run MiToBo and start the operator runner by selecting the menu item '''''MiToBo Runner''''' from '''''Plugins -> MiToBo''''' | * run MiToBo and start the operator runner by selecting the menu item '''''MiToBo Runner''''' from '''''Plugins -> MiToBo''''' | ||
* in the selection menu navigate to 'de.unihalle.informatik.MiToBo.tool.interactive' and select the operator '''''LabelImageEditor''''' | * in the selection menu navigate to 'de.unihalle.informatik.MiToBo.tool.interactive' and select the operator '''''LabelImageEditor''''' | ||
This will bring up the operator window of the LabelImageEditor. | This will bring up the operator window of the LabelImageEditor (see figure on the right, top) where the basic configuration parameters can be added. Clicking the "Run" button will open the editor window with the first image loaded (figure on the right, bottom). | ||
<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". | |||
<br> | |||
* Parameters: | * Parameters: | ||
{|class="wikitable" | {|class="wikitable" | ||
| Line 45: | Line 53: | ||
|- | |- | ||
|''File Filter'' | |''File Filter'' | ||
|String which needs to be contained in the names of image files to be processed, file names not containing the pattern will be skipped. For example, if the string ".tif" is provided, only images ending with ".tif", i.e. in TIFF format, will be considered, the string "cell" would select only images containing the word "cell" somewhere in their name. Note that as string any valid Java regular expression is admissible. See for example [http://www.vogella.com/tutorials/JavaRegularExpressions/article.html this website] for more details on regular expressions. | |String which needs to be contained in the names of image files to be processed, file names not containing the pattern will be skipped.<br> For example, if the string ".tif" is provided, only images ending with ".tif", i.e. in TIFF format, will be considered, the string "cell" would select only images containing the word "cell" somewhere in their name. Note that as string any valid Java regular expression is admissible. See for example [http://www.vogella.com/tutorials/JavaRegularExpressions/article.html this website] for more details on regular expressions. | ||
|- | |- | ||
|''Output directory'' | |''Output directory'' | ||
| | |optional; edited result label images will be saved to this directory; if not provided the result images will be stored in the input folder | ||
|} | |} | ||
Revision as of 10:59, 13 July 2018
Label Image Editor
The Label Image Editor is available since release version 1.8.8 of MiToBo.
Latest News
The Label Image Editor has been released for user-friendly editing of label images.
Name of Plugin/Operator
de.unihalle.informatik.MiToBo.tools.interactive.LabelImageEditor
(available since MiToBo version 1.8.8)
Main features
- images provided in an input folder are subsequently displayed to the user
- regions, i.e. connected components, can be removed by simple mouse-clicks
Usage
The editor is dedicated to the analysis of label images. In a label image each region or connected component, respectively, is assumed to be marked with a unique intensity or color value, i.e. all of its pixels should share this value. The editor allows to remove regions from such images by just clicking somewhere into a region to be removed. The region will then be removed by setting all its pixels to a value of zero.
The editor takes as input a directory from where the images are loaded one after the other. Once an image is displayed to the user edit operations can be performed. Subsequently by clicking the "Next" button the current image can be saved to disk and the next image is loaded. Pressing the "Quit" button will terminate the editor.
Important notice: There is currently no Undo function. If you accidentally deleted too many regions, either run the editor once again on the complete directory or copy the corresponding image to a separate folder and run the editor on that folder. Results of a former run will be overwritten without further inquiry.
To run the LabelImageEditor perform the following steps:
- install MiToBo by following the instructions on the Installation page
- run MiToBo and start the operator runner by selecting the menu item MiToBo Runner from Plugins -> MiToBo
- in the selection menu navigate to 'de.unihalle.informatik.MiToBo.tool.interactive' and select the operator LabelImageEditor
This will bring up the operator window of the LabelImageEditor (see figure on the right, top) where the basic configuration parameters can be added. Clicking the "Run" button will open the editor window with the first image loaded (figure on the right, bottom).
- Input data:
The operator reads the contents of a given input image directory and displays all images one after the other to the user.
The user can edit the images, i.e. remove labeled regions, by clicking with the left mouse button somewhere into the region to remove.
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. - Output data:
For each input image the operator will save a corresponding output image, either in the same folder or a specific output folder if provided.
Output images will share the name of the corresponding input image extended with substring "-edited".
- Parameters:
| Name | Description |
| Input Directory | directory from where the images to process will be loaded |
| File Filter | String which needs to be contained in the names of image files to be processed, file names not containing the pattern will be skipped. For example, if the string ".tif" is provided, only images ending with ".tif", i.e. in TIFF format, will be considered, the string "cell" would select only images containing the word "cell" somewhere in their name. Note that as string any valid Java regular expression is admissible. See for example this website for more details on regular expressions. |
| Output directory | optional; edited result label images will be saved to this directory; if not provided the result images will be stored in the input folder |
Updates
March 2018
- The LabelImageEditor has been released in MiToBo 1.8.8 and MiToBo-plugins 1.8.8, respectively.
