MiLoMerge Documentation

Overview

This documentation is provided to assist in the usage of the MiLoMerge package for “Minimal Loss Merging”. The MiLoMerge package is designed to provide an interface for merging bins together such that the loss in separability between N distributions is minimized.

MiLoMerge is based off of Maximizing Returns: Optimizing Experimental Observables at the LHC, which is currently available on ArXiv.

Relevant URLs

The homepage for MiLoMerge is located at the JHUGen website, with the GitHub available as well. Both are linked in the footer of each page.

There is also a PyPi page available.

Installation

You can install MiLoMerge with pip, conda, or directly from the homepage.

pip install MiLoMerge

wget https://spin.pha.jhu.edu/Merger/<version>.tar.gz
tar -xzf <version>.tar.gz
cd MiLoMerge
pip install .

Papers and Talks

Papers

Talks

Citing MiLoMerge

If using the MiLoMerge package, please cite the papers listed in the section above.

Frequently Asked Questions

Where should I go if I encounter a bug?

Please raise an issue on Github and/or contact the authors at MiLoMerge@lists.johnshopkins.edu with your bug.

Is there a paper about this stuff?

Yes! The initial paper, which includes examples for how the package can be used, as well as the basis for the metric used, can be found on ArXiv.

Where has this package been used?

So far, the MiLoMerge package has been used in some particle physics analyses on CMS for the Higgs Boson and B-Physics.