Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
wiki:tclt [2025/01/31 16:17] castejon |
wiki:tclt [2025/03/14 08:04] (current) castejon |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== TCLT (TerraLib Command Line Tools) ====== | ====== TCLT (TerraLib Command Line Tools) ====== | ||
| + | {{ :wiki:tclt_graph.jpg?600 |}} | ||
| ===== About ===== | ===== About ===== | ||
| Line 134: | Line 135: | ||
| PROJECT_END | PROJECT_END | ||
| </code> | </code> | ||
| + | |||
| + | A context file (graph_example.txt): | ||
| + | <code> | ||
| + | CONTEXT_START | ||
| + | # This context name | ||
| + | # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 | ||
| + | CONTEXT_NAME "Context_Name_1" | ||
| + | # 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. | ||
| + | # Example: RESOURCE_URI "URI_alias" "file://../file_name.tif" | ||
| + | RESOURCE_URI "Raster1ContextAlias" "file://../rasters/cbers_rgb342_crop1.tif" | ||
| + | CONTEXT_END | ||
| + | </code> | ||
| + | |||
| + | A graph file (graph_example.txt): | ||
| + | <code> | ||
| + | GRAPH_START | ||
| + | # This graph name | ||
| + | # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 | ||
| + | GRAPH_NAME "Graph_Name_1" | ||
| + | # General vertice syntax: | ||
| + | # | ||
| + | # VERTICE_START | ||
| + | # | ||
| + | # # This vertice related class name | ||
| + | # # Allowed characters: _ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 | ||
| + | # VERTICE_NAME "Vertice_name" | ||
| + | # | ||
| + | # # Vertice type | ||
| + | # VERTICE_TYPE "VERTICETYPE" | ||
| + | # | ||
| + | # # Vertice output cache enabled (YES/NO) | ||
| + | # VERTICE_OUT_CACHE "NO" | ||
| + | # # Declares connections to other vertices outputs and gives them name aliases. | ||
| + | # # General format: VERTICE_CONNECTION "other_vertice_name" "connection alias" | ||
| + | # 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" | ||
| + | # VERTICE_RESOURCE "raster resource 1" "image" | ||
| + | # | ||
| + | # # One or more specific vertice parameters | ||
| + | # # General format: VERTICE_PARAM "parameter name" "parameter value" | ||
| + | # VERTICE_PARAM "parameter name 1" "parameter value 1" | ||
| + | # VERTICE_PARAM "parameter name 2" "parameter value 2" | ||
| + | # | ||
| + | # VERTICE_END | ||
| + | VERTICE_START | ||
| + | VERTICE_NAME "Original_image_vertice" | ||
| + | VERTICE_TYPE "URI" | ||
| + | VERTICE_OUT_CACHE "NO" | ||
| + | VERTICE_RESOURCE "Raster1ContextAlias" "URI_ALIAS" | ||
| + | VERTICE_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_PARAM "SEGMENTS_SIMILARITY_THRESHOLD" "0.03" | ||
| + | VERTICE_END | ||
| + | GRAPH_END | ||
| + | </code> | ||
| + | |||
| + | The following command must be executed in order to run the entire project and write the result to a directory “c:\images”: | ||
| + | <code> | ||
| + | tclt_exe.exe --project_file_name="project_example.txt" --output_directory="c:\images" | ||
| + | </code> | ||
| + | |||
| + | ==== Directory Recursive Execution - This execution mode allows to process all data within a given directory. ==== | ||
| + | |||
| + | The same project will be executed for each input data and the result will be written on distinct output directories. | ||
| + | |||
| + | On each execution a specific context/resource is replaced by a file URI from the given directory. | ||
| + | |||
| + | Example - To execute image segmentation on all files within a given directory, called “c:\my_input_images”, using the same project/context/graph files described above: | ||
| + | <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> | ||
| + | |||
| + | ===== Disclaimer of warranty ===== | ||
| + | |||
| + | //**You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or(at your option) any later version. The authors reassure the license terms regarding the warranties. They specifically disclaim any warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The software provided hereunder is on an “as is” basis, and the authors have no obligation to provide maintenance, support, updates, enhancements, or modifications.**// | ||
| + | |||
| + | ===== Download ===== | ||
| + | |||
| + | ^ 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]]| | ||
| + | |||
| + | |||
| + | ===== Author ===== | ||
| + | |||
| + | Emiliano F. Castejon | ||
| + | [[mailto:emiliano.castejon@inpe.br|E-mail]] | ||
| + | |||
