Pystematic is a lightweight framework that helps you to systematically setup and run reproducible computational experiments in python.
Main features:
Standardizes how experiments and associated parameters are defined.
Provides both CLI and programmatic interfaces for running your experiments.
Encourages reproducibility by isolating experiment outputs and providing tools for managing random seeds.
Quickstart
Installation
pystematic is available on pypi, and can be installed with your package manager of choice.
If using poetry:
$ poetry add pystematicor with pip:
$ pip install pystematicDefining and running experiments
Experiments and parameters are defined by decorating the main function of the experiment. The following example defines an experiment named hello_world with a single parameter name:
import pystematic as ps
@ps.parameter(
name="name",
help="The name to greet.",
)
@ps.experiment
def hello_world(params):
print(f"Hello {params['name']}!")You can run the experiment either by supplying a dict containing the values for the parameters:
hello_world.run({
"name": "World",
})or you can run the experiment from the command line by invoking the cli() method of the experiment:
if __name__ == "__main__":
hello_world.cli()Then from the terminal you simply run:
$ python path/to/file.py --name "World"Documentation
Full documentation is available at https://pystematic.readthedocs.io.
Extensions
For running machine learning experiments in pytorch check out the pystematic-torch plugin.
1 maintainer
Metadata
1 maintainer
Release files for pystematic 1.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pystematic-1.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / pystematic-1.7.0-py3-none-any.whl
| Download URL | pystematic-1.7.0-py3-none-any.whl |
|---|---|
| Size | 25.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b27952d1bf101eec4597e98a29cf5e26b0948eb6c5a97d2a0e7450eebda4a626
|
|
BLAKE2b-256 checksum How to use checksums |
55495c52603d1d5ded9130ccf2cb679a3eb404c19edae2ef559d09eba4bd6542
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.12.11 Linux/6.11.0-1015-azure
|
