Model:TopoToolbox: Difference between revisions
Wschwanghart (talk | contribs) |
m (Text replacement - "{{End headertab}}" to "{{End headertab}} {{{{PAGENAME}}_autokeywords}}") |
||
(20 intermediate revisions by the same user not shown) | |||
Line 5: | Line 5: | ||
{{End a table}} | {{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. With version 2, TopoToolbox adds various tools specifically targeted at tectonic geomorphologists such as Chiplots and slopearea plots. | |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}} | ||
Line 34: | Line 34: | ||
|Town / City=Potsdam-Golm | |Town / City=Potsdam-Golm | ||
|Postal code=14476 | |Postal code=14476 | ||
|Country=Germany | |Country=Germany | ||
|Email address=w.schwanghart@geo.uni-potsdam.de | |Email address=w.schwanghart@geo.uni-potsdam.de | ||
Line 46: | Line 45: | ||
|Supported platforms=Unix, Linux, Mac OS, Windows | |Supported platforms=Unix, Linux, Mac OS, Windows | ||
|Programming language=Matlab | |Programming language=Matlab | ||
|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 web address= | |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 | ||
Line 65: | Line 61: | ||
|Output format=ASCII | |Output format=ASCII | ||
|Pre-processing software needed?=No | |Pre-processing software needed?=No | ||
|Post-processing software needed?=No | |Post-processing software needed?=No | ||
|Visualization software needed?=Yes | |Visualization software needed?=Yes | ||
|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 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 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 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 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. | |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 | ||
|Do you have current or future plans for collaborating with other researchers?=I am always looking for people interested in improving and enhancing TopoToolbox. | |Do you have current or future plans for collaborating with other researchers?=I am always looking for people interested in improving and enhancing TopoToolbox. | ||
}} | }} | ||
{{Documentation model | {{Documentation model | ||
|Manual model available=Yes | |Manual model available=Yes | ||
|Model manual=Usersguide 1 intro.pdf, Usersguide 2 mfd.pdf, Usersguide 3 ksn.pdf, | |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 information | ||
Line 97: | Line 91: | ||
|DOI assigned to model version=1.0.4 | |DOI assigned to model version=1.0.4 | ||
|DOI-year assigned to model version=2011 | |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 113: | Line 108: | ||
== References == | == References == | ||
{{ | <br>{{AddReferenceUploadButtons}}<br><br> | ||
{{ | {{#ifexist:Template:{{PAGENAME}}-citation-indices|{{{{PAGENAME}}-citation-indices}}|}}<br> | ||
{{Include_featured_references_models_cargo}}<br> | |||
== Issues == | == Issues == |
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.