Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bagnalla/zar
Formally Verified Samplers From Probabilistic Programs With Loops and Conditioning
https://github.com/bagnalla/zar
compiler coq formal-verification probabilistic-programming sampling
Last synced: 27 days ago
JSON representation
Formally Verified Samplers From Probabilistic Programs With Loops and Conditioning
- Host: GitHub
- URL: https://github.com/bagnalla/zar
- Owner: bagnalla
- License: mit
- Created: 2022-11-11T20:18:56.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-23T07:00:45.000Z (9 months ago)
- Last Synced: 2024-03-23T11:22:26.563Z (8 months ago)
- Topics: compiler, coq, formal-verification, probabilistic-programming, sampling
- Language: Coq
- Homepage: https://arxiv.org/abs/2211.06747
- Size: 14.4 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zar
Paper: https://arxiv.org/abs/2211.06747
## Setup
* Coq development:
```
opam pin add coq 8.16.0
opam repo add coq-released https://coq.inria.fr/opam/released
opam install coq-itree
make -j4
```
* [Zarpy](https://pypi.org/project/zarpy/) Python3 package (see [python/zar/test/test.py](python/zar/test/test.py) for an example
of using it after installation):
```
opam install pythonlib ppx_import ppx_deriving
cd python/zar/ocaml
dune build zarpy.so
cd ..
make install
```
* Extracted sampler analysis scripts (e.g., [analyze.py](extract/geometric/analyze.py)):
```
pip install numpy==1.24.2 scipy==1.10.1 tensorflow==2.11.0 optas==1.0.3
```
## Foundational
* Axioms: [axioms.v](axioms.v)
* Extended reals: [eR.v](eR.v)
* Tactics: [tactics.v](tactics.v)
## cpGCL and cwp
* cpGCL syntax: [cpGCL.v](cpGCL.v)
* cwp semantics: [cwp.v](cwp.v)
## CF Trees
* CF trees: [tree.v](tree.v), [tcwp.v](tcwp.v), [tcwp_facts.v](tcwp_facts.v)
* Compiler from cpGCL to CF trees: [compile.v](compile.v), [cwp_tcwp.v](cwp_tcwp.v)
* De-biasing: [uniform.v](uniform.v), [debias.v](debias.v)
## Generating Interaction Trees
* Generating itrees: [itree.v](itree.v)
## Order/Domain Theory and Algebraic Coinductives
* Basic order theory: [order.v](order.v)
* CPOs: [cpo.v](cpo.v)
* Algebraic CPOs and continuous extensions: [aCPO.v](aCPO.v)
* Cotrees: [cotree.v](cotree.v), [cocwp.v](cocwp.v), [cocwp_facts.v](cocwp_facts.v)
## Sampling Equidistribution Theorems
* Equidistribution theorems for itrees, cotrees, CF trees, and cpGCL: [equidistribution.v](equidistribution.v)
## Empirical Validation
[extract/](extract/) contains driver code and scripts for evaluating extracted samplers (e.g., [dueling coins](dueling_coins.v), [n-sided die](./die.v), [geometric distribution](geometric.v), [discrete gaussian](gaussian.v), [hare and tortoise](hare.v)).
[fast-loaded-dice-roller/](fast-loaded-dice-roller/) contains a clone of [https://github.com/probcomp/fast-loaded-dice-roller](https://github.com/probcomp/fast-loaded-dice-roller) modified to track entropy usage.
[optimal-approximate-sampling/](optimal-approximate-sampling/) contains a clone of [https://github.com/probcomp/optimal-approximate-sampling](https://github.com/probcomp/optimal-approximate-sampling) modified to track entropy usage.
[python/zar/](python/zar/) contains the [Zarpy](https://pypi.org/project/zarpy/) Python3 package source.
[python/tf/](python/tf/) contains the TensorFlow 2 project, with [batch_gen.py](python/tf/batch_gen.py) implementing a sampling-without-replacement generator on top of the [Zarpy](https://pypi.org/project/zarpy/) sampler package.