Public Repository

Last pushed: a year ago
Short Description
Badlands companion image for pre and post processing models
Full Description

Badlands companion

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

Contents

Structure

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.

Pre-processing

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

Post-processing

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

Stratigraphic analyses

TODO

Github repository

http://github.com/badlands-model/pyBadlands-Companion
http://github.com/badlands-model

Docker information

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'
Docker Pull Command
Owner
badlandsmodel

Comments (0)