digital-experiments 2.0.1

Keep track of digital experiments.

A lightweight python package for recording and analysing configurations and results of coding experiments.

Installation

pip install digital-experiments

Basic Use

1. Define your experiment as a pure-python function, and decorate it with @experiment:

from digital_experiments import experiment

@experiment
def my_experiment(a, b=2):
    return a ** b

2. Call the function as normal:

>>> my_experiment(2, 3)
8
>>> my_experiment(4)
16

3. Access the results of the experiment:

>>> my_experiment.observations()
[Observation(<id1>, {'a': 2, 'b': 3} → 8}),
Observation(<id2>, {'a': 4, 'b': 2} → 16})]

If you have pandas installed, you can also access these results as a DataFrame:

>>> my_experiment.to_dataframe()
      id  config.a  config.b  result
0  <id1>         2         3       8
1  <id2>         4         2      16

Documentation

For more information, see the documentation.