Differences

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

Link to this comparison view

Next revision 		Previous revision
eyes:logics:filtering [2017/06/07 11:24]
jschlie1 created 		eyes:logics:filtering [2017/06/12 17:38] (current)
jschlie1
Line 1: Line 1:
-====== ​Template Logic Description ​======+====== ​Filtering ​======
 Filters provide an easy to use, yet powerful tool to remove interfering elements (like noise or ice gradients) from an image. Here, a set of different filters are provided which all apply a filter onto the input stack of images. ​ Filters provide an easy to use, yet powerful tool to remove interfering elements (like noise or ice gradients) from an image. Here, a set of different filters are provided which all apply a filter onto the input stack of images. ​
  
 ===== Usage ===== ===== Usage =====
-A stack of images/3Ds or an individual 3D will be subjected to the selected filter with its respective filter parameters. For more detail on the capabilities of the available filters and their parameters, consult the respective process section below. +A stack of images/3Ds or an individual 3D will be subjected to the selected filter with its respective filter parameters. For more detail on the capabilities of the available filters and their parameters, consult the respective process section below. ​Since most of the filters just have one input (e.g. stack of images) and one output (e.g. stack of images w/ applied filter), only divergent in-/outputs are mentioned. ​
- +
-===== Example ==== +
-FIXME+
  
 ===== Processes ===== ===== Processes =====
 ==== Butterworth ==== ==== Butterworth ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences.+Applies ​a [[http://​en.wikipedia.org/​wiki/​Butterworth_filter|Butterworth Filter]] with the chosen parameters to the images. A butterworth filter has a smooth transfer function without any discontinuity. The filter functions used in this logic are:
  
-|< 100% 30% >| +B(Low Pass)= 1/ (1+[D(u,​v)/​D<sub>L </sub>​]<​sup>​2n</​sup>​) ​   
-^ Parameters ​                ^ Description ​    ^ +     ​ 
-| Some changeable parameter ​ | Description of this parameter | +B(High Pass)= 1- (1/ (1+[D(u,​v)/​D<​sub>H</sub>​]<​sup>​2n</​sup>​))
-| -> and its sub-parameter ​  ​| more description | +
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions |+
  
-|< 100% 30% >| +where D(u,v) is the distance from the origin, n is the order of the filter and D<sub>L</sub>/D<​sub>​H<​/sub> is the cut frequency.
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //ThirdInput//  | Input Description 3: Optional Input in Italic |+
  
 |< 100% 30% >| |< 100% 30% >|
-^ Output ​  ^ Description ^ +^ Parameters ​                ^ Description ​    ​^ 
-| FirstOutput ​| Output Description ​| +| Type  ​| Select whether you want to apply a highpass or lowpass filter ​| 
- +| pass-band ​  | Order of the filter //n// | 
-|< 100% 30% >| +| showFilterFunction ​       ​| Use this option to change the output consisting of complex images showing the filter function instead of the filtered images ​| 
-^ New/Changed Header Values ^ Description ^ +| stop-band ​  | Upper or lower frequency cut-off //​D<​sub>​L</​sub>//​ / //​D<​sub>​H</​sub>//,​ depending on whether high- or lowpassfilter ​is selected ​|
-| headerValue1 | what does it say? how is it changed? ​| +
-| headerValue2 ​| what does it say? how is it changed? ​| +
-| headerValue3 ​| what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? ​|+
  
 ==== Convolution ==== ==== Convolution ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. 
  
 |< 100% 30% >| |< 100% 30% >|
-^ Parameters ​                ​^ Description ​    ^ +^ Parameters ​  ​^ Description ​    ^ 
-| Some changeable parameter  ​| Description of this parameter | +| Flip         | Description of this parameter | 
-| -> and its sub-parameter ​  | more description ​| +| Scale factor ​| more description |
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions ​|+
  
-|< 100% 30% >| +==== Cosine ​BP/LP/HP ==== 
-^ Input   ^ Description ^ +This processor applies a cosine bandpass, lowpass or highpass filter, respectively,​ on the images. 
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? | +
- +
-==== Cosine ​bandpass/highpass/lowpass ​==== +
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. +
- +
-|< 100% 30% >| +
-^ Parameters ​                ^ Description ​    ^ +
-| Some changeable parameter ​ | Description of this parameter | +
-| -> and its sub-parameter ​  | more description | +
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description |+
  
 |< 100% 30% >| |< 100% 30% >|
-^ New/Changed Header Values ​^ Description ^ +^ Parameters ​             ​^ Description ​    ​^ 
-| headerValue1 ​| what does it say? how is it changed? ​| +| Cosine width [0...1] ​   ​| This value sets the width of the cosine function in the filter mask.  ​| 
-| headerValue2 ​| what does it say? how is it changed? ​| +| Upper frequency [0...1] ​  | This value sets the lowpass frequency used for the filtering mask.  ​| 
-| headerValue3 ​| what does it say? how is it changed? ​| +| Lower frequency [0...1]  ​| This value sets the highpass frequency used for the filtering mask.  ​| 
-| headerValue4 ​| what does it say? how is it changed? ​|+| showFilterfunction ​     ​| If enabled, the output shows the filter mask according to the set parameters instead of the filtered images. ​|
  
 ==== Difference of gaussians ==== ==== Difference of gaussians ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful ​in not more than 2 sentences.+The DoG is a wavelet mother function of null total sum which approximates ​the Mexican Hat Wavelet by subtracting a wide from a narrow Gaussian. This filter is applied on each input image and results ​in feature enhancement through edge detection. Further details can be [[http://​rspb.royalsocietypublishing.org/​content/​207/​1167/​187|found here]] and [[http://​micro.magnet.fsu.edu/​primer/​java/​digitalimaging/​processing/​diffgaussians/​index.html|here]] ​. FIXME
  
 |< 100% 30% >| |< 100% 30% >|
 ^ Parameters ​                ^ Description ​    ^ ^ Parameters ​                ^ Description ​    ^
-| Some changeable parameter ​ ​| ​Description ​of this parameter ​| +| Narrow standard deviation ​ ​| ​This value sets narrower standard deviation for the DoG method. It describes one of the kernel functions used to perform the filtering procedure. If ''​Narrow standard deviation''​ is larger than ''​Wide standard deviation'',​ the values are swapped. ​| 
-| -> and its sub-parameter ​  | more description | +| Wide standard deviation ​  | This value sets wider standard deviation for the DoG method. It describes one of the kernel functions used to perform the filtering procedure. If ''​Narrow standard deviation''​ is larger than ''​Wide standard deviation'',​ the values are swapped.  |
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? ​|+
  
 ==== Flat histogram ==== ==== Flat histogram ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences.+FIXME
  
 |< 100% 30% >| |< 100% 30% >|
Line 127: Line 57:
 | -> and its sub-parameter ​  | ... descriptions | | -> and its sub-parameter ​  | ... descriptions |
  
-|< 100% 30% >| +==== Gauss BP/LP/HP ==== 
-^ Input   ^ Description ^ +This processor applies a Gaussian bandpass, lowpass or highpass filter, respectively,​ on the images. 
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? | +
- +
-==== Gauss bandpass/lowpass/highpass ​==== +
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. +
- +
-|< 100% 30% >| +
-^ Parameters ​                ^ Description ​    ^ +
-| Some changeable parameter ​ | Description of this parameter | +
-| -> and its sub-parameter ​  | more description | +
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description |+
  
 |< 100% 30% >| |< 100% 30% >|
-^ New/Changed Header Values ​^ Description ^ +^ Parameters ​               ​^ Description ​    ​^ 
-| headerValue1 ​| what does it say? how is it changed? ​| +| Upper frequency [0...1] ​  | This value sets the lowpass frequency used for the filtering mask.  ​| 
-| headerValue2 ​| what does it say? how is it changed? ​| +| Lower frequency [0...1] ​  | This value sets the highpass frequency used for the filtering mask.  ​| 
-| headerValue3 ​| what does it say? how is it changed? ​| +| Show filter function ​     ​| Gives the filter function as output instead of the filtered images. ​| 
-| headerValue4 ​| what does it say? how is it changed? ​|+| Transmission ​             ​| Defines the width of the cutoff region of the Gaussian function. ​|
  
 ==== Gaussian bilateral filtering ==== ==== Gaussian bilateral filtering ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences.+This processor applies ​a Gaussian bilateral filter on image data.
  
 |< 100% 30% >| |< 100% 30% >|
-^ Parameters ​                ​^ Description ​    ^ +^ Parameters ​            ​^ Description ​    ^ 
-| Some changeable parameter  ​| Description ​of this parameter ​| +| Range kernel std dev   | This value sets the standard deviation ​of the range kernel used to smooth differences in intensities (Gaussian function). ​| 
-| -> and its sub-parameter ​  | more description | +| Spatial kernel std dev | This value sets the standard deviation of the spatial kernel used to smooth differences in intensities (Gaussian function).  | 
-| Next main parameter ​       | and more more more | +| Size of window ​        | This value sets the size of the window used to compute the intensity values during the filtering process. ​ |
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput ​| Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? ​|+
  
 ==== Hann window filter ==== ==== Hann window filter ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences.+FIXME
  
 |< 100% 30% >| |< 100% 30% >|
-^ Parameters ​                ​^ Description ​    ^ +^ Parameters ​          ​^ Description ​    ^ 
-| Some changeable parameter  ​| Description of this parameter | +| Hann window factor ​  | Description of this parameter | 
-| -> and its sub-parameter ​  | more description | +| Show filter function ​| Gives the filter function as output instead of the filtered images. |
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? ​|+
  
 ==== Kernel convolution ==== ==== Kernel convolution ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. +FIXME
- +
-|< 100% 30% >| +
-^ Parameters ​                ^ Description ​    ^ +
-| Some changeable parameter ​ | Description of this parameter | +
-| -> and its sub-parameter ​  | more description | +
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  | ... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput// ​ | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? |+
  
 ==== Sobel ==== ==== Sobel ====
-Here, a short introduction for the given mode should be placed. Again, state WHAT and WHY this mode us useful in not more than 2 sentences. +This processor performs edge detection, resulting in a binary image (part of edge =1 , rest =0 ). This processor is based on the Sobel Operator. More information [[https://​en.wikipedia.org/wiki/Sobel_operator|can be found here]].
- +
-|< 100% 30% >| +
-^ Parameters ​                ^ Description ​    ^ +
-| Some changeable parameter ​ | Description of this parameter | +
-| -> and its sub-parameter ​  | more description | +
-| Next main parameter ​       | and more more more | +
-| -> and its sub-parameter ​  ​| ​... descriptions | +
- +
-|< 100% 30% >| +
-^ Input   ^ Description ^ +
-| FirstInput ​ | Input Description 1 | +
-| SecondInput | Input Description 2 | +
-| //​ThirdInput//  | Input Description 3: Optional Input in Italic | +
- +
-|< 100% 30% >| +
-^ Output ​  ^ Description ^ +
-| FirstOutput | Output Description | +
- +
-|< 100% 30% >| +
-^ New/Changed Header Values ^ Description ^ +
-| headerValue1 | what does it say? how is it changed? | +
-| headerValue2 | what does it say? how is it changed? | +
-| headerValue3 | what does it say? how is it changed? | +
-| headerValue4 | what does it say? how is it changed? | +
- +
-===== Concept ===== +
-In this paragraph, the "HOW a logic works under the hood" and WHY someone should use it can be elaborated with higher detail. Describes a scenario in an image processing workflow where this logic can be used to solve the resulting problem. Also, wikipages, publications or anything else describing the theory behind an algorithm should be linked ​here, if applicable.+