TerraLib and TerraView Wiki Page

You are here: start » wiki » tclt

Differences

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

--- wiki:tclt [2026/10/26 09:15]
castejon [Main features:]
+++ wiki:tclt [2026/10/27 10:22] (current)
castejon [Main features:]
@@ Line 14: / Line 14: @@
   * It's a Free Sofware !
   * No programming languages knowledge required !
-  * Support for command line based execution of one operation.
   * Support for script/project based execution (allows the creation of complex graph-based chains of execution using a multi-threaded environment).
   * Support for directory recursive processing.
+  * Support to query and process STAC server datasets (experimental).
   * Support to handle and process large remote sensing data sets.
   * Raster and vector data processing.
@@ Line 31: / Line 31: @@
 |CONTRAST|A vertice designed to perform raster data contrast enhancement.|Supported contrast types: LINEAR, HIST_EQ (Histogram Equalization), SQUARE, SQUARE_ROOT, LOG, MEAN_STD (The contrasted image will have a predefined mean and standard deviation normalization), DEC_ENH (Decorrelation Enhancement using principal components),2_PERC_CUT(Linear cumulative cutted in 2 - 98%)|
 |DATASET_CLASSIFIER|Generic data sets classifier vertice.| |
+|DESTRIPING|A vertice to perform destriping related algorithms over a set of raster data.| |
 |FILTER|A vertice to apply a series of well-known filtering algorithms for images, linear and non-linear.|Supported filters: SOBEL, ROBERTS, MEAN, MODE, MEDIAN, DILATION, EROSION.|
 |FUSION|A vertice to combine pixel information from different sensors to obtain better spatial or radiometric resolutions.|Supported methods: IHS - Fusion of 3 band low resolution raster with a high resolution raster, PCA - Fusion of a multispectral low resolution raster (no bands limit) with a high resolution raster|
 |GEODMA|A vertice to execute GeoDMA operations|GeoDMA is a toolbox for integrating remote sensing imagery analysis methods with data mining techniques producing a user-centered, extensible, rich computational environment for information extraction and knowledge discovery over large geographic databases. For more info click [[http://wiki.dpi.inpe.br/doku.php?id=geodma|here]].|
+|KERNELS_LOCATOR|Kernels (reference image patches) locator vertice.| |
 |LINK|A vertice to create a link/reference to the output of a vertice from another analysis within the same project.| |
 |MIXMODEL|A raster pixels mixer model vertice.|Supported model types: PCA(Principal Components Analysis), LINEAR.|
 |MOSAIC|A vertice to create a mosaic from a rasters set.|Virtual mosaic supported.|
 |MSC|A vertice to execute MSC (Mono or Multi-source classifier)|Reference:Sistema de classificação de imagens mono e multifontes baseado em distâncias estocásticas e testes de hipóteses associados. Michael Douglas Lemes dos Santos, Sidnei João Siqueira Sant'Anna. For more info about MSC - Click [[http://mtc-m21c.sid.inpe.br/rep/sid.inpe.br/mtc-m21c/2018/05.02.23.02?metadatarepository=sid.inpe.br/mtc-m21c/2018/05.02.23.02.06&ibiurl.backgroundlanguage=pt&ibiurl.requiredsite=mtc-m21c.sid.inpe.br+806&requiredmirror=urlib.net/www/2017/11.22.19.04.03&searchsite=bibdigital.sid.inpe.br:80&searchmirror=sid.inpe.br/bibdigital@80/2006/04.07.15.50.13&choice=briefTitleAuthor|here]]|
+|NOISE_FILTER|A noise filter vertice.| |
 |OUT_DEMUX|A vertice to demux the output of a input vertice result of type COLLECTION_TYPE (A collection of many outputs).| |
 |RASTERCLIPPING|A vertice to clip raster data.| |
 |RASTERTRANSFORM|A vertice to transform raster data.| |
 |RASTER_CLASSIFIER|A raster data classifier vertice.|Classifier methods: ISOSEG, MAP, ISODATA.|
+|RASTER_HARMONIZATION|Performs raster data assisted histogram harmonization.| |
+|RASTER_MASK|Creates raster masks following user supplied parameters and methods.| |
+|RASTER_RESTORATION|A vertice to apply raster restoration operation. The restoration operation compensates the degradation due the optics, detector and electronic filtering in the interpolation process. The image to be processed must be in the original resolution. For example Spot-X ( 20 m ), Spot-Pan ( 10 m ) and TM ( 30 m ). Filters and Resamples the input image in disk using a filter in the vertical and horizontal directions.| |
 |RASTER_SPLIT|A vertice to split one input raster into many output rasters.| |
 |RECOMPOSE|A vertice designed to compose one output raster using input rasters bands.| |
@@ Line 50: / Line 56: @@
 |SELECT|A vertice designed to copy only selected data from input to output.|Supported methods: statistical and local low-pass filter.|
 |STRIPING|A vertice to perform destriping related algorithms over a set of raster data.| |
+|STAC_SEARCH|A vertice to query and search a STAC server (experimental).| |
 |TERRAHIDRO|A vertice execute TerraHidro Operations.|Supported operations: CAVE_FLAT_AREAS_V_SHAPED-Finds and carves flat areas from a DEM input raster in a V-shaped format. PFS_PIT_REMOVAL-Remove all pits using the PFS algorithm to carve a path to an outlet cell. Generates a pitless DEM. SIMPLE_PIT_REMOVAL-Remove simple pits from a DEM(Simple pits are removing change the altimetria of just one cell). D8_FLOW-Generates the D8 flow directions from a pitless DEM (The output directions is valid only in column and row range from 2 cells of the DEM borders. D8_CONTRIB_AREA-Generates the drainage network grid from a contributing area grid (Each cell of the contributing area raster has the value of the contributing area of the cell.). D8_DRAINAGE-Generate the drainage raster lines from a contributing area raster. It is a threshold of contributing area. D8_HAND-Generates the drainage network grid from a contributing area grid. For more info about TerraHidro - Click [[http://www.dpi.inpe.br/terrahidro/doku.php|here]]|
 |TPLOCATOR|A vertice designed to find homologous tie-points inside raster areas.|Supported strategies: MORAVEC(Moravec Based Corner Detection. Reference: H. P. Moravec. Towards Automatic Visual Obstacle Avoidance), SURF(Speeded up robust features. Reference: Herbert Bay, Andreas Ess, Tinne Tuytelaars, and Luc Van Gool, Speeded Up Robust Features).|
@@ Line 56: / Line 63: @@
 |URI_EDIT|A vertice to edit a URI.| |
 |VECTORIZER|A vertice capable of vectorizing raster data.| |
+|VECTOR_PROCESSING|Vector processing vertice.| |
+|VEC_REGISTER|A vertice designed to perform vector data registering using a set of tie points.| |
+|VEC_TPLOCATOR|A vertice designed to find tie-points using vector data.| |
 |WATERDETECT|A vertice capable of detecting water on raster data.|Reference: WATER BODY EXTRACTION FROM RAPIDEYE IMAGES: AN AUTOMATED METHODOLOGY BASED ON HUE COMPONENT OF COLOR TRANSFORMATION FROM RGB TO HSV MODEL, Laercio Massaru Namikawa, Thales Sehn Körting, Emiliano Ferreira Castejon. Full Text - Click [[http://www.lsie.unb.br/rbc/index.php/rbc/article/view/1662|here]]|
 ===== News =====
+  * 10/27/2026 - New mosaic vertice options. New raster restoration vertice. New raster harmonization vertice. New TPLocator options. New register vertice options. New fusion vertice options. New STACURI vertice (experimental). New STAC batch execution mode (experimental). New mosaic vertice options. Added the project support to use VARIABLES. New script vertice options. Added the support tu use runtime vertice parameters. New noise filter vertice. New contrast vertice options. New raster mask vertice. New kernels locator vertice. Single operation execution mode removed.
   * 12/20/2024 - Fixing and updating vertices: vectorizer, fusion, mosaic, register.
   * 04/25/2024 - New contrast modes. New GRDB database tie-points locationg support. Now using a new Terralib version (5.7.1).
@@ Line 88: / Line 99: @@
 ===== Help =====
-==== How to list all options ====
+==== How to list all help options ====
 For a list of all available options run the executable file with the option “–help”. The executable must be called from a terminal window (Windows command prompt - CMD).
@@ Line 96: / Line 107: @@
 <code>
 tclt_exe.exe --help
-</code>
-==== Single operation execution - This mode allows the execution of one operation (vertice) on each call. ====
-Example: Apply a Mean segmentation (simple region growing) operation over an input image file named “image.tif” (located inside directory “c:\images”) and write the output inside the same directory.
-<code>
-tclt_exe.exe --processing_type="SEGMENTER" --input_uri="INPUT_RASTER;file://c:\image.tif" --processing_parameter="STRATEGY;MEAN" --output_directory="c:\images"
 </code>
@@ Line 120: / Line 123: @@
 A project file (project_example.txt):
 <code>
-# Add one or more context files to this project
-# Paths are relative to the project file location
+    # Add one or more context files to this project
-INCLUDE_FILE "context_example.txt"
+    # Paths are relative to the project file location
-# Add one or more graph files to this project
+    INCLUDE_FILE "context_example.txt"
-# Paths are relative to the project file location
-INCLUDE_FILE "graph_example.txt"
+    # Add one or more graph files to this project
-PROJECT_START
+    # Paths are relative to the project file location
-  # The global project name
+    INCLUDE_FILE "graph_example.txt"
-  # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
-  PROJECT_NAME "Sample_Project_Name_1"
+    PROJECT_START
-  # Add one or more analysis to be executed
+      # The global project name
-  # FORMAT: ANALYSIS "Analysys_Name" "Context_Name" "Graph_Name"
+      # Allowed characters : ._ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
-  ANALYSIS "Analysys_Name_1" "Context_Name_1" "Graph_Name_1"
+      PROJECT_NAME "Sample_Project_Name_1"
-PROJECT_END
+      # Add one or more analysis to be executed
+      # FORMAT: ANALYSIS "Analysys_Name" "Context_Name" "Graph_Name"
+      ANALYSIS "Analysys_Name_1" "Context_Name_1" "Graph_Name_1"
+    PROJECT_END
 </code>
-A context file (graph_example.txt):
+A context file (context_example.txt):
 <code>
-CONTEXT_START
+    CONTEXT_START
-  # This context name
+      # This context name
-  # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
+      # Allowed characters : ._ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
-  CONTEXT_NAME "Context_Name_1"
+      CONTEXT_NAME "Context_Name_1"
-  # Add one or more resouces to this context
-  # General Format: RESOURCE_URI "URI_alias" "URI string"
+      # Add one or more resouces to this context
-  #
+      # General Format : RESOURCE_URI "URI_alias" "URI string"
-  # Files Format: File paths are relative to the context file location.
+      #       # Files Format : File paths are relative to the context file location.
-  # Example: RESOURCE_URI "URI_alias" "file://../file_name.tif"
+      # Example : RESOURCE_URI "URI_alias" "file://../file_name.tif"
-  RESOURCE_URI "Raster1ContextAlias" "file://../rasters/cbers_rgb342_crop1.tif"
-CONTEXT_END
+      RESOURCE_URI "Raster1ContextAlias" "file://../rasters/cbers_rgb342_crop1.tif"
+      # Add one or more variables to this context
+      # General Format: VARIABLE "VariableName" "VariableValue"
+      #
+      # Example: VARIABLE "X" "1.98"
+      VARIABLE "ST" "0.3"
+    CONTEXT_END
 </code>
 A graph file (graph_example.txt):
 <code>
-GRAPH_START
+    GRAPH_START
-  # This graph name
+      # This graph name
-  # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
+      # Allowed characters: ._ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
-  GRAPH_NAME "Graph_Name_1"
+      GRAPH_NAME "Graph_Name_1"
-  # General vertice syntax:
-  #
+      # General vertice syntax:
-  #    VERTICE_START
+      #
-  #
+      #    VERTICE_START
-  #      # This vertice related class name
+      #
-  #      # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
+      #      # This vertice related class name
-  #      VERTICE_NAME "Vertice_name"
+      #      # Allowed characters: ._ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
-  #
+      #      VERTICE_NAME "Vertice_name"
-  #      # Vertice type
+      #
-  #      VERTICE_TYPE "VERTICETYPE"
+      #      # Vertice type
-  #
+      #      VERTICE_TYPE "VERTICETYPE"
-  #      # Vertice output cache enabled (YES/NO)
+      #
-  #      VERTICE_OUT_CACHE "NO"
+      #      # Vertice output cache enabled (YES/NO)
-  #      # Declares connections to other vertices outputs and gives them name aliases.
+      #      VERTICE_OUT_CACHE "NO"
-  #      # General format: VERTICE_CONNECTION "other_vertice_name" "connection alias"
+      #      # Declares connections to other vertices outputs and gives them name aliases.
-  #      VERTICE_CONNECTION "other_vertice_name_1" "connection alias 1"
+      #      # General format: VERTICE_CONNECTION "other_vertice_name" "connection alias"
-  #      VERTICE_CONNECTION "other_vertice_name_2" "connection alias 2"
+      #      VERTICE_CONNECTION "other_vertice_name_1" "connection alias 1"
-  #
+      #      VERTICE_CONNECTION "other_vertice_name_2" "connection alias 2"
-  #      # Declares a input URI resouce used by this vertice.
+      #
-  #      # General format: VERTICE_RESOURCE "context resource URI alias" "vertice URI alias"
+      #      # Declares a input URI resouce used by this vertice.
-  #      VERTICE_RESOURCE "raster resource 1" "image"
+      #      # General format: VERTICE_RESOURCE "context resource URI alias" "vertice URI alias"
-  #
+      #      VERTICE_RESOURCE "raster resource 1" "image"
-  #      # One or more specific vertice parameters
+      #
-  #      # General format: VERTICE_PARAM "parameter name" "parameter value"
+      #      # One or more specific vertice parameters
-  #      VERTICE_PARAM "parameter name 1" "parameter value 1"
+      #      # General format: VERTICE_PARAM "parameter name" "parameter value"
-  #      VERTICE_PARAM "parameter name 2" "parameter value 2"
+      #      VERTICE_PARAM "parameter name 1" "parameter value 1"
-  #
+      #      VERTICE_PARAM "parameter name 2" "parameter value 2"
-  #    VERTICE_END
+      #
-  VERTICE_START
+      #      # One or more specific vertice runtime parameters
-    VERTICE_NAME "Original_image_vertice"
+      #      # Runtime parameters are set at runtime and all
-    VERTICE_TYPE "URI"
+      #      # occurences of __RTVAR__{context_variable_name}__ will be replaced by
-    VERTICE_OUT_CACHE "NO"
+      #      # the related context variable value.
-    VERTICE_RESOURCE "Raster1ContextAlias" "URI_ALIAS"
+      #      # General format: VERTICE_RTPARAM "parameter name" "__RTVAR__{context_variable_name}__"
-  VERTICE_END
+      #      VERTICE_RTPARAM "parameter name 1" "__RTVAR__ST__"
-  VERTICE_START
+      #
-    VERTICE_NAME "Segmented_image"
+      #    VERTICE_END
-    VERTICE_TYPE "SEGMENTER"
-    VERTICE_OUT_CACHE "NO"
+      VERTICE_START
-    VERTICE_CONNECTION "Original_image_vertice" "INPUT_RASTER"
+        VERTICE_NAME "Original_image_vertice"
-    VERTICE_PARAM "STRATEGY" "MEAN"
+        VERTICE_TYPE "URI"
-    VERTICE_PARAM "MIN_SEGMENT_SIZE" "100"
+        VERTICE_OUT_CACHE "NO"
-    VERTICE_PARAM "SEGMENTS_SIMILARITY_THRESHOLD" "0.03"
+        VERTICE_RESOURCE "Raster1ContextAlias" "URI_ALIAS"
-  VERTICE_END
+      VERTICE_END
-GRAPH_END
+      VERTICE_START
+        VERTICE_NAME "Segmented_image"
+        VERTICE_TYPE "SEGMENTER"
+        VERTICE_OUT_CACHE "NO"
+        VERTICE_CONNECTION "Original_image_vertice" "INPUT_RASTER"
+        VERTICE_PARAM "STRATEGY" "MEAN"
+        VERTICE_PARAM "MIN_SEGMENT_SIZE" "100"
+        VERTICE_RTPARAM "SEGMENTS_SIMILARITY_THRESHOLD" "__RTVAR__ST__"
+      VERTICE_END
+    GRAPH_END
 </code>
@@ Line 217: / Line 243: @@
 <code>
 tclt_exe --project_file_name="project_example.txt" --output_directory="c:\images" --recursive_exec_dir="c:\my_input_images" --recursive_exec_context="Context_Name_1;Raster1ContextAlias" --recursive_exec_file_filters="+.tif;-.xml"
+</code>
+==== STAC batch execution (experimental) - This execution mode allows to process all data returned by a STAC server search. ====
+The same project will be executed for each returned asset URI and the result will be written on distinct output directories.
+On each execution a specific context/resource is replaced by a STAC asset URI.
+Example: To execute image segmentation on all STAC returned assets:
+<code>
+tclt_exe --project_file_name="project_example.txt" --output_directory="c:\images" --stac_exec_uri=="https://data.inpe.br/bdc/stac/v1/"
+--stac_exec_context="Context_Name_1;Raster1ContextAlias" --stac_exec_collid="CB4A-WPM-PCA-FUSED-1" --stac_exec_datetime="2025-01-01T00:
+:00Z/2026-01-01T00:00:00Z" --stac_exec_bbox="-53.898926;-25.522615;-42.758789;-19.456234" --stac_exec_assetid="tci"
 </code>
@@ Line 226: / Line 266: @@
 ^ Platform ^ Version ^ Date ^ Download Link ^ Notes ^
-|Windows (64 bits)|0.3.6 alpha develop|12/20/2024|[[@../download/download.php?FileName=tclt_0_3_6-alpha-develop.exe|Click here to download]]|Dependency: Visual Studio 2017 Runtime. This is a self-extracting executable. It must be uncompressed it into a directory. From that directory run “tclt_exe.exe” using the Windows Command Prompt (CMD). [[@../download/download.php?FileName=visual_studio_2017_14_14_26405_vcredist_x64.exe|Click here to download]]|
+|Windows (64 bits)|0.3.7 alpha develop|10/27/2026|[[@../download/download.php?FileName=tclt_0_3_7-alpha-develop_win64.exe|Click here to download]]|Dependency: Visual Studio 2017 Runtime. This is a self-extracting executable. It must be decompressed into a directory. From that directory run “tclt_exe.exe” using the Windows Command Prompt (CMD). [[@../download/download.php?FileName=visual_studio_2017_14_14_26405_vcredist_x64.exe|Click here to download]]|
+|Ubuntu 20.04.4 LTS|0.3.7 alpha develop|10/27/2026|[[@../download/download.php?FileName=tclt_0_3_7-alpha-develop_Ubuntu_20_04_4_LTS.tar.gz|Click here to download]]|This is a TAR GZ compressed file. It must be decompressed into a directory. From that directory run “./tclt_exe” using a terminal (bash).|
+|Windows (64 bits)|0.3.6 alpha develop|12/20/2024|[[@../download/download.php?FileName=tclt_0_3_6-alpha-develop_win64.exe|Click here to download]]|Dependency: Visual Studio 2017 Runtime. This is a self-extracting executable. It must be decompressed into a directory. From that directory run “tclt_exe.exe” using the Windows Command Prompt (CMD). [[@../download/download.php?FileName=visual_studio_2017_14_14_26405_vcredist_x64.exe|Click here to download]]|

Trace:

TerraLib and TerraView Wiki Page

Differences

Navigation

Search