Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
|
interimage:operators_documentation [2010/06/23 11:42] tkorting |
interimage:operators_documentation [2014/06/04 15:13] rsilva |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| [[interimage:|InterIMAGE wiki]] | [[interimage:|InterIMAGE wiki]] | ||
| - | |||
| ====== TerraAIDA Operators Documentation ====== | ====== TerraAIDA Operators Documentation ====== | ||
| - | Operators reference version: 1.0.5 | + | Operators reference version: 1.0.6 |
| - | ===== TerraAIDA Arithmetic ===== | + | |
| + | InterIMAGE is a multi-platform framework, written in C++, currently with implementations for LINUX and Windows operational systems. Moreover, InterIMAGE provides support for the integration of image processing operators in the interpretation process and, as such operators are treated as external programs by its control mechanism, they can be coded in any computer language, and even in proprietary programs. The InterIMAGE framework offers, nonetheless, a repository of operators, called TerraAIDA ([[http://www.dpi.inpe.br/terraaida]]), assembled with software classes and functions supplied by the [[http://www.terralib.org/|TerraLib]] library. | ||
| + | |||
| + | |||
| + | |||
| + | ===== TA Arithmetic ===== | ||
| **Authors** | **Authors** | ||
| Line 25: | Line 29: | ||
| **Multi-Class support** | **Multi-Class support** | ||
| - | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". | + | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". Alternatively, you can define a new node name in the input parameter named **Non Class Name**. |
| [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | ||
| Line 47: | Line 51: | ||
| | Polygons Min Area | Integer | Generated polygons minimum allowed area (pixels). | | Only polygons with area greater than the supplied values will generate hypothesis. | | | Polygons Min Area | Integer | Generated polygons minimum allowed area (pixels). | | Only polygons with area greater than the supplied values will generate hypothesis. | | ||
| | Dummy Value (no data) | Floating point | The dummy value from input images. | | If not present, all image data will be processed. | | | Dummy Value (no data) | Floating point | The dummy value from input images. | | If not present, all image data will be processed. | | ||
| - | | Arithmetic Expression | String | One valid arithmetic expression, formed by a combination of the following elements, separated by spaces. | Operators: +, -, *, /, Real Numbers, Raster indexes and bands R0:1, R1:2 | Example: Quickbird-2 image with bands (0=B,1=G,2=R,3=NIR), the NDVI is calculated by ( R0:3 - R0:2 ) / ( R0:3 + R0:2 ). | | + | | Arithmetic Expression | String | One valid arithmetic expression, formed by a combination of the following elements, separated by spaces. | Operators: +, -, *, /, Real Numbers, Raster indexes and bands R0:1, R1:2 | Example: Quickbird-2 image with bands (0=B,1=G,2=R,3=NIR), the NDVI is calculated by ( R0:3 - R0:2 ) / ( R0:3 + R0:2 ). **The blank space around the mathematical operators +, -, *, / are mandatory.** | |
| | Morphological Filter Iterations | Integer | Number of morphological (mode) iterations applied to the result. | Greater or equal to 0. | The use of a value greater than or equal to 1 is advised to avoid the creation of to small hypothesis | | | Morphological Filter Iterations | Integer | Number of morphological (mode) iterations applied to the result. | Greater or equal to 0. | The use of a value greater than or equal to 1 is advised to avoid the creation of to small hypothesis | | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE region format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE region format. | | | ||
| | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| + | | Non Class Name | String | If Multi-Class support is active, the discarded hypothesis will fall in the node named by this parameter. | One string with the name of some node in the tree, in the same level. | | | ||
| - | ===== TerraAIDA Baatz Segmenter ===== | + | ===== TA Baatz Segmenter ===== |
| **Authors** | **Authors** | ||
| Line 99: | Line 104: | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | ||
| | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| | Euclidean Distance Threshold | Floating point | The minimum Euclidean Distance between each segment feature. | Greater than 0. | This parameter is required to merge adjacent block segments when the optimization option is enabled | | | Euclidean Distance Threshold | Floating point | The minimum Euclidean Distance between each segment feature. | Greater than 0. | This parameter is required to merge adjacent block segments when the optimization option is enabled | | ||
| - | ===== TerraAIDA Bottom-Up Export ===== | + | ===== TA Bottom-Up Export ===== |
| **Author** | **Author** | ||
| Line 139: | Line 144: | ||
| {{ interimage:buexport.png }} | {{ interimage:buexport.png }} | ||
| - | ===== TerraAIDA C4.5 Classifier ===== | + | ===== TA C4.5 Classifier ===== |
| **Author** | **Author** | ||
| Line 171: | Line 176: | ||
| One example of this operator can be found [[interimage:examples:supervised_c45|here]]. | One example of this operator can be found [[interimage:examples:supervised_c45|here]]. | ||
| - | ===== TerraAIDA Checkerboard Segmenter ===== | + | |
| + | |||
| + | |||
| + | ===== TA Checkerboard Segmenter ===== | ||
| **Author** | **Author** | ||
| Line 197: | Line 205: | ||
| ^ Parameter Name ^ Type ^ Description ^ Valid Values ^ Note ^ | ^ Parameter Name ^ Type ^ Description ^ Valid Values ^ Note ^ | ||
| - | | Number of grid lines | Integer | Number of lines to divide the image. | Greater than zero. | | | + | | Number of grid lines | Integer | Number of lines to divide the image. | Greater than zero. | | |
| - | | Number of grid columns | Integer | Number of columns to divide the image. | Greater than zero. | | | + | | Number of grid columns | Integer | Number of columns to divide the image. | Greater than zero. | | |
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Amount of points in X | Integer | Number of pixels per cell in X dimension. | Greater than zero. | | |
| + | | Amount of points in Y | Integer | Number of pixels per cell in Y dimension. | Greater than zero. | | | ||
| + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | ||
| - | ===== TerraAIDA NDVI Segmenter ===== | + | |
| + | ===== TA NDVI Segmenter ===== | ||
| **Authors** | **Authors** | ||
| Line 226: | Line 237: | ||
| **Multi-Class support** | **Multi-Class support** | ||
| - | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". | + | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". Alternatively, you can define a new node name in the input parameter named **Non Class Name**. |
| [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | ||
| Line 250: | Line 261: | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | ||
| | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| + | | Non Class Name | String | If Multi-Class support is active, the discarded hypothesis will fall in the node named by this parameter. | One string with the name of some node in the tree, in the same level. | | | ||
| - | ===== TerraAIDA Region Growing Segmenter ===== | + | ===== TA Region Growing Segmenter ===== |
| **Authors** | **Authors** | ||
| Line 295: | Line 307: | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | ||
| | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| ** Segmentation Example** | ** Segmentation Example** | ||
| Line 303: | Line 315: | ||
| - | ===== TerraAIDA ShapeFile Import ===== | + | ===== TA ShapeFile Import ===== |
| **Authors** | **Authors** | ||
| Line 329: | Line 341: | ||
| Shape file attributes with the the following names will not be imported: REGION, CLASS, ID, GEOWEST, GEONORTH, GEOEAST, GEOSOUTH, FILE_GEOWEST, FILE_GEONORTH, FILE_GEOEAST, FILE_GEOSOUTH, P, FILE, LLX, LLY, URX, URY. | Shape file attributes with the the following names will not be imported: REGION, CLASS, ID, GEOWEST, GEONORTH, GEOEAST, GEOSOUTH, FILE_GEOWEST, FILE_GEONORTH, FILE_GEOEAST, FILE_GEOSOUTH, P, FILE, LLX, LLY, URX, URY. | ||
| + | |||
| + | **Processing sequence** | ||
| + | |||
| + | -Read user input shape file. | ||
| + | -Generates the intersection between the loaded shape file polygons and the operator execution area. | ||
| + | -Apply the user decision rule (using the supplied training set) over the intersection polygons. | ||
| + | -Generate the output hypothesis. | ||
| **Input parameters** | **Input parameters** | ||
| Line 338: | Line 357: | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE region format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE region format. | | | ||
| | Decision Rule | Decision rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| {{ :interimage:shape_file_import_example.png }} | {{ :interimage:shape_file_import_example.png }} | ||
| - | ===== TerraAIDA ShapeFile Intersection ===== | + | ===== TA ShapeFile Intersection ===== |
| **Authors** | **Authors** | ||
| Line 363: | Line 382: | ||
| **Multi-Class support** | **Multi-Class support** | ||
| - | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". | + | Yes. If you select //true// in the "Top Down Multi-Class" option, you must create another node in the same level with a corresponding opposite name, with prefix "n-". For example, if this class name is "MyClass" the opposite class name will be "n-MyClass". Hypothesis discarded by this operator will be classified as "n-MyClass". Alternatively, you can define a new node name in the input parameter named **Non Class Name**. |
| [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | [[interimage:example_supervised_c45|Example of using Multi-Class support.]] | ||
| + | |||
| + | **Processing sequence** | ||
| + | |||
| + | -Read user input shape file. | ||
| + | -Generates the intersection between the loaded shape file polygons and the operator execution area. | ||
| + | -Using the intersection result generates a set of intermediate hypothesis of "MyClass" and the opposite class "n-MyClass", as describe above. | ||
| + | -Apply the user decision rule (using the supplied training set) over the intermediate hypothesis set. | ||
| + | -Generate the output hypothesis from the decision rule result. | ||
| **Input parameters** | **Input parameters** | ||
| Line 376: | Line 403: | ||
| | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | ||
| | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Leave blank to accept all generated hypothesis. | | ||
| - | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | | + | | Reliability | Floating point | The reliability (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | [0.0, 1.0] | | |
| + | | Non Class Name | String | If Multi-Class support is active, the discarded hypothesis will fall in the node named by this parameter. | One string with the name of some node in the tree, in the same level. | | | ||
| {{ :interimage:shape_file_intersection_example.png }} | {{ :interimage:shape_file_intersection_example.png }} | ||
