.. _eu.gmic.Smoothtotalvariation:

G’MIC Smooth total variation node
=================================

*This documentation is for version 1.0 of G’MIC Smooth total variation.*

Description
-----------

Wrapper for the G’MIC framework (http://gmic.eu) written by Tobias Fleischer (http://www.reduxfx.com) and Frederic Devernay.

Inputs
------

+----------+-------------+----------+
| Input    | Description | Optional |
+==========+=============+==========+
| Source   |             | No       |
+----------+-------------+----------+
| Layer -1 |             | Yes      |
+----------+-------------+----------+
| Layer -2 |             | Yes      |
+----------+-------------+----------+
| Layer -3 |             | Yes      |
+----------+-------------+----------+

Controls
--------

.. tabularcolumns:: |>{\raggedright}p{0.2\columnwidth}|>{\raggedright}p{0.06\columnwidth}|>{\raggedright}p{0.07\columnwidth}|p{0.63\columnwidth}|

.. cssclass:: longtable

+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Parameter / script name                                                       | Type    | Default          | Function                            |
+===============================================================================+=========+==================+=====================================+
| Amplitude / ``Amplitude``                                                     | Double  | 60               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Sharpness / ``Sharpness``                                                     | Double  | 0.9              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Anisotropy / ``Anisotropy``                                                   | Double  | 0.64             |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Gradient smoothness / ``Gradient_smoothness``                                 | Double  | 3.1              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Tensor smoothness / ``Tensor_smoothness``                                     | Double  | 1.1              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Spatial precision / ``Spatial_precision``                                     | Double  | 0.8              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Angular precision / ``Angular_precision``                                     | Double  | 30               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Value precision / ``Value_precision``                                         | Double  | 2                |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Interpolation / ``Interpolation``                                             | Choice  | Nearest neighbor | |                                   |
|                                                                               |         |                  | | **Nearest neighbor**              |
|                                                                               |         |                  | | **Linear**                        |
|                                                                               |         |                  | | **Runge-Kutta**                   |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Fast approximation / ``Fast_approximation``                                   | Boolean | On               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Iterations / ``Iterations``                                                   | Integer | 1                |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Channel(s) / ``Channels``                                                     | Choice  | RGB              | |                                   |
|                                                                               |         |                  | | **RGB**                           |
|                                                                               |         |                  | | **Luminance**                     |
|                                                                               |         |                  | | **Blue & Red chrominances**       |
|                                                                               |         |                  | | **Blue chrominance**              |
|                                                                               |         |                  | | **Red chrominance**               |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Parallel processing / ``Parallel_processing``                                 | Choice  | Auto             | |                                   |
|                                                                               |         |                  | | **Auto**                          |
|                                                                               |         |                  | | **One thread**                    |
|                                                                               |         |                  | | **Two threads**                   |
|                                                                               |         |                  | | **Four threads**                  |
|                                                                               |         |                  | | **Eight threads**                 |
|                                                                               |         |                  | | **Sixteen threads**               |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Spatial overlap / ``Spatial_overlap``                                         | Integer | 24               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Time step / ``Time_step``                                                     | Double  | 30               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Iterations_2 / ``Iterations_2``                                               | Integer | 10               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Keep iterations as different layers / ``Keep_iterations_as_different_layers`` | Boolean | Off              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Channel(s)_2 / ``Channels_2``                                                 | Choice  | All              | |                                   |
|                                                                               |         |                  | | **All**                           |
|                                                                               |         |                  | | **RGBA [all]**                    |
|                                                                               |         |                  | | **RGB [all]**                     |
|                                                                               |         |                  | | **RGB [red]**                     |
|                                                                               |         |                  | | **RGB [green]**                   |
|                                                                               |         |                  | | **RGB [blue]**                    |
|                                                                               |         |                  | | **RGBA [alpha]**                  |
|                                                                               |         |                  | | **Linear RGB [all]**              |
|                                                                               |         |                  | | **Linear RGB [red]**              |
|                                                                               |         |                  | | **Linear RGB [green]**            |
|                                                                               |         |                  | | **Linear RGB [blue]**             |
|                                                                               |         |                  | | **YCbCr [luminance]**             |
|                                                                               |         |                  | | **YCbCr [blue-red chrominances]** |
|                                                                               |         |                  | | **YCbCr [blue chrominance]**      |
|                                                                               |         |                  | | **YCbCr [red chrominance]**       |
|                                                                               |         |                  | | **YCbCr [green chrominance]**     |
|                                                                               |         |                  | | **Lab [lightness]**               |
|                                                                               |         |                  | | **Lab [ab-chrominances]**         |
|                                                                               |         |                  | | **Lab [a-chrominance]**           |
|                                                                               |         |                  | | **Lab [b-chrominance]**           |
|                                                                               |         |                  | | **Lch [ch-chrominances]**         |
|                                                                               |         |                  | | **Lch [c-chrominance]**           |
|                                                                               |         |                  | | **Lch [h-chrominance]**           |
|                                                                               |         |                  | | **HSV [hue]**                     |
|                                                                               |         |                  | | **HSV [saturation]**              |
|                                                                               |         |                  | | **HSV [value]**                   |
|                                                                               |         |                  | | **HSI [intensity]**               |
|                                                                               |         |                  | | **HSL [lightness]**               |
|                                                                               |         |                  | | **CMYK [cyan]**                   |
|                                                                               |         |                  | | **CMYK [magenta]**                |
|                                                                               |         |                  | | **CMYK [yellow]**                 |
|                                                                               |         |                  | | **CMYK [key]**                    |
|                                                                               |         |                  | | **YIQ [luma]**                    |
|                                                                               |         |                  | | **YIQ [chromas]**                 |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Parallel processing_2 / ``Parallel_processing_2``                             | Choice  | Auto             | |                                   |
|                                                                               |         |                  | | **Auto**                          |
|                                                                               |         |                  | | **One thread**                    |
|                                                                               |         |                  | | **Two threads**                   |
|                                                                               |         |                  | | **Four threads**                  |
|                                                                               |         |                  | | **Eight threads**                 |
|                                                                               |         |                  | | **Sixteen threads**               |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Spatial overlap_2 / ``Spatial_overlap_2``                                     | Integer | 24               |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Preview type / ``Preview_type``                                               | Choice  | Full             | |                                   |
|                                                                               |         |                  | | **Full**                          |
|                                                                               |         |                  | | **Forward horizontal**            |
|                                                                               |         |                  | | **Forward vertical**              |
|                                                                               |         |                  | | **Backward horizontal**           |
|                                                                               |         |                  | | **Backward vertical**             |
|                                                                               |         |                  | | **Duplicate top**                 |
|                                                                               |         |                  | | **Duplicate left**                |
|                                                                               |         |                  | | **Duplicate bottom**              |
|                                                                               |         |                  | | **Duplicate right**               |
|                                                                               |         |                  | | **Duplicate horizontal**          |
|                                                                               |         |                  | | **Duplicate vertical**            |
|                                                                               |         |                  | | **Checkered**                     |
|                                                                               |         |                  | | **Checkered inverse**             |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Preview split / ``Preview_split``                                             | Double  | x: 0.5 y: 0.5    |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Output Layer / ``Output_Layer``                                               | Choice  | Layer 0          | |                                   |
|                                                                               |         |                  | | **Merged**                        |
|                                                                               |         |                  | | **Layer 0**                       |
|                                                                               |         |                  | | **Layer -1**                      |
|                                                                               |         |                  | | **Layer -2**                      |
|                                                                               |         |                  | | **Layer -3**                      |
|                                                                               |         |                  | | **Layer -4**                      |
|                                                                               |         |                  | | **Layer -5**                      |
|                                                                               |         |                  | | **Layer -6**                      |
|                                                                               |         |                  | | **Layer -7**                      |
|                                                                               |         |                  | | **Layer -8**                      |
|                                                                               |         |                  | | **Layer -9**                      |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Resize Mode / ``Resize_Mode``                                                 | Choice  | Dynamic          | |                                   |
|                                                                               |         |                  | | **Fixed (Inplace)**               |
|                                                                               |         |                  | | **Dynamic**                       |
|                                                                               |         |                  | | **Downsample 1/2**                |
|                                                                               |         |                  | | **Downsample 1/4**                |
|                                                                               |         |                  | | **Downsample 1/8**                |
|                                                                               |         |                  | | **Downsample 1/16**               |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Ignore Alpha / ``Ignore_Alpha``                                               | Boolean | Off              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Preview/Draft Mode / ``PreviewDraft_Mode``                                    | Boolean | Off              |                                     |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
| Log Verbosity / ``Log_Verbosity``                                             | Choice  | Off              | |                                   |
|                                                                               |         |                  | | **Off**                           |
|                                                                               |         |                  | | **Level 1**                       |
|                                                                               |         |                  | | **Level 2**                       |
|                                                                               |         |                  | | **Level 3**                       |
+-------------------------------------------------------------------------------+---------+------------------+-------------------------------------+
