Automatic Stream Pre-Processing, Selection of Knickzones, and optional calibration of knickzone selection parameters.
The theoretical background and application of this code has been described in: Neely, A., Bookhagen B., Burbank, D.W. (2017): An automated knickzone selection algorithm (KZ-Picker) to analyze transient landscapes: Calibration and validation, JGR Earth Surface, doi:10.1002/2017JF004250, available at: http://onlinelibrary.wiley.com/doi/10.1002/2017JF004250/full
Code developed by Al Neely (abn5031@psu.edu) and Bodo Bookhagen (bodo.bookhagen@uni-potsdam.de)
Latest update: 10-July-2017 (BB)
There are two subdirectories containing different Matlab codes with different purposes:
The directory KZ-Picker contains a straight-forward Matlab code to calibrate and select knickpoints as described in Neely et al., 2017 (http://onlinelibrary.wiley.com/doi/10.1002/2017JF004250/full). Only Matlab, Topotoolbox, and this code are required. Only Matlab, Topotoolbox and this code are required. This code is particularly useful for calibrating individual basins and identifying best-fit parameters.
See KZ-Picker/Readme.md for additional information.
A box diagram (PDF) shows how the code operates KZ-Picker/Examples/KZ-Picker_workflow.pdf.
Examples for this code are available in KZ-Picker/Examples.
The directory KZ-Topo-Picker contains a more extensive Matlab code that generates several figures, maps, plots, longitudinal river profiles, shapefiles and additional data. It performs an automatic channel-steepness analysis for all subbasins of a given size (parameter) based an log area-log slope plots and chi plots and calculate channel curvature and steepness and can be adapted to process large DEMs. However, this code requires installing addons (Topotoolbox, Ghostscript, GDAL, and scripts from Mathworks) to be fully functioning. This is intended for users with some experience in DEM processing and knowledge in Matlab. It generates high-resolution, editable PDF figures and longitudinal river profiles and knickpoint plots and mpas. This directory also contains some function that are still developed and improved, for example wind-gap and stream-capture detection algorithms.
Importantly, this Matlab code generates a set of geotif and shapefiles (if GDAL is installed) and allows to further analysis the results in a GIS. For example, vector files with normalized steepness indices (derived from slope-area and chi plots) as well as knickpoint locations are saved. Standard directories where data are save in are DEM_geotiff, DEM_shapefiles, and KZP_shapefiles.
See KZ-Topo-Picker/Readme.md for additional information.
Both codes run on Linux, Mac OSX, and Windows operating systems and have been tested with various versions of Matlab.
Examples for the KZ-Picker codes are available at KZ-Picker/Examples, including a PDF describing the steps to calibrate the data at KZ-Picker/Examples/KZ_picker_instructions_ABN_7-8-17.pdf.
Examples for the KZ-Topo-Picker codes are available at KZ-Topo-Picker/Examples, with a detailed PDF description in the works.