interimage:operators_documentation
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
Ambos lados da revisão anteriorRevisão anteriorPróxima revisão | Revisão anteriorPróxima revisãoAmbos lados da revisão seguinte | ||
interimage:operators_documentation [2010/05/11 17:38] – tkorting | interimage:operators_documentation [2010/09/06 19:24] – tkorting | ||
---|---|---|---|
Linha 1: | Linha 1: | ||
[[interimage: | [[interimage: | ||
- | |||
====== TerraAIDA Operators Documentation ====== | ====== TerraAIDA Operators Documentation ====== | ||
+ | Operators reference version: 1.0.5 | ||
+ | |||
+ | 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, | ||
===== TerraAIDA Arithmetic ===== | ===== TerraAIDA Arithmetic ===== | ||
Linha 13: | Linha 15: | ||
**Description** | **Description** | ||
- | Generate segments based on the threshold image resultant from an arithmetic operation from the given input images. | + | Generate segments based on the threshold image. It is the result of an arithmetic operation from the given input images. |
**Type** | **Type** | ||
Linha 25: | Linha 27: | ||
**Multi-Class support** | **Multi-Class support** | ||
- | Yes. If you select //true// in the "Top Down Multi-Class" | + | Yes. If you select //true// in the "Top Down Multi-Class" |
[[interimage: | [[interimage: | ||
Linha 49: | Linha 51: | ||
| Arithmetic Expression | | Arithmetic Expression | ||
| 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 | + | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE |
| 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 | | Node Weight | ||
+ | | 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 ===== | ===== TerraAIDA Baatz Segmenter ===== | ||
Linha 62: | Linha 65: | ||
**Description** | **Description** | ||
- | This operator performs a Baatz based segmentation (see the reference article for more information). Each generated segment represents an hypothesis to be analyzed by the next semantic network node. | + | This operator performs a segmentation |
**Type** | **Type** | ||
Linha 78: | Linha 81: | ||
** Reference** | ** Reference** | ||
- | * Baatz, M.; Schape, A. Multiresolution segmentation: | + | * Baatz, M.; Schäpe, A. Multiresolution segmentation: |
**Processing sequence** | **Processing sequence** | ||
Linha 100: | Linha 103: | ||
| Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | | Decision Rule | Decision Rule | Decision rule applied to the generated hypothesis. | ||
| Node Weight | | Node Weight | ||
- | | Euclidean Distance Threshold | Floating point | The minimum | + | | Euclidean Distance Threshold | Floating point | The minimum |
+ | |||
+ | ===== TerraAIDA Bottom-Up Export ===== | ||
+ | |||
+ | **Author** | ||
+ | |||
+ | Emiliano Castejon, [[castejon@dpi.inpe.br]]\\ | ||
+ | |||
+ | **Description** | ||
+ | |||
+ | Allows to export the bottom-up hypothesis (including its attributes) to a shape file. This operator acts like the generic bottom-up operator, making a copy of every hypothesis to the shape file. No spatial conflict resolution is performed when there is no decision rule. | ||
+ | |||
+ | **Type** | ||
+ | |||
+ | Bottom-Up operator. | ||
+ | |||
+ | **Applies to** | ||
+ | |||
+ | Root (scene) and internal nodes. | ||
+ | |||
+ | **Multi-Class support** | ||
+ | |||
+ | No. | ||
+ | |||
+ | **Processing sequence** | ||
+ | |||
+ | -Read input hypothesis | ||
+ | -Apply the user decision rule using the supplied training set. | ||
+ | -Generate the output hypothesis | ||
+ | -Generate the output shape file | ||
+ | |||
+ | **Input parameters** | ||
+ | |||
+ | ^ Parameter Name ^ Type ^ Description | ||
+ | | Shape File Name | * .shp | Shape file name. | A valid shape file name. | The shapefile will be composed only by polygons and their respective attributes. | ||
+ | | Decision Rule | Decision Rule | Decision rule applied to the input hypothesis. | | At least the spatial resolve rule must be present. | | ||
+ | |||
+ | {{ interimage: | ||
+ | |||
+ | ===== TerraAIDA C4.5 Classifier ===== | ||
+ | |||
+ | **Author** | ||
+ | |||
+ | Thales Sehn Korting, [[tkorting@dpi.inpe.br]]\\ | ||
+ | |||
+ | **Description** | ||
+ | |||
+ | Use C4.5 Decision Tree Algorithm to perform supervised classification into shapefiles with attributes and class description. | ||
+ | |||
+ | **Type** | ||
+ | |||
+ | Top-Down operator. | ||
+ | |||
+ | **Applies to** | ||
+ | |||
+ | Any node. | ||
+ | |||
+ | **Multi-Class support** | ||
+ | |||
+ | Yes. You must create the same number of classes as the training file. The classes must have also the same name of the training file. One of the nodes must have this operator, and all others should have "No Operator" | ||
+ | |||
+ | **Input parameters** | ||
+ | |||
+ | ^ Parameter Name ^ Type ^ Description | ||
+ | | a) Training Set File | * .shp | Training shape file name. | A valid shape file name. | The shapefile must be composed by polygons, their respective attributes and particularly one attribute called " | ||
+ | | b) Input Shape File | *.shp | Shape file name of the file to be classified. | A valid shape file name. | The shapefile must be composed by polygons, and the **same set of attributes** in the training shape file. | | ||
+ | |||
+ | Note: The generated decision tree will be placed in a //.txt// file, located in the **same place as your input shape file**, with the same name as your input file. | ||
+ | |||
+ | One example of this operator can be found [[interimage: | ||
===== TerraAIDA Checkerboard Segmenter ===== | ===== TerraAIDA Checkerboard Segmenter ===== | ||
Linha 111: | Linha 183: | ||
This operator creates a rectangular grid according to user defined resolution. | This operator creates a rectangular grid according to user defined resolution. | ||
- | Every rectangle will be a segment for the next nodes. | + | Every rectangle will be a segment for the child nodes. |
**Type** | **Type** | ||
Linha 128: | Linha 200: | ||
^ Parameter Name ^ Type ^ Description | ^ Parameter Name ^ Type ^ Description | ||
- | | Size of Cells | Integer | + | | Number |
- | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE regions format. | | | + | | Number of grid columns |
- | | Decision Rule | Decision rule | Decision rule applied in the generated hypothesis. | | Leave blank to accept all generated hypothesis. | + | |
| Node Weight | | Node Weight | ||
Linha 158: | Linha 229: | ||
**Multi-Class support** | **Multi-Class support** | ||
- | Yes. If you select //true// in the "Top Down Multi-Class" | + | Yes. If you select //true// in the "Top Down Multi-Class" |
[[interimage: | [[interimage: | ||
Linha 183: | Linha 254: | ||
| 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] | | | | 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] | | | ||
+ | | 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 ===== | ===== TerraAIDA Region Growing Segmenter ===== | ||
Linha 209: | Linha 281: | ||
** Reference** | ** Reference** | ||
- | * [[http:// | + | * [[http:// |
**Processing sequence** | **Processing sequence** | ||
Linha 222: | Linha 294: | ||
^ Parameter Name ^ Type ^ Description | ^ Parameter Name ^ Type ^ Description | ||
| Input Image | * .tif | Input image file name. | A valid image file name. | The image type must be supported by TerraLib. | | | Input Image | * .tif | Input image file name. | A valid image file name. | The image type must be supported by TerraLib. | | ||
- | | Euclidean Distance Threshold | Floating point | The minimum | + | | Euclidean Distance Threshold | Floating point | The minimum |
| Polygons Min Area | Integer | The generated polygons minimum area. | Greater than 0. | | | | Polygons Min Area | Integer | The generated polygons minimum area. | Greater than 0. | | | ||
| Use Optimization | Boolean | Divides, or not, the image into pieces and segment each piece individually. | yes/no | | | | Use Optimization | Boolean | Divides, or not, the image into pieces and segment each piece individually. | yes/no | | | ||
Linha 260: | Linha 332: | ||
**Notes** | **Notes** | ||
- | Shape files attributes with the the folowing | + | Shape file attributes with the the following |
+ | |||
+ | **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 | ||
+ | -Generate the output hypothesis. | ||
**Input parameters** | **Input parameters** | ||
Linha 267: | Linha 346: | ||
| Shape File Name | * .shp | Shape file name. | A valid shape file name. | The shapefile must be composed only by polygons, neither lines nor polylines. | | Shape File Name | * .shp | Shape file name. | A valid shape file name. | The shapefile must be composed only by polygons, neither lines nor polylines. | ||
| Shape File Attributes | String | A comma-separated list of shape file attributes names to be imported. | A valid attribute ID or empty field. | | Shape File Attributes | String | A comma-separated list of shape file attributes names to be imported. | A valid attribute ID or empty field. | ||
- | | Label Image Resolution | Floating point | The output label image resolution. | Positive real numbers or zero for automatic. | Choose a value good enough matching the resolution of the best used image. Leave blank and the system will automatically choose the resolution. The automatic method | + | | Label Image Resolution | Floating point | The output label image resolution. | Positive real numbers or zero for automatic. | Choose a value good enough matching the resolution of the best used image. Leave blank and the system will automatically choose the resolution. The automatic method can be used only if the operator |
- | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE | + | | Training Set File | *.shp | A file with training samples for supervised classification. | The file must be in the InterIMAGE |
| Decision Rule | Decision rule | Decision rule applied to the generated hypothesis. | | Decision Rule | Decision rule | Decision rule applied to the generated hypothesis. | ||
| Node Weight | | Node Weight | ||
Linha 295: | Linha 374: | ||
**Multi-Class support** | **Multi-Class support** | ||
- | Yes. If you select //true// in the "Top Down Multi-Class" | + | Yes. If you select //true// in the "Top Down Multi-Class" |
[[interimage: | [[interimage: | ||
+ | |||
+ | **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 " | ||
+ | -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** | ||
Linha 305: | Linha 392: | ||
| Shape Target Attribute ID | String | The name of the shape file attribute column used to filter what shape files polygons will be used. | A valid attribute ID. | Leave blank to use all shape file polygons. | | | Shape Target Attribute ID | String | The name of the shape file attribute column used to filter what shape files polygons will be used. | A valid attribute ID. | Leave blank to use all shape file polygons. | | ||
| Shape Target Attribute Value | String | The value, from the shape target attribute ID, which will define what polygons will be selected. | | Leave blank to use all shape file polygons. | | | Shape Target Attribute Value | String | The value, from the shape target attribute ID, which will define what polygons will be selected. | | Leave blank to use all shape file polygons. | | ||
- | | Label Image Resolution | Floating point | The output label image resolution. | Positive real numbers or zero for automatic. | Choose a value good enough matching the the resolution of the best used image. Leave blank and the system will automatically choose the resolution. The automatic method | + | | Label Image Resolution | Floating point | The output label image resolution. | Positive real numbers or zero for automatic. | Choose a value good enough matching the the resolution of the best used image. Leave blank and the system will automatically choose the resolution. The automatic method can be used only if the operator |
| 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). | | Node Weight | Floating point | This node weight (higher priority will be given to nodes with higher weights in cases where there are geographic overlays). | ||
+ | | 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 Bottom-Up Export ===== | ||
- | |||
- | **Author** | ||
- | |||
- | Emiliano Castejon, [[castejon@dpi.inpe.br]]\\ | ||
- | |||
- | **Description** | ||
- | |||
- | Allows to export the bottom-up hypothesis (including their attributes) to a shape file. This operator acts like the generic bottom-up operator by making a copy of every hypothesis to the shape file. No spatial conflict resolution is performed when there is no decision rule. | ||
- | |||
- | **Type** | ||
- | |||
- | Bottom-Up operator. | ||
- | |||
- | **Applies to** | ||
- | |||
- | Root (scene) and internal nodes. | ||
- | |||
- | **Multi-Class support** | ||
- | |||
- | No. | ||
- | |||
- | **Processing sequence** | ||
- | |||
- | -Read input hypothesis | ||
- | -Apply the user decision rule using the supplied training set. | ||
- | -Generate the output hypothesis | ||
- | -Generate the output shape file | ||
- | |||
- | **Input parameters** | ||
- | |||
- | ^ Parameter Name ^ Type ^ Description | ||
- | | Shape File Name | * .shp | Shape file name. | A valid shape file name. | The shapefile will be composed only by polygons and their respective attributes. | ||
- | | Decision Rule | Decision Rule | Decision rule applied to the input hypothesis. | | At least the spatial resolve rule must be present. | | ||
- | |||
- | {{ interimage: | ||
- | |||
- | ===== TerraAIDA C4.5 Classifier ===== | ||
- | |||
- | **Author** | ||
- | |||
- | Thales Sehn Korting, [[tkorting@dpi.inpe.br]]\\ | ||
- | |||
- | **Description** | ||
- | |||
- | Use C4.5 Decision Tree Algorithm to perform supervised classification into shapefiles with attributes and classes description. | ||
- | |||
- | **Type** | ||
- | |||
- | Top-Down operator. | ||
- | |||
- | **Applies to** | ||
- | |||
- | Any node. | ||
- | |||
- | **Multi-Class support** | ||
- | |||
- | Yes. You must create the same number of classes as the training file. The classes must have the same name of the training file also. One of the nodes must have this operator, and all others should have "No Operator" | ||
- | |||
- | **Input parameters** | ||
- | |||
- | ^ Parameter Name ^ Type ^ Description | ||
- | | a) Training Set File | * .shp | Training shape file name. | A valid shape file name. | The shapefile must be composed by polygons, their respective attributes and particularly one attribute called " | ||
- | | b) Input Shape File | *.shp | Shape file name of the file to be classified. | A valid shape file name. | The shapefile must be composed by polygons, and the *same set of attributes* in the training shape file. | | ||
- | |||
- | One example of this operator can be found [[interimage: |
interimage/operators_documentation.txt · Última modificação: 2016/08/05 14:44 por tkorting