interface with biteopt through a function decorator.
this still needs documentation, but `test_b2.py` is a good place to get started.