Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Author and execute multiverse analysis

Project description

boba

Author and visualize multiverse analysis with ease.

Boba has a domain specific language (Boba DSL) for writing multiverse specifications, and a visual analysis interface (Boba Visualizer) for exploring multiverse outcomes. Boba comes with a command line tool to parse your DSL specification and generate universe scripts, execute all scripts with a single command, merges outputs into a table, and invoke the visualizer.

  • works with both python and R, and other scripting languages to come
  • handles simple parameter substitution as well as complex code flow dependency
  • offers interactive visualizations for exploring consequential decisions, uncertainty, model fit, and more
https://badge.fury.io/py/boba.svg https://travis-ci.org/uwdata/boba.svg?branch=master https://img.shields.io/badge/License-BSD%203--Clause-blue.svg https://img.shields.io/pypi/pyversions/boba

Installation

You might download and install the latest version of this software from the Python package index (PyPI):

pip install --upgrade boba

Usage

To author your multiverse, please refer to the specification rules. Here is a simple example to get you started!

To parse your specification and generate actual scripts, invoke boba and pass in the path to your template script and your JSON spec:

boba compile --script template.py

To execute the multiverse, namely running all the generated scripts, use:

boba run --all

To start the Boba Visualizer after getting the intermediate output files, use:

boba-server

For more command line options, see CLI. For more information about the Boba Visualizer, see this project.

Examples

Citation

If you are interested in this work, please see our research paper and consider citing our work:

@misc{liu2020boba,
  title={Boba: Authoring and visualizing multiverse analyses},
  author={Yang Liu and Alex Kale and Tim Althoff and Jeffrey Heer},
  year={2020},
  eprint={2007.05551},
  archivePrefix={arXiv},
  primaryClass={cs.HC}
}

History

1.1.0 (2020-10-07)

  • Add support for arbitrary language
  • Various bug fixes

1.0.0 (2020-07-31)

  • Support continuous placeholder variable
  • Support running the multiverse across multiple processes
  • Improve boba run, such that it is not dependent on the OS
  • Various bug fixes
  • Integrate boba visualizer

0.1.4 (2020-04-19)

  • Combine JSON spec with the template
  • Support inline definition for placeholder variables
  • Support inline constraint at block declaration
  • Support linked decisions
  • Infer ADG from specification
  • Update examples
  • Various bug fixes

0.1.3 (2019-11-30)

  • Revise authoring syntax to support decision blocks and constraints
  • Revise CLI, with separate commands to compile and to run
  • Improve execution
  • Add the hurricane example

0.1.2 (2019-09-19)

  • Fix bugs

0.1.1 (2019-09-19)

  • Support R
  • Improve CLI options
  • Support a built-in variable {{_n}}, which represents the universe number
  • Support “before_execute” and “after_execute” hooks in the JSON spec
  • Update examples

0.1.0 (2019-08-26)

  • First release on PyPI.

Project details


Download files

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

Files for boba, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size boba-1.1.0-py3-none-any.whl (31.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size boba-1.1.0.tar.gz (35.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page