Skip to content

In-Browser Tools

The following tools can be used in-browser to explore several of the data files used by Combine

jsROOT (external) open

Can display (most) contents of *.root files, such as histograms e.g. the shapes files.

Interactive Viewers

  • nice display of overly large tables, such that headers & important labels stay on screen
  • extensive support for live filtering of table contents
  • numeric values are colored, with configurable scale

Datacard Viewer open

  • for *.txt datacards
  • filter by: bin, process, nuisance-name, -type, and -group
  • also shows overview or rate values for given bin & process combinations
  • also shows: autoMCStats, nuisance edit, extArg & rateParam
  • can detect & report some layout/formatting issue

Covariance Viewer open

  • for specific *.cov.json files, see following format description
  • configurable filtering of row/columns with only small off-diagonal elements
  • automatically highlight common parts in nuisance parameter names in different colors for easier reading

File Format

It needs to be a valid JSON file, with the following fields:

  • labels, required
    • type: Arrray of N Strings
    • the nuisance/fit parameter labels
  • cov or cor, at least one of them
    • type: Array of N Arrays of N Numbers between -1 and 1
    • the covariance/correlation matrix
    • ordering of rows/columns corresponds to that of labels
  • qual, optional
    • type: Number or String
    • the fit result/quality number

Example File

{
  "labels": ["lumi", "BR", "r"],
  "cov": [
    [1   , 0.1, 0.01],
    [0.1 , 1  , 0.1 ],
    [0.01, 0.1, 1   ]
  ]
}