Skip to content

intelligentEarth/Bayeslands

Repository files navigation

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.

About

An MCMC implementation of pyBadlands

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages