Model:TopoToolbox: Difference between revisions
m (Text replace - "|Categories" to "}} {{Model identity2 |Categories") |
m (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}") |
||
(33 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
|Model type=Tool | |Model type=Tool | ||
}} | }} | ||
{{Start models incorporated}} | |||
{{End a table}} | |||
{{Model identity2 | {{Model identity2 | ||
| | |ModelDomain=Terrestrial, Hydrology | ||
|Spatial dimensions=2D | |Spatial dimensions=2D | ||
|Spatialscale= | |Spatialscale=Landscape-Scale, Regional-Scale, Watershed-Scale | ||
|One-line model description=A set of Matlab functions for topographic analysis | |One-line model description=A set of Matlab functions for topographic analysis | ||
|Extended model description=TopoToolbox provides a set of Matlab functions that support the analysis of relief and flow pathways in digital elevation models. The major aim of TopoToolbox is to offer stable and efficient analytical GIS utilities in a non-GIS environment in order to support the simultaneous application of GIS-specific and other quantitative methods. | |Extended model description=TopoToolbox provides a set of Matlab functions that support the analysis of relief and flow pathways in digital elevation models. The major aim of TopoToolbox is to offer stable and efficient analytical GIS utilities in a non-GIS environment in order to support the simultaneous application of GIS-specific and other quantitative methods. With version 2, TopoToolbox adds various tools specifically targeted at tectonic geomorphologists such as Chiplots and slopearea plots. | ||
}} | }} | ||
{{Start model keyword table}} | {{Start model keyword table}} | ||
{{Model keywords | {{Model keywords | ||
|Model keywords=topographic analysis | |Model keywords=topographic analysis | ||
}} | |||
{{Model keywords | |||
|Model keywords=geomorphology | |||
}} | |||
{{Model keywords | |||
|Model keywords=geomorphometry | |||
}} | |||
{{Model keywords | |||
|Model keywords=Matlab | |||
}} | }} | ||
{{End a table}} | {{End a table}} | ||
Line 18: | Line 29: | ||
|Last name=Schwanghart | |Last name=Schwanghart | ||
|Type of contact=Model developer | |Type of contact=Model developer | ||
|Institute / Organization= | |Institute / Organization=Institute of Earth and Environmental Science | ||
|Town / City= | |Postal address 1=Geohazards | ||
|Postal code= | |Postal address 2=Karl-Liebknecht-Str. 24-25 | ||
|Town / City=Potsdam-Golm | |||
|Country= | |Postal code=14476 | ||
|Email address=w.schwanghart@ | |Country=Germany | ||
|Email address=w.schwanghart@geo.uni-potsdam.de | |||
}} | |||
{{Additional modeler information | |||
|Additional first name=Dirk | |||
|Additional last name=Scherler | |||
|Additional type of contact=Model developer | |||
}} | }} | ||
{{Model technical information | {{Model technical information | ||
Line 30: | Line 47: | ||
|Start year development=2008 | |Start year development=2008 | ||
|Does model development still take place?=Yes | |Does model development still take place?=Yes | ||
|DevelopmentCode=Active | |||
|DevelopmentCodeYearChecked=2020 | |||
|Model availability=As code | |Model availability=As code | ||
|Source code availability=Through CSDMS repository | |Source code availability=Through CSDMS repository | ||
|Source csdms web address=https://github.com/csdms-contrib/topotoolbox | |||
|Program license type=Other | |Program license type=Other | ||
|Program license type other=GNU version 2 or later | |Program license type other=GNU version 2 or later | ||
}} | }} | ||
{{Input - Output description | {{Input - Output description | ||
|Describe input parameters=ESRI ASCII digital elevation model | |Describe input parameters=GeoTiff, ESRI ASCII digital elevation model | ||
|Input format=ASCII | |Input format=ASCII, Binary | ||
|Describe output parameters=topographic derivatives (slope, curvature, flow accumulation, drainage basins), | |Describe output parameters=topographic derivatives (slope, curvature, flow accumulation, drainage basins), flow paths, chiplots, swath profiles, among others. | ||
|Output format=ASCII | |Output format=ASCII | ||
|Pre-processing software needed?=No | |Pre-processing software needed?=No | ||
Line 45: | Line 65: | ||
|If above answer is yes=Matlab | |If above answer is yes=Matlab | ||
}} | }} | ||
{{Process description model}} | {{Process description model | ||
|Describe processes represented by the model=The TopoToolbox 2 is a Matlab based software for Digital Elevation Model (DEM) analysis. It uses an object oriented programming (OOP) approach to represent and work with geoferenced raster data, flow directions, stream networks and swath profiles in Matlab. TopoToolbox offers a wide range of tools to analyse DEMs, flow and stream networks, that allow for interactive and automated workflows. | |||
|Describe key physical parameters and equations=none | |||
|Describe length scale and resolution constraints=All spatial data should be provided as projected, georeferenced (e.g., UTM) grids or shapefiles where spatial units are given in meters. Data referenced in a geographic coordinate system will return unexpected results. | |||
|Describe time scale and resolution constraints=none | |||
|Describe any numerical limitations and issues=In general, Matlab stores all data in the main memory. Manageable grid size will depend on your available RAM. For conveniently working with grids with ~5000x5000 rows and columns, a 4Gb of RAM will likely be sufficient. | |||
}} | |||
{{Model testing}} | {{Model testing}} | ||
{{Users groups model | {{Users groups model | ||
Line 51: | Line 77: | ||
}} | }} | ||
{{Documentation model | {{Documentation model | ||
|Manual model available=Yes | |Manual model available=Yes | ||
|Model | |Model manual=Usersguide 1 intro.pdf, Usersguide 2 mfd.pdf, Usersguide 3 ksn.pdf, | ||
}} | }} | ||
{{Additional comments model}} | {{Additional comments model}} | ||
{{CSDMS staff part | {{CSDMS staff part | ||
|OpenMI compliant=No but possible | |OpenMI compliant=No but possible | ||
|IRF interface=No but possible | |||
|CMT component=No but possible | |||
|CCA component=No but possible | |CCA component=No but possible | ||
| | }} | ||
| | {{DOI information | ||
|DOI model=10.1594/IEDA/100175 | |||
|DOI assigned to model version=1.0.4 | |||
|DOI-year assigned to model version=2011 | |||
|DOI-filelink=https://csdms.colorado.edu/pub/models/doi-source-code/topotoolbox-10.1594.IEDA.100175-1.0.4.tar.gz | |||
}} | }} | ||
{{Start coupled table}} | {{Start coupled table}} | ||
{{End a table}} | {{End a table}} | ||
{{End headertab}} | {{End headertab}} | ||
{{{{PAGENAME}}_autokeywords}} | |||
<!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE --> | <!-- PLEASE USE THE "EDIT WITH FORM" BUTTON TO EDIT ABOVE CONTENTS; CONTINUE TO EDIT BELOW THIS LINE --> | ||
==Introduction== | ==Introduction== | ||
Line 77: | Line 107: | ||
See the readme file in the distribution. | See the readme file in the distribution. | ||
== | == References == | ||
<br>{{AddReferenceUploadButtons}}<br><br> | |||
{{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br> | |||
{{Include_featured_references_models_cargo}}<br> | |||
== Issues == | == Issues == | ||
Line 84: | Line 116: | ||
== Help == | == Help == | ||
There | There are a couple of short documents (userguide_xxx.m) including html-files in the distribution. Each function contains a comprehensive help section with syntax explanations and examples. For additional help, tipps and tricks, and news, please read my blog at http://topotoolbox.wordpress.com/ | ||
== Input Files == | == Input Files == | ||
There is a example file included in the distribution. | There is a example file included in the distribution (srtm_bigtujunga30m_utm11.tif). Your own data should have the ESRI ArcGIS ASCII raster or Geotiff format and can be read using the function GRIDobj. | ||
== Output Files == | == Output Files == | ||
Output can be written as ESRI ArcGIS ASCII raster format | Output can be written as ESRI ArcGIS ASCII raster and Geotiff format. | ||
'''License notice''' | '''License notice''' |
Latest revision as of 20:18, 16 September 2020
TopoToolbox
Metadata
|
|
Introduction
TopoToolbox provides a set of Matlab functions that support the analysis of relief and flow pathways in digital elevation models. The major aim of TopoToolbox is to offer stable and efficient analytical GIS utilities in a non-GIS environment in order to support the simultaneous application of GIS-specific and other quantitative methods.
History
See the readme file in the distribution.
References
Nr. of publications: | 31 |
Total citations: | 1279 |
h-index: | 12 |
m-quotient: | 0.86 |
Featured publication(s) | Year | Model described | Type of Reference | Citations |
---|---|---|---|---|
Schwanghart, Wolfgang; Kuhn, Nikolaus J.; 2010. TopoToolbox: A set of Matlab functions for topographic analysis. Environmental Modelling & Software, 25, 770–781. 10.1016/j.envsoft.2009.12.002 (View/edit entry) | 2010 | TopoToolbox |
Model overview | 280 |
Schwanghart, W.; Scherler, D.; 2014. Short Communication: TopoToolbox 2 – MATLAB-based software for topographic analysis and modeling in Earth surface sciences. Earth Surface Dynamics, 2, 1–7. 10.5194/esurf-2-1-2014 (View/edit entry) | 2014 | TopoToolbox |
Model overview | 551 |
See more publications of TopoToolbox |
Issues
TopoToolbox is optimized for small data sets (grid size less than 2000 columns x 2000 rows, depending on your available main memory). This short-coming is due to various issues. First of all, Matlab loads all variables in the main memory and does not work on a file basis (such as ArcGIS for example does). Second, Matlab performs best for double precision data and sparse matrix operations currently only support for double precision data. Hence, all variables are stored as double precision, which requires large memory. 64-bit computers may overcome many of these weaknesses.
Help
There are a couple of short documents (userguide_xxx.m) including html-files in the distribution. Each function contains a comprehensive help section with syntax explanations and examples. For additional help, tipps and tricks, and news, please read my blog at http://topotoolbox.wordpress.com/
Input Files
There is a example file included in the distribution (srtm_bigtujunga30m_utm11.tif). Your own data should have the ESRI ArcGIS ASCII raster or Geotiff format and can be read using the function GRIDobj.
Output Files
Output can be written as ESRI ArcGIS ASCII raster and Geotiff format.
License notice
This program is free software; 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.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.