Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
eyes:interactive:contouring [2017/06/12 14:11]
nfische
eyes:interactive:contouring [2017/06/12 17:56] (current)
bgraf
Line 1: Line 1:
 ====== Contouring (Interactive) ====== ====== Contouring (Interactive) ======
-The interactive contouring logic can be used to manually contour ​2d particle images and class averages or 3D volume(s) in a shape-specific manner. ​+The interactive contouring logic can be used to manually contour ​2D particle images and class averages or 3D volume(s) in a shape-specific manner. ​
  
 ===== Usage ===== ===== Usage =====
 Contouring defines the boundary between particle and unwanted particle regions or background-noise - an important step to increase the signal-to-noise ratio and/or to focus image processing on a certain region. ​ Contouring defines the boundary between particle and unwanted particle regions or background-noise - an important step to increase the signal-to-noise ratio and/or to focus image processing on a certain region. ​
  
-As input data a stack of 2D images or a 3D volume is required. Push the PLAY button once to import the data resulting in a blue hourglass. Then click the notepad to start the contouring process in a new window. In the main area, the current slice of the 2D/3d stack to be contoured is shown. At the bottom the current slice and previews of the previous and the following image are shown. Areas to be excluded are overlaid with a mesh, areas to be included are clear. To apply the selection of contoured images the process has to be saved by clicking the SAVE button and then executed with the RUN button. ​+As input data a stack of 2D images or a 3D volume is required. Push the PLAY button once to import the data resulting in a blue hourglass. Then click the notepad to start the contouring process in a new window. In the main area, the current slice of the 2D/3D stack to be contoured is shown. At the bottom the current slice and previews of the previous and the following image are shown. Areas to be excluded are overlaid with a mesh, areas to be included are clear. To apply the selection of contoured images the process has to be saved by clicking the SAVE button and then executed with the RUN button. ​
  
-Layers ​can be defined to obtain more flexible masks, which may be combined with other masks also from other contouring sessions.+Different masks ("​layers"​) ​can be defined to obtain more flexible masks, which may be combined ​in different ways, also with masks from other contouring sessions.
  
 ==== Contouring Modes ==== ==== Contouring Modes ====
 Three different modes are available for contouring, which all act on the slice of the 2D/3D stack shown in the main window: Three different modes are available for contouring, which all act on the slice of the 2D/3D stack shown in the main window:
-   * **Bezier-Mode:** A continuous line can be drawn with the cursor by keeping the left mouse button pressed, thereby defining the boundary between particle and background-noise.  + 
-  * **Poly-Line:** By single mouse clicks the contouring area is connected by lines. By double-clicking the right mouse button inside the selected area the mode can be finished resulting in a clear contoured and a shaded non-contoured area.  +|< 100% 30% >| 
-  * **Drawing-Mode:** By holding the left mouse button areas that should be excluded can be marked.  +^ Parameters ​                ^ Description ​    ^ 
-  * **Invert-Mask:** Invert the definition of areas to be included or excluded for the current slice. ​+Bezier-Mode ​ ​| ​A continuous line can be drawn with the cursor by keeping the left mouse button pressed, thereby defining the boundary between particle and background-noise. ​| 
 +Poly-Line ​By single mouse clicks the contouring area is connected by lines. By double-clicking the right mouse button inside the selected area the mode can be finished resulting in a clear contoured and a shaded non-contoured area. 
 +Drawing-Mode ​By holding the left mouse button areas that should be excluded can be marked. ​| 
 +Invert-Mask ​Invert the definition of areas to be included or excluded for the current ​slice. | 
 +   
 +==== Layers ==== 
 +Use the plus (+) button on the bottom left to add separate masks ("​layers"​),​ the minus (-) button to delete selected masks. Overlapping areas of different selected masks can be combined in three different ways: //Union// (all areas of all selected masks are combined), //​Intersection//​ (only overlaps of masks are combined) and //​Difference//​ (only none overlapping parts are combined). ​ Only masks with checked boxes will be later applied for contouring of the respective ​slice.
  
 ===== Shortcuts ===== ===== Shortcuts =====
Line 27: Line 33:
   * excluding specific areas from contouring: CTRL + selection in //​Bezier//​-mode ​   * excluding specific areas from contouring: CTRL + selection in //​Bezier//​-mode ​
  
 +===== Input =====
 +
 +
 +|< 100% 30% >|
 +^ Input   ^ Description ^
 +| Io::​in ​ | Input stack of 2D images/3D volume to be contoured |
 +| //​Io::​input::​layer//​ | Masks (layers) from previous Contouring run |
 +
 +
 +===== Output =====
 +
 +|< 100% 30% >|
 +^ Output ​  ^ Description ^
 +| Io::layer | All masks created as separate layers to be used in another Contouring run |
 +| Io::mask | Mask as applied to the image stack  |
 +| Io::out | Stack of 2D images/3D volume contoured with selected mask/​combination of masks |