Metadata-Version: 2.1
Name: watts
Version: 0.5.0
Summary: Workflow and Template Toolkit for Simulation
Author-email: "UChicago Argonne, LLC" <watts@anl.gov>
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: Jinja2
Requires-Dist: dill
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: platformdirs
Requires-Dist: prettytable
Requires-Dist: astropy
Requires-Dist: uncertainties
Requires-Dist: click
Requires-Dist: sphinx ; extra == "docs"
Requires-Dist: pydata_sphinx_theme ; extra == "docs"
Requires-Dist: sphinx_design ; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints ; extra == "docs"
Requires-Dist: pytest ; extra == "test"
Project-URL: Bug Tracker, https://github.com/watts-dev/watts/issues
Project-URL: Documentation, https://watts.readthedocs.io
Project-URL: Source Code, https://github.com/watts-dev/watts
Provides-Extra: docs
Provides-Extra: test

# <img valign="middle" src="https://raw.githubusercontent.com/watts-dev/watts/development/doc/source/_static/watts.svg" height="75" height="75" alt="WATTS logo"/> WATTS

[![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/licenses/MIT)
[![PyPI](https://img.shields.io/pypi/v/watts?label=PyPI)](https://pypi.org/project/watts/)
[![GitHub Actions build status (Linux)](https://github.com/watts-dev/watts/workflows/CI/badge.svg?branch=development)](https://github.com/watts-dev/watts/actions?query=workflow%3ACI)
[![DOI](https://joss.theoj.org/papers/10.21105/joss.04735/status.svg)](https://doi.org/10.21105/joss.04735)

WATTS (Workflow and Template Toolkit for Simulation) consists of a set of Python
classes that can manage simulation workflows for one or multiple codes. It
provides the following capabilities:

- An isolated execution environment when running a code;
- The ability to use placeholder values in input files that are filled in
  programmatically;
- Seamless unit conversions when working with multiple codes;
- A managed database that simulation inputs and outputs are automatically saved
  to; and
- Python classes that provide extra post-processing and analysis capabilities
  for each code.

## Installation

To install `watts`, run:

    python -m pip install watts

## Documentation

Documentation for WATTS can be found
[__here__](https://watts.readthedocs.io/en/latest/index.html).

## Citing

If you use WATTS in your research, please consider giving proper attribution by
citing the following publication:

- Paul K. Romano, Nicolas E. Stauff, Zhiee Jhia Ooi, Yinbin Miao, Amanda Lund,
  and Ling Zou, "WATTS: Workflow and template toolkit for simulation," *Journal
  of Open Source Software*, **7** (79), 4735 (2022).
  [doi:10.21105/joss.04735](https://doi.org/10.21105/joss.04735)

## Sponsors

WATTS is being developed with support from Argonne National Laboratory. For any
questions, please contact [watts@anl.gov](mailto:watts@anl.gov).

