Skip to content
Mohammad Danial Azam edited this page May 3, 2018 · 3 revisions

BayesLands - An MCMC implementation of pyBadlands

flowchart mcmc

DOI

Overview

BayesLands, a Bayesian framework for Badlands that fuses information obtained from complex forward models with observational data and prior knowledge. As a proof-of-concept, we consider a synthetic and real-world topography with two free parameters, namely precipitation and erodibility, that we need to estimate through BayesLands. The results of the experiments shows that BayesLands yields a promising distribution of the parameters. Moreover, the challenge in sampling due to multi-modality is presented through visualizing a likelihood surface that has a range of suboptimal modes.

Badlands overview - Basin Genesis Hub presentation (2017)

Usage Instructions

Installation:

  • Git clone https://github.com/badlands-model/BayesLands.git

  • Stepwise instructions to install BayesLands and it's prerequisite python packages are provided in the installation.txt file.

  • bl_mcmc.py - File that executes an mcmc chain.

  • bl_preproc - File includes functions to crop rescale or edit input topographies to be used in the model.

  • bl_postproc - File used to produce figures for posterior distributions of the free parameters and time variant erosion deposition.

  • bl_surflikl - File used to generate the likelihood surface of the free parameters.

  • bl_topogenr - File used to generate the input and final-time topography used by the mcmc file.

Sample Output

etopo basemap
etopo initial etopo final
likl surface crater
rain posterior erod posterior

Community driven

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 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 Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/lgpl-3.0.en.html.

Reporting

If you come accross a bug or if you need some help compiling or using the code you can drop us a line at: - [email protected] - [email protected]

Documentation related to Badlands physics & assumptions

Other published research studies using Badlands:

When you use Badlands or BayesLands, please cite the above papers.