manifold_lifting
Accompanying code for 'Manifold lifting: scaling MCMC to the vanishing noise regime'
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 7 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org, zenodo.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.2%) to scientific vocabulary
Keywords
Repository
Accompanying code for 'Manifold lifting: scaling MCMC to the vanishing noise regime'
Basic Info
- Host: GitHub
- Owner: thiery-lab
- Language: Jupyter Notebook
- Default Branch: main
- Homepage: https://arxiv.org/abs/2003.03950
- Size: 6.18 MB
Statistics
- Stars: 7
- Watchers: 4
- Forks: 0
- Open Issues: 1
- Releases: 2
Topics
Metadata Files
README.md
Manifold lifting: scaling Markov chain Monte Carlo to the vanishing noise regime
Code accompanying the paper Manifold lifting: scaling Markov chain Monte Carlo to the vanishing noise regime.
Abstract: Standard Markov chain Monte Carlo methods struggle to explore distributions that concentrate in the neighbourhood of low-dimensional submanifolds. This pathology naturally occurs in Bayesian inference settings when there is a high signal-to-noise ratio in the observational data but the model is inherently over-parametrised or non-identifiable. In this paper, we propose a strategy that transforms the original sampling problem into the task of exploring a distribution supported on a manifold embedded in a higher-dimensional space; in contrast to the original posterior this lifted distribution remains diffuse in the limit of vanishing observation noise. We employ a constrained Hamiltonian Monte Carlo method, which exploits the geometry of this lifted distribution, to perform efficient approximate inference. We demonstrate in numerical experiments that, contrarily to competing approaches, the sampling efficiency of our proposed methodology does not degenerate as the target distribution to be explored concentrates near low-dimensional submanifolds.
Installation
The mlift package requires Python 3.9 or above. To install the mlift package and its dependencies into an existing Python environment run
bash
pip install git+https://github.com/thiery-lab/manifold_lifting.git
The mlift.pde module and associated example model in mlift.example_models.poisson additionally require FEniCS (v2019.10) and scikit-sparse to be installed. Note that the fenics metapackage on PyPI does not install the required binary dependencies and so FEniCS should instead be separately installed by following one of the methods listed in the project's installation instructions.
Alternatively a conda environment man-lift containing the required dependencies to run all of the experiments (including the mlift package) can be created from the provided environment.yml file by running
bash
conda env create -f environment.yml
Experiment scripts
A number of scripts for reproducing the numerical experiments used to produce the figures in the paper are provided in the scripts directory. To run these scripts the mlift package and its dependencies need to be installed in a local Python 3.9+ environment as described above. The default settings of the scripts assume they are run from the top-level directory of a clone of the repository. Pass a --help argument to any of the scripts to see a description of what the script does and the available environment variables for configuring the behaviour of the script.
Example notebook
For a complete example of applying the method described in the paper to perform inference in a two-dimensional example and accompanying explanatory notes see the Jupyter notebook linked below. The manifold MCMC methods in the Python package Mici are used for inference.
| Open non-interactive version with nbviewer |
|
| Open interactive version with Binder |
|
| Open interactive version with Google Colab |
|
Citation
To cite the paper the following bibtex entry can be used
bibtex
@article{au2023manifold,
author = {Au, Khai Xiang and Graham, Matthew M and Thiery, Alexandre H},
title = "{Manifold lifting: scaling Markov chain Monte Carlo to the vanishing noise regime}",
journal = {Journal of the Royal Statistical Society Series B: Statistical Methodology},
volume = {85},
number = {3},
pages = {757-782},
year = {2023},
month = {04},
issn = {1369-7412},
doi = {10.1093/jrsssb/qkad023},
url = {https://doi.org/10.1093/jrsssb/qkad023},
eprint = {https://academic.oup.com/jrsssb/article-pdf/85/3/757/50859790/qkad023.pdf},
}
Owner
- Name: Thiery lab
- Login: thiery-lab
- Kind: organization
- Location: Singapore
- Website: http://www.normalesup.org/~athiery/people.html
- Repositories: 5
- Profile: https://github.com/thiery-lab
Research group @ NUS DSAP
Citation (CITATION.cff)
cff-version: 1.2.0 message: "If you use this software, please cite it as below." type: software authors: - family-names: "Au" given-names: "Khai Xiang" - family-names: "Graham" given-names: "Matthew M." orcid: "https://orcid.org/0000-0001-9104-7960" - family-names: "Thiery" given-names: "Alexandre" title: "Manifold lifting: scaling Markov chain Monte Carlo to the vanishing noise regime" doi: 10.5281/zenodo.6551654 url: "https://github.com/thiery-lab/manifold_lifting" license: MIT
GitHub Events
Total
Last Year
Issues and Pull Requests
Last synced: almost 2 years ago
All Time
- Total issues: 2
- Total pull requests: 1
- Average time to close issues: about 1 year
- Average time to close pull requests: about 1 year
- Total issue authors: 1
- Total pull request authors: 1
- Average comments per issue: 0.0
- Average comments per pull request: 6.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- matt-graham (2)
Pull Request Authors
- matt-graham (1)
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- arviz >=0.11
- jax >=0.2.11
- jaxlib >=0.1.65
- matplotlib >=3.1
- mici >=0.1.10
- multiprocess >=0.70
- numpy >=1.20
- scipy >=1.5
- symnum >=0.1.2
- sympy >=1.7
- arviz 0.16.1.*
- fenics-dolfin 2019.1.0.*
- jax 0.4.14.*
- matplotlib 3.7.2.*
- multiprocess 0.70.15.*
- numpy 1.25.2.*
- pip 23.2.1.*
- python 3.11.*
- scikit-sparse 0.4.12.*
- scipy 1.11.1.*
- sympy 1.12.*