Skip to main content

The PyExperimenter is a tool for the automatic execution of experiments, e.g. for machine learning (ML), capturing corresponding results in a unified manner in a database.

Project description

Project Homepage Pypi License DOI

Tests GitHub Pages

PyExperimenter Logo: Python biting a database

PyExperimenter

PyExperimenter is a tool to facilitate the setup, documentation, execution, and subsequent evaluation of results from an empirical study of algorithms and in particular is designed to reduce the involved manual effort significantly. It is intended to be used by researchers in the field of artificial intelligence, but is not limited to those.

The empirical analysis of algorithms is often accompanied by the execution of algorithms for different inputs and variants of the algorithms (specified via parameters) and the measurement of non-functional properties. Since the individual evaluations are usually independent, the evaluation can be performed in a distributed manner on an HPC system. However, setting up, documenting, and evaluating the results of such a study is often file-based. Usually, this requires extensive manual work to create configuration files for the inputs or to read and aggregate measured results from a report file. In addition, monitoring and restarting individual executions is tedious and time-consuming.

These challenges are addressed by PyExperimenter by means of a single well defined configuration file and a central database for managing massively parallel evaluations, as well as collecting and aggregating their results. Thereby, PyExperimenter alleviates the aforementioned overhead and allows experiment executions to be defined and monitored with ease.

General schema of PyExperimenter.

For more details check out the PyExperimenter documentation:

Cite PyExperimenter

If you use PyExperimenter in a scientific publication, we would appreciate a citation in one of the following ways.

Citation String

Tornede et al., (2023). PyExperimenter: Easily distribute experiments and track results. Journal of Open Source Software, 8(84), 5149, https://doi.org/10.21105/joss.05149

BibTex

@article{Tornede2023, 
    title = {{PyExperimenter}: Easily distribute experiments and track results}, 
    author = {Tanja Tornede and Alexander Tornede and Lukas Fehring and Lukas Gehring and Helena Graf and Jonas Hanselle and Felix Mohr and Marcel Wever}, 
    journal = {Journal of Open Source Software},
    publisher = {The Open Journal},  
    year = {2023}, 
    volume = {8}, 
    number = {84}, 
    pages = {5149}, 
    doi = {10.21105/joss.05149}, 
    url = {https://doi.org/10.21105/joss.05149}
}

Project details


Download files

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

Source Distribution

py_experimenter-1.4.2.tar.gz (23.0 kB view details)

Uploaded Source

Built Distribution

py_experimenter-1.4.2-py3-none-any.whl (25.9 kB view details)

Uploaded Python 3

File details

Details for the file py_experimenter-1.4.2.tar.gz.

File metadata

  • Download URL: py_experimenter-1.4.2.tar.gz
  • Upload date:
  • Size: 23.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.9.19 Darwin/23.5.0

File hashes

Hashes for py_experimenter-1.4.2.tar.gz
Algorithm Hash digest
SHA256 fd13314ac90fa36ed06468dff4a3427dfec85d25aed237a49b084bb79badeb47
MD5 8fb17cc60785e7c3e9b4a9cfc36d11c4
BLAKE2b-256 eeb39a3bf915d17d39d5f51cd028136a24debcdf6fa1317402e90253a201e9b1

See more details on using hashes here.

File details

Details for the file py_experimenter-1.4.2-py3-none-any.whl.

File metadata

  • Download URL: py_experimenter-1.4.2-py3-none-any.whl
  • Upload date:
  • Size: 25.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.9.19 Darwin/23.5.0

File hashes

Hashes for py_experimenter-1.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ba5f1b706e199c9d363285e1b9077ab68277fbfcb1dcfb19426a66af63b8260b
MD5 0791034db3424f2c7d16a5fe9e7caa43
BLAKE2b-256 2030f0f4098c5d21b34d93e5a3392c52b0e37d11c43b4173c9ccf8ad09dce249

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page