Giter VIP home page Giter VIP logo

hippylib / hippylib2muq Goto Github PK

View Code? Open in Web Editor NEW
3.0 6.0 3.0 8.54 MB

Scalable Markov chain Monte Carlo Sampling Methods for Large-scale Bayesian Inverse Problems Governed by PDEs

Home Page: https://hippylib2muq.readthedocs.io

License: GNU General Public License v3.0

Dockerfile 0.18% Python 8.94% Jupyter Notebook 89.89% TeX 1.00%
baysian-inference inverse-problems pdes markov-chain-monte-carlo

hippylib2muq's Introduction

DOI Build Status Documentation Status

 _     ___ ____  ______   ___ _ _           __  __ _   _  ___  
| |__ |_ _|  _ \|  _ \ \ / / (_) |__       |  \/  | | | |/ _ \ 
| '_ \ | || |_) | |_) \ V /| | | '_ \ _____| |\/| | | | | | | |
| | | || ||  __/|  __/ | | | | | |_) |_____| |  | | |_| | |_| |
|_| |_|___|_|   |_|    |_| |_|_|_.__/      |_|  |_|\___/ \__\_\
                                                               

Scalable Markov chain Monte Carlo Sampling Methods for Large-scale Bayesian Inverse Problems Governed by PDEs

Overview

hIPPYlib-MUQ is a Python interface between two open source softwares, hIPPYlib and MUQ, which have complementary capabilities. hIPPYlib is an extensible software package aimed at solving deterministic and linearized Bayesian inverse problems governed by PDEs. MUQ is a collection of tools for solving uncertainty quantification problems. hIPPYlib-MUQ integrates these two libraries into a unique software framework, allowing users to implement the state-of-the-art Bayesian inversion algorithms in a seamless way.

To get started, we recommend to follow the interactive tutorial in tutorial folder, which provides step-by-step implementations by solving an example problem. A static version of the tutorial is also available here.

Installation

hIPPYlib-MUQ is the interface program between hIPPYlib and MUQ, which should be, of course, installed first.

We highly recommend to use our prebuilt Docker image, which is the easiest way to run hIPPYlib-MUQ. With Docker installed on your system, type:

docker run -ti --rm -p 8888:8888 ktkimyu/hippylib2muq 'jupyter-notebook --ip=0.0.0.0' 

The notebook will be available at the following address in your web-browser. From there you can run your own interactive notebooks or the tutorial notebook in tutorial folder.

See INSTALL for further details.

Documentation

A complete API documentation of hIPPYlib-MUQ is available here.

Authors

  • Ki-Tae Kim, University of California, Merced
  • Umberto Villa, Washington University in St. Louis
  • Matthew Parno, Dartmouth College
  • Noemi Petra, University of California, Merced
  • Youssef Marzouk, Massachusetts Institute of Technology
  • Omar Ghattas, The University of Texas at Austin

License

GPL3

hippylib2muq's People

Contributors

ktkimit avatar mparno avatar uvilla avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

hippylib2muq's Issues

More friendly documention

Please see how hippylib hippylib generate the documentation for a more user friendly webpage:

https://github.com/hippylib/hippylib/blob/master/doc/hippylib.rst

In particular:

  1. Show the content of README.md and INSTALL.md in the documentation
  2. It would be nice to have a static version of the notebook together with the documentation.

Also, documentation is now live at this address: https://hippylib.github.io/hippylib2muq/
It will be updated automatically everytime that you push to gh-pages branch.

Review installation instructions

I highly recommend to remove pip as a modality to install the software.

Since MUQ (and FEniCS) can not be pip installed, having a pip package is not that helpful.

In retrospective, it was an error to create pip packages for hippylib.

Also, please specify the dependecies versions for hippylib, muq, and fenics.

Do not hardcode version number in setup.py

Do not hardcode version numer in setup.py.

Instead, use the same construct that hippylib does to read the version number from hippylib/version.py.

Note: Also use 0.1.0 as version instead of 1.0.0. This will tell user that the API of the code is still fluid.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.