Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
start [2024/01/01 22:44] alexandre [Download] |
start [2025/02/28 15:07] (current) henrique [Contact] |
||
---|---|---|---|
Line 4: | Line 4: | ||
* Last stable release:\\ | * Last stable release:\\ | ||
- | - Windows (01/01/2024): [[http://www.dpi.inpe.br/terrahidro/download/TerraHidro-5.2.0.exe|TerraHidro-5.2.0.exe]]\\ | + | - Windows (19/02/2025): https://drive.google.com/drive/folders/13N77EyJcHiL1u6audwLgqXoTl1mJD-bG?usp=drive_link\\ |
- | - Linux (10/05/2023): [[http://www.dpi.inpe.br/terrahidro/download/terrahidro-5.2.0.tar.gz|terrahidro-5.2.0.tar.gz]] | + | |
Add the path to the TerraHidro directory into the PATH variable. After this step, the TerraHidro system can be executed by typing **th** in a terminal.\\ | Add the path to the TerraHidro directory into the PATH variable. After this step, the TerraHidro system can be executed by typing **th** in a terminal.\\ | ||
- Windows: Settings, type Edit System Variables, System Variables, select Path, Edit, New, copy path to the TerraHidro directory (e.g. //C:\TerraHidro-5.2.0//).\\ | - Windows: Settings, type Edit System Variables, System Variables, select Path, Edit, New, copy path to the TerraHidro directory (e.g. //C:\TerraHidro-5.2.0//).\\ | ||
- | - Linux: extract the file terrahidro-5.2.0.tar.gz using "//tar -zxvf terrahidro-5.2.0.tar.gz//" under /home/user, where //user// is the username; open a terminal, export PATH=/home/user/terrahidro-5.2.0/bin:$PATH, export TERRALIB_HOME=/home/user/terrahidro-5.2.0, export LD_LIBRARY_PATH=/home/user/terrahidro-5.2.0/lib:$LD_LIBRARY_PATH. In order to permanently set the variables PATH, TERRALIB_HOME, and LD_LIBRARY_PATH, these variables must be modified in the resources file under the /home/user directory (e.g. .bashrc). | ||
- | |||
- | Note: The Linux version was compiled on a Fedora Core 36 that had all the necessary packages installed. The Terralib library has many dependencies, which must be solved to avoid any problems. The main packages (version) used for the compilation were: gcc/stdc++ (12.2.1), glibc (2.35), qt5 (5.15.8), boost (1.76), proj (8.2.1), geos (3.10.2), gdal (3.4.3), sqlite (3.36), tiff (4.4), geotiff (1.7.1), X11 (1.7.3). Please, solve any dependencies before executing TerraHidro on Linux. | ||
* Input data for examples (lower Tocantins region known as Acará-Guamá):\\ | * Input data for examples (lower Tocantins region known as Acará-Guamá):\\ | ||
Line 314: | Line 310: | ||
* inputDrainage.tif - input drainage network (raster). | * inputDrainage.tif - input drainage network (raster). | ||
* outputSAND.tif - output Slope Above Nearest Drainage (raster). | * outputSAND.tif - output Slope Above Nearest Drainage (raster). | ||
+ | **gfplain** - Generates the floodplain and water height grids from a DEM grid, a D8 flow directions grid, a contributing area grid, a drainage network grid, and parameters of power law h=a*A^b. | ||
+ | <code> | ||
+ | th gfplain inputDEM.tif inputD8.tif inputContributingArea.tif inputDrainage.tif inputA inputB outputFloodplain.tif outputWaterHeight.tif | ||
+ | </code> | ||
+ | * inputDEM.tif - input DEM (raster). | ||
+ | * inputD8.tif - input D8 flow directions (raster). | ||
+ | * inputContributingArea.tif - input contributing area (raster). | ||
+ | * inputDrainage.tif - input drainage network (raster). | ||
+ | * inputA - parameter a of power law. | ||
+ | * inputB - parameter b of power law. | ||
+ | * outputFloodplain.tif - output floodplain delineated from water heights on drainage network (raster). | ||
+ | * outputWaterHeight.tif - output water height computed from contributed area with power law (raster). | ||
**segments** - Generates the segments from a D8 flow directions grid and a drainage network grid. | **segments** - Generates the segments from a D8 flow directions grid and a drainage network grid. | ||
<code> | <code> | ||
Line 361: | Line 369: | ||
* inputSources.shp - input drainage source points to initiate flow paths (vector). | * inputSources.shp - input drainage source points to initiate flow paths (vector). | ||
* outputFlowPaths.tif - output flow paths that follow the D8 flow directions from each drainage source point (raster). | * outputFlowPaths.tif - output flow paths that follow the D8 flow directions from each drainage source point (raster). | ||
+ | **watercourses** - Generates water courses from contributing areas. | ||
+ | <code> | ||
+ | th watercourses inputD8upstream.tif inputContributingArea.tif outputWaterCourses.tif | ||
+ | </code> | ||
+ | * inputD8upstream.tif - input D8 upstream flow directions (raster). | ||
+ | * inputContributingArea.tif - input contributing area (raster). | ||
+ | * outputWaterCourses.tif - output water courses formed upstream by following the largest contributing areas (raster). | ||
+ | **damcourse** - Generates water courses from dam breaks given dam points, subbasins of Q5 specific discharges, D8 flow directions grid, and contributing area grid, limiting length from either only Qpeak/Q5 ratio or also height and volume of dam (input data with projection of units in meters). | ||
+ | <code> | ||
+ | th damcourse inputDams.shp inputQ5Subbasins.shp inputD8.tif inputContributingArea.tif Q5LENGTH|HVLENGTH outputDams.shp outputWaterCourses.shp | ||
+ | </code> | ||
+ | * inputDams.shp - input points of dams (vector) with attributes: id (int64), height (double), volume (double), Qpeak (double, -1.0 to use equation), equationQpeak (int32, 0 = FROEHLICH / 1 = FERLA). | ||
+ | * inputQ5Subbasins.shp - input polygons of specific Q5 discharge (vector) with attribute: Q5_m3sKm2 (real). | ||
+ | * inputD8.tif - input D8 flow directions (raster). | ||
+ | * inputContributingArea.tif - input contributing area (raster). | ||
+ | * Q5LENGTH|HVLENGTH - parameter to limit length of water course from either only peak and specific discharges (Qpeak and Q5) or also height and volume of dam. | ||
+ | * outputDams.shp - output points of dams (vector) with new attribute of peak discharge from equation: calcQpeak (double). | ||
+ | * outputWaterCourses.shp - output water courses (vector). | ||
+ | **damsections** - Generates sections on water courses from dam breaks given water courses, number and length of sections (input data with projection of units in meters). | ||
+ | <code> | ||
+ | th damsections inputWaterCourses.shp SECTIONS LENGTH outputSections.shp | ||
+ | </code> | ||
+ | * inputWaterCourses.shp - input water courses (vector). | ||
+ | * SECTIONS - number of sections. | ||
+ | * LENGTH - length of sections. | ||
+ | * outputSections.shp - output sections (vector). | ||
+ | **dambreak** - Generates water course basin, water height, floodplain, water flow velocity, and hydrodynamic hazard from breaking of dams (input data with projection of units in meters). | ||
+ | <code> | ||
+ | th dambreak inputDams.shp inputWaterCourses.shp inputSections.shp inputDEM.tif inputD8.tif inputD8Upstream.tif inputContributingArea.tif inputManning MSANA1|MSANA2 outputDirectory outputSections.shp outputWaterCourseSegments.shp outputWaterCourseBasin.tif outputWaterHeight.tif outputFloodplain.tif outputVelocity.tif outputHydrodynamicHazard.tif | ||
+ | </code> | ||
+ | * inputDams.shp - input points of dams (vector) with attributes: id (int64), height (double), volume (double), Qpeak (double, -1.0 to use equation), equationQpeak (int32, 0 = FROEHLICH / 1 = FERLA). | ||
+ | * inputWaterCourses.shp - input water courses (vector). | ||
+ | * inputSections.shp - input sections (vector). | ||
+ | * inputDEM.tif - input DEM (raster). | ||
+ | * inputD8.tif - input D8 flow directions (raster). | ||
+ | * inputD8upstream.tif - input D8 upstream flow directions (raster). | ||
+ | * inputContributingArea.tif - input contributing area (raster). | ||
+ | * inputManning - input Manning coefficient. | ||
+ | * MSANA1|MSANA2 - input parameter for method of decaying discharges. | ||
+ | * outputDirectory - output directory for output files (raster for output variables, dambasin for cropping of output variables, and profiles with text files for output information of water course and sections). | ||
+ | * outputSections.shp - output sections (vector) with new attributes relative to water course point: DEM elevation, cross section wetted area, discharge, water height, water level, water flow velocity, and hydrodynamic hazard. | ||
+ | * outputWaterCourseSegments.shp - output water course segments (vector) traced between sections with attributes: coordinates and elevation of initial/end points, length, slope, discharge, water height, water level, water flow velocity, and hydrodynamic hazard | ||
+ | * outputWaterCourseBasin.tif - output basin of water course (raster). | ||
+ | * outputWaterHeight.tif - output water height (raster). | ||
+ | * outputFloodplain.tif - output floodplain (raster). | ||
+ | * outputVelocity.tif - output water flow velocity (raster). | ||
+ | * outputHydrodynamicHazard.tif - output hydrodynamic hazard (raster). | ||
**fill** - Fills voids of a DEM data (e.g. SRTM 30 m) using a reference DEM data (e.g. SRTM 90 m). | **fill** - Fills voids of a DEM data (e.g. SRTM 30 m) using a reference DEM data (e.g. SRTM 90 m). | ||
<code> | <code> | ||
Line 459: | Line 514: | ||
===== Contact ===== | ===== Contact ===== | ||
- | Write to the TerraHidro Team at <henrique.renno@inpe.br> (developer) or <sergio.rosim@inpe.br> (manager). | + | Write to the TerraHidro Team at <sergio.rosim@inpe.br> (manager). |
===== Previous Version ===== | ===== Previous Version ===== | ||