Skip to content

Latest commit

 

History

History
75 lines (51 loc) · 4.2 KB

README.md

File metadata and controls

75 lines (51 loc) · 4.2 KB
Raw

NeuralEstimators

CI codecov

NeuralEstimators facilitates the user-friendly development of neural point estimators, which are neural networks that map data to a point summary of the posterior distribution. These estimators are likelihood-free and amortised, in the sense that, after an initial setup cost, inference from observed data can be made in a fraction of the time required by conventional approaches. It also facilitates the construction of neural networks that approximate the likelihood-to-evidence ratio in an amortised fashion, which allows for making inference based on the likelihood function or the entire posterior distribution. The package caters for any model for which simulation is feasible by allowing the user to implicitly define their model via simulated data. See the documentation to get started!

Installation

To install the package, please:

  1. Install Julia.
  2. Install NeuralEstimators.jl:
    • To install the current stable version of the package, run the command using Pkg; Pkg.add("NeuralEstimators") inside Julia.
    • Alternatively, one may install the development version with the command using Pkg; Pkg.add(url="https://github.com/msainsburydale/NeuralEstimators.jl").

R interface

A convenient interface for R users is available on CRAN.

Supporting and citing

This software was developed as part of academic research. If you would like to support it, please star the repository. If you use it in your research or other activities, please also use the following citations.

@Manual{,
    title = {{NeuralEstimators}: Likelihood-Free Parameter Estimation
      using Neural Networks},
    author = {Matthew Sainsbury-Dale},
    year = {2024},
    note = {R package version 0.1-2},
    url = {https://CRAN.R-project.org/package=NeuralEstimators},
    doi = {10.32614/CRAN.package.NeuralEstimators},
  }

@Article{,
    title = {Likelihood-Free Parameter Estimation with Neural {B}ayes
      Estimators},
    author = {Matthew Sainsbury-Dale and Andrew Zammit-Mangion and
      Raphael Huser},
    journal = {The American Statistician},
    year = {2024},
    volume = {78},
    pages = {1--14},
    doi = {10.1080/00031305.2023.2249522},
  }

Contributing

If you find a bug or have a suggestion, please open an issue.

Papers using NeuralEstimators

  • Likelihood-free parameter estimation with neural Bayes estimators [paper] [code]

  • Neural Bayes estimators for censored inference with peaks-over-threshold models [paper]

  • Neural Bayes estimators for irregular spatial data using graph neural networks [paper][code]

  • Modern extreme value statistics for Utopian extremes [paper]

  • Neural Methods for Amortized Inference [paper][code]