The HistFitter Group mailing-list, for any of your questions: [email protected]

HistFitter has 2 stable versions, one complient with Python2 (v0.66.0) and one with Python3 (v1.0.0). If you're going to be using HistFitter directly as a standalone application, clone the latest stable release

git clone https://github.com/histfitter/histfitter
git checkout vX.XX.X -b vX.XX.X

If you're using HistFitter as a submodule in a project, specify the latest stable release while adding the submodule

# Relative path gives nicer clones in CI if parent project on CERN's GitLab
git submodule add ../../HistFitter/HistFitter.git
cd HistFitter && git checkout vX.XX.X -b vX.XX.X && cd ..
git add HistFitter && git commit -m "Add HistFitter submodule"

Recommended Root version is 6.22.0

The environment can be set doing

source setup.sh

cd src
make
cd ..

• analysis: Contains all files related to an analysis. E.g. ZeroLepton/
• config: Contains HistFactory schema
• data: Contains data text files, provided externally, used to create workspaces for analysis
• doc: Documentation
• docs: Legacy tutorial (candidate for removal)
• examples: Example scripts that use the libraries in python/
• include: (not needed in version control and should be removed)
• lib: Location shared library
• macros: Macros for making plots, testing the fit, ongoing work, etc
• python: Python base classes
• results: Where root files with workspaces generated by HistFactory get stored
• scripts: Scripts for making workspaces based on text files in data/ . Scripts for submitting batch jobs.
• src: Source code to make workspaces, do toys.
• test: pytest tests

To contribute to development please first fork HistFitter and do all of your development on a feature branch that is not master. If you are planning on making feature changes please first open up an Issue and outline your plans so that development can be discusses with the maintainer team, streamlining the process as your MR is written.

When you make a MR, include a summary in the body of the MR of your changes that can be easily found and incorporated into Changelog for the next release.