Skip to content

usnistgov/pfhub-cli

Repository files navigation

PFHub CLI

Overview

A Python module for both rendering and submitting PFHub phase-field benchmark results using Jupyter, Pandas and Plotly.

To view benchmark results go to the live website at pages.nist.gov/pfhub.

Installation

Using Pip

First install a Python environment manager such as Micromamba and ensure Pip is available. To install the PFHub CLI use,

$ pip install git+https://github.com/usnistgov/pfhub-cli.git

Using Nix

First install the Nix package manager and then enable Flakes. To install the PFHub CLI use,

$ nix shell github:usnistgov/pfhub-cli

for just the command line tool or

$ nix develop github:usnistgov/pfhub-cli

to generate an environment with Python and Jupyter available. See the Nix section of the development guide to get more help starting out with Nix.

Usage

Test

To test that the PFHub CLI is installed correctly use

$ pfhub test

A single test will fail if ZENODO_SANDBOX_API_TOKEN is not set, see the development guide.

Submit a benchmark result

Under construction.

Contributions

Contributions are welcome. See the development guide to get started.

License

See the NIST license

Cite

If you need to cite the PFHub CLI, please see CITATION.cff and cite it as follows:

Wheeler, D., Keller, T., DeWitt, S. J., Jokisaari, A. M., Schwen, D., Guyer, J. E., Aagesen, L. K., Heinonen, O. G., Tonks, M. R., Voorhees, P. W., Warren, J. A. (2019). PFHub: The Phase-Field Community Hub. Journal of Open Research Software, 7(1), 29. DOI: http://doi.org/10.5334/jors.276