The companion contains a series of IPython notebooks to perform post and pre-processing tasks useful to run and analyse Badlands model.
(c) University of Sydney, 2016
Each post and pre-processing notebook is associated with a Python file. We have chosen this structure to give you the transparency and opportunity to:
- clearly understand the creation and format of Badlands input file,
- perform some basic quantitative analyses of Badlands output file,
- easily design your own notebook and further improve this workflow.
If you have any suggestions or if you would like to share your own Badlands template with others, feel free to contact us, we will be happy to integrate your own workflow here.
The pre-processing notebooks will help you to create:
- surface grids for generic (simple geometrical model) and real (based on etopo1) topographic/bathymetric dataset,
- sea level fluctuations file (using Haq curve or building your own one) to look at the impact of sea-level change on landscape dynamics,
- horizontal (uplift/subsidence) displacement maps to study landscape response to tectonic forces.
- regridding script for refining intial input file
Morpho & Hydrometrics analyses
Morphometrics refers to quantitative description and analysis of the produced Badlands landforms which could be applied to a particular kind of landform or to drainage basins and large regions. The following suite of geomorphic attributes could be extracted:
- gradient: magnitude of maximum gradient
- horizontal curvature describes convergent or divergent fluxes
- vertical curvature: positive values describe convex profile curvature, negative values concave profile.
- aspect: direction of maximum gradient
- discharge: it relates to the drainage area
Hydrometrics refers to quantitative description and analysis of water surface. We will show how you can extract a particular catchment from a given model and compute for this particular catchment a series of paramters such as:
- river profile evolution based on main stream elevation and distance to outlet,
- Peclet number distribution which evaluates the dominant processes shaping the landscape,
- Chi parameter that characterizes rivers system evolution based on terrain steepness and the arrangement of tributaries,
- discharge profiles along the main catchment river
The sync doesn't work that well with automated builds but this is approximately what the Dockerfile looks like. See Github for details.
bash FROM badlandsmodel/badlands-toolbase:latest MAINTAINER Tristan Salles RUN DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \ python-imaging # Get debian base install and some unnecessary files, copy local data to workspace RUN mkdir /workspace && \ mkdir /workspace/volume # Get material from github RUN echo "!!!" && git clone https://github.com/badlands-model/pyBadlands-Companion.git /tools/ && \ mv /tools/* /workspace # expose notebook port EXPOSE 8888 # setup space for working in VOLUME /workspace/volume # launch notebook WORKDIR /workspace EXPOSE 8888 ENTRYPOINT ["/usr/local/bin/tini", "--"] CMD jupyter notebook --ip=0.0.0.0 --no-browser \ --NotebookApp.default_url='/tree/StartHere.ipynb'