HF Explorer is a web based viewer for high energy particle physics that allows users to view various types of plots from data formatted as HistFactory workspaces.
If you are working with HistFactory formatted data, HF Explorer provides an easy-to-use and convenient way to generate plots, perform fits, and to investigate the impact of various parameters on the model performance.
This application depends upon the following utilities which will need to be installed before you can run it:
Flask is a Python framework that is used for the back end web services.
pip install Flask
- pyhf:
pyhf is a Python utility that is used to read and manage HistFactory data in JSON format.
python -m pip install pyhf
Cabinetry is a Python utility that is used to perform parameter fits.
python -m pip install cabinetry
- jq:
Jq is a command line utility for managing JSON patch files.
brew install jq
The application configuration is managed by the file: services/config.py. To configure the application for the first time:
- cd services
- Copy config.template.py to config.py.
- Fill in the indicated fields in config.py with your desired values (optional).
For more information about configuration, see services/README.md
After you have configured the server, you can start it with the following command:
python3 app.py
After starting the server, to run the application, open your web browser to:
http://localhost:5000
View the Help page for details of how to use the application.
Distributed under the permissive MIT license. See the license for more information.
This software was created by the American Family Insurance Data Science Institute at the University of Wisconsin-Madison under a grant from IRIS Hep