SweetPea
| Build Status |
|---|
 |
 |
 |
 |
SweetPea is a domain-specific language for specifying factorial experimental designs and synthesizing trial sequences from those design specifications. An explanation of factorial experimental designs and how to build and manipulate them in SweetPea can be found in the SweetPea Guide.
See also the paper describing SweetPea, but beware that the API has changed. The main changes are replacing most functions with classes, changing some function names, and simplifying the organization to just a
sweetpeamodule that exports everything.
SweetPea includes a synthesizer to generate sequences of trials that satisfy the design's constraints. The goal is to generate sequences that are unbiased: every possible sequence of trials that satifies the design constraints is equally likely to be generated, which avoids correlations that are not part of the experiment's definition. With current technologies, SweetPea achieves that goal for designs with either simple constraints or a small number of combinations. SweetPea can also generate samples that seem uniform in practice for medium-sized designs, although without a formal guarantee. Generating unbiased samples for large designs remains an area of active research and development.
For designs that do not involve constraints that span trials within a sequence, SweetPea can directly sample with combinatoric techniques. Realistic designs often involve transition constraints or other cross-trial constraints, however. For those cases, SweetPea's primary sampling strategy compiles an experiment design into a boolean formula; compilation ensures a 1-to-1 correspondence between distinct satisfying assignments to the boolean formula and distinct trial sequences, so that uniformly sampling solutions to the boolean formula imples a unform sample of trial sequences. SweetPea uses CMSGen and UniGen to sample solutions to the boolean formula. CMSGen generates samples that appear to be well distributed in practice, but CMSGen lacks a formal guarantee of uniformity. UniGen provides statistical guarantees that the solutions it finds are approximately uniformly probable, but its approach is tractable only for the smallest designs that are expressed with SweetPea.
Dependencies
SweetPea requires Python 3.9 or later.
Installation
There are two ways to install SweetPea: from the Python Package Index (PyPI), or from source.
Installing from PyPI
SweetPea can be installed from PyPI via pip:
$ pip install sweetpea
Installing from Source
Clone this repository, install SweetPea's dependencies, and install SweetPea itself:
$ git clone https://github.com/sweetpea-org/sweetpea-py.git
$ cd sweetpea-py
$ pip install -r requirements.txt
$ pip install .
❗ Important!
The
pip install .command installs SweetPea locally, but it will not automatically check for updates. If you intend to manually update your local copy of SweetPea, you should instead dopip install -e .to tellpipto use the source dynamically.
Examples
There are example programs in the example_programs
directory, and there is a detailed explanation of how to use SweetPea in the
SweetPea Guide.
API Documentation
The SweetPea API is documented in the API section of the SweetPea Guide.
Contributing
Information on how to contribute to SweetPea's development can be found in the Contributing section of the SweetPea Guide.
3 maintainers
Metadata
3 maintainers
Release files for sweetpea 0.2.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sweetpea-0.2.14.tar.gz | 157.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sweetpea-0.2.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 360.1 kB
Release files / sweetpea-0.2.14.tar.gz
| Download URL | sweetpea-0.2.14.tar.gz |
|---|---|
| Size | 157.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
50e1b6a7e19cab6ba98a9a3c0d8daff38f94eeaf7639ae7d216285ee564612fe
|
|
BLAKE2b-256 checksum How to use checksums |
21cd6c09b16ad16308f8709c4e69b5fc21b3ff5a59a581bf9cd36177e5fc6782
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.6
|
Release files / sweetpea-0.2.14-py3-none-any.whl
| Download URL | sweetpea-0.2.14-py3-none-any.whl |
|---|---|
| Size | 202.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c951914ce9ac48f9d5a95c6b998eb4b37cf2d329fdfc47e52f29f12aa3225b7b
|
|
BLAKE2b-256 checksum How to use checksums |
b1ae1abb8ff705297154a116d39dd82cdfeb172acfa451920e58cf580fe48a73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.6
|
