boba 0.1.3

Author and execute multiverse analysis

boba

Author and execute multiverse analysis with ease.

Boba is a simple domain specific language for specifying multiverse analysis. It comes with a command line tool to parse your specification and generate universe scripts, allows you to execute all scripts with a single command, and wrangles outputs into a single table.

• works with both python and R

• handles simple parameter substitution as well as complex code flow dependency

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 -- json spec.json

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

boba run --all

For more command line options, see CLI.

Examples

• A simple example to walk you through the basics

• A more complex example using Steegen’s multiverse analysis and Durante’s fertility dataset.

• Another multiverse example, based on the specification curve paper by Simonsohn et al.

History

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.