Skip to main content

A JAX-based statistical sampling toolkit

Project description

Jaxampler 🧪 - A JAX-based statistical sampling toolkit

Python package Upload Python Package CodeQL

PyPI version Versions

Jaxampler 🧪 is a statistical sampling toolkit built on top of JAX. It provides a set of high-performance sampling algorithms for a wide range of statistical distributions. Jaxampler is designed to be easy to use and integrate with existing JAX workflows. It is also designed to be extensible, allowing users to easily add new sampling algorithms and statistical distributions.

Jaxampler is currently in the early stages of development and is not yet ready for production use. However, we welcome contributions from the community to help us improve the library. If you are interested in contributing, please refer to our contribution guidelines.

Features

  • 🚀 High-Performance Sampling: Leverage the power of JAX for high-speed, accurate sampling.
  • 🧩 Versatile Algorithms: A wide range of sampling methods to suit various applications.
  • 🔗 Easy Integration: Seamlessly integrates with existing JAX workflows.

Install

You may install the latest released version of Jaxampler through pip by doing

pip3 install --upgrade jaxampler

You may install the bleeding edge version by cloning this repo, or doing

pip3 install --upgrade git+https://github.com/Qazalbash/jaxampler

If you would like to take advantage of CUDA, you will additionally need to install a specific version of JAX by doing

pip install --upgrade "jax[cuda12_pip]" -f https://storage.googleapis.com/jax-releases/jax_cuda_releases.html

Requirements

Jaxampler requires Python 3.10 or later. It also requires the following packages:

jax>=0.4.0 
jaxlib>=0.4.0
typing_extensions>=4.5.0
jaxtyping>=0.2.24
matplotlib>=3.8.0
tfp-nightly
tqdm

The test suite is based on pytest. To run the tests, one needs to install pytest and run pytest at the root directory of this repo.

Algorithms and Distributions

Jaxampler currently supports the following algorithms and distributions:

Monte Carlo Methods
  • Hamiltonian Monte Carlo
  • Importance Sampling
  • Metropolis Adjusted Langevin Algorithm
  • Monte Carlo Box Integration
  • Monte Carlo Integration
  • Multiple-Try Metropolis
  • Sequential Monte Carlo
  • Variational Inference
  • Wang-Landau Sampling
  • Worm Algorithm
Samplers

  • Accept-Rejection Sampler
  • Adaptive Accept-Rejection Sampler
  • Gibbs Sampler
  • Hastings Sampler
  • Inverse Transform Sampler
  • Metropolis-Hastings Sampler
  • Slice Sampler

Random Variables

  • Bernoulli
  • Beta
  • Binomial
  • Boltzmann
  • Cauchy
  • Chi
  • Exponential
  • Gamma
  • Geometric
  • Gumbel
  • Laplace
  • Log Normal
  • Logistic
  • Multivariate Normal
  • Normal
  • Pareto
  • Poisson
  • Rademacher
  • Rayleigh
  • Student t
  • Triangular
  • Truncated Normal
  • Truncated Power Law
  • Uniform
  • Weibull

Citing Jaxampler

To cite this repository:

@software{jaxampler2023github,
    author  = {Meesum Qazalbash},
    title   = {{Jaxampler}: A JAX-based statistical sampling toolkit},
    url     = {https://github.com/Qazalbash/jaxampler},
    version = {0.0.7},
    year    = {2023}
}

Contributors

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jaxampler-0.0.7.tar.gz (31.9 kB view hashes)

Uploaded Source

Built Distribution

jaxampler-0.0.7-py3-none-any.whl (73.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page