Interfaces and Integrations

Uhepp has been integrated into multiple frameworks or packages. This page maintains a list of third-party software that interfaces with uhepp.

Common Analysis Framework

The Common Analysis Framework, or CAF, is an event processing framework used within the ATLAS collaboration to study data produced at the LHC. CAF provides a custom uhepp-compatible plotter that generates JSON files instead of graphics formats and optionally uploads the plot to uhepp.org. To use the plotter, add the following lines to your visualize configuration.

plotter: uhepp
plotFormats: json
# Collection id, e.g. 1
plotter.uhepp.collection: 1

Neural-network framework to be named

The Neural-network framework to be named, or nnfwtbn, is a python-based event processing framework with a focus on neural network training. The default plotting environment in nnfwtbn is based on uhepp and exposes the internal objects with the return_uhepp=True flag. The following example is a modified version of this example to show how to push a histogram to a collection.

plot = hist(df, v_higgs_m, 20, [s_bkg, s_data], range=(0, 200), selection=None,
            weight="weight",  ratio_label="Data / SM", return_uhepp=True)
# plot is a uhepp histogram
plot.show()
plot.push(1)

Latex

Using plots stored on uhepp hub in a latex document involves the following steps: Downloading the plot, rendering the plot, adding the includegraphics command to the latex document. With the following snippet, you can automate this procedure and add plots directly using the plot’s uuid.

Add this snippet in the preamble of your document:

\newcommand{\includeuhepp}[2]{
  \immediate\write18{mkdir -p .uhepp_cache}
  \immediate\write18{test -f .uhepp_cache/#2.json || uhepp pull #2 .uhepp_cache/#2.json}
  \immediate\write18{test -f .uhepp_cache/#2.pdf  || uhepp render .uhepp_cache/#2.json .uhepp_cache/#2.pdf}
  \includegraphics[width=#1\textwidth]{.uhepp_cache/#2.pdf}
}

Embed plots with:

\includeuhepp{1.0}{a378d2b0-cde2-4266-be9b-85945d94880d}