#diagram #bdd #syntax-tree #anf

bin+lib bex

A rust library for working with boolean expressions (syntax trees, decision diagrams, algebraic normal form, etc.)

8 releases

0.2.0 Apr 22, 2023
0.1.7 Mar 27, 2023
0.1.5 May 21, 2021
0.1.4 Jul 13, 2020
0.1.0 Nov 30, 2018

#890 in Algorithms

45 downloads per month

MIT license

675KB
9K SLoC

Rust 5K SLoC // 0.1% comments Vue 3.5K SLoC // 0.0% comments Python 146 SLoC // 0.4% comments Jupyter Notebooks 39 SLoC // 0.4% comments

bex : binary expression toolkit

Bex is a rust crate for working with binary (Boolean) expressions.

This crate lets you build a complicated abstract syntax tree (AST) by working with individual Bit structs, or vectors that act like integers.

You can also "solve" these AST structures by converting them into various canonical representations:

  • reduced, ordered, binary decision diagrams (ROBDDs) -- a normal form consisting of if-then-else triples that essentially act like compressed truth tables
  • algebraic nomal form -- an "xor of ands" polynomial form
  • (more coming in the future)

Video introduction

J and Bex vs Primorial 15 is about converting "simple" factoring problems into boolean expressions and solving them with bex.

It covers the large factoring problems in examples/solve/bdd-solve.rs and the smaller tests in src/solve.rs

Changes in 0.2.0

The main change here is that BddBase is now 100 times faster, or more, depending on your CPU count.

The BddSwarm structure has been heavily refactored, making use of the swarm module, and also extracting wip::WorkState for tracking dependencies between concurrent work-in-progress operations.

For full changelog, see CHANGELOG.md.

Dependencies

~2.7–9.5MB
~57K SLoC