Metadata-Version: 2.4
Name: enb
Version: 1.1.0
Summary: enb (Experiment NoteBook): enb is a python library/framework to design, run and analyze computer-based experiments. Persistence, parallelization and plotting can be automatically handled by enb, to help you develop efficient and reproducible science.
Home-page: https://github.com/miguelinux314/experiment-notebook
Download-URL: https://github.com/miguelinux314/experiment-notebook/archive/v1.1.0.tar.gz
Author: Miguel Hernández Cabronero, et al.
Author-email: miguel.hernandez@uab.cat
License: MIT License
Platform: any
Classifier: Programming Language :: Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Natural Language :: English
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: appdirs
Requires-Dist: astropy
Requires-Dist: deprecation
Requires-Dist: h5py
Requires-Dist: imageio
Requires-Dist: jinja2>=3.1.2
Requires-Dist: matplotlib
Requires-Dist: natsort
Requires-Dist: numpngw
Requires-Dist: numpy<2
Requires-Dist: pandas>=2.1.0
Requires-Dist: pathos
Requires-Dist: pdf2image
Requires-Dist: psutil
Requires-Dist: requests
Requires-Dist: rich
Requires-Dist: scipy
Requires-Dist: sortedcontainers
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Experiment Notebook (`enb`)

The `enb` Python (>= 3.7) library is a table-based framework designed to define, run and report computer-based
experiments.

- Your can create and run any type of (computer-based) experiment. Quickly.
- You can analyze and plot results produced with your enb experiments. Clearly. You can also reuse previously existing
  data (e.g., in CSV format).
- You can easily create reproducible, redistributable software to be shared with others, e.g., as supplementary
  materials in your publication or project.
- It runs on Linux, Windows and MacOS, in parallel. You can use clusters of Linux or MacOS computers.

## Quick start

The latest stable version of `enb` is available via pip, e.g.,

    pip install enb

You can use this library in your python scripts by adding:

    import enb

Several project demos and templates for your experiments are provided with enb. For a list of documentation templates,
you can run:

    enb plugin list documentation

For example, you can try the distributed (although not really accurate)
[pi approximation project](https://github.com/miguelinux314/experiment-notebook/blob/dev/enb/plugins/template_montecarlo_pi/montecarlo_pi_experiment.py):

    enb plugin install montecarlo-pi ./mp
    ./mp/montecarlo_pi_experiment.py

Or check out the most basic working examples with
the [basic workflow example](https://github.com/miguelinux314/experiment-notebook/blob/dev/enb/plugins/template_basic_workflow_example/basic_workflow.py)

    enb plugin install basic-workflow ./bw
    ./bw/basic_workflow.py

## Resources

- A tutorial-like **user manual** is available at https://miguelinux314.github.io/experiment-notebook.

- You can browse
  the [detailed installation instructions](https://miguelinux314.github.io/experiment-notebook/installation.html).

- A [gallery of plots](https://miguelinux314.github.io/experiment-notebook/analyzing_data.html)
  produced (semi-)automatically produced from enb experiment results and from external CSV files is also available.

- Please refer to the [changelog](https://github.com/miguelinux314/experiment-notebook/blob/master/CHANGELOG.md)
  for the main differences between consecutive `enb` versions.


    
