Adding a new measurement¶
If a new measurement already exists in your installed version Rivet and you want to make use of it in Contur, you
“simply” need to add it to the Contur database, which can be found under your local contur directory
in AnalysisTools/contur/contur/TestingFunctions/analyses.sql
.
This is an sqlite database compiled when you type make
in your
local contur directory.
The changes you’ll need to make are:
Check if the new measurement fits in an existing analysis pool. If it does not, then you need to create a new analysis pool with an appropriate name, and add it to the
analysis_pool
table with a line like:INSERT INTO analysis_pool VALUES('ATLAS_7_JETS','7TeV','Inclusive hadronic final states');
. The first entry is the name, the second the beam descriptor, the third a brief text description of the pool.Once you have done this, or have identified an existing pool in which the analysis belongs, add the analysis to the
analysis
table with a line like:INSERT INTO analysis VALUES('ATLAS_2014_I1325553',4500.0,'ATLAS_7_JETS');
where the first field is the Rivet analysis name, the second is the integrated luminosity (in the same units in which the plots in the paper are displayed) and the third is the analysis pool name.
For simple cases, that’s all! Next time you type make
, the database will be remade and the .ana
files for steering rivet (see the running instructions) etc will be remade to include your new data. If you use those then next time you run Herwig/Rivet/Contur, you should see comparisons to your new data.
Additional tweaks:
If the plots in the paper are area normalised, Contur needs to know the absolute normalisation. This should be provided in the
normalization
table inanalysis.sql
, for example:INSERT INTO normalization VALUES('ATLAS_2012_I1203852','(d03|d05|d07)',0.0254,1);
. The first field is the analysis name, the second a regular expression, the third is the integrated cross section for a plot matching the regexp, and the fourth is a flag saying whether the MC plot is normalised by Rivet or not (should usually be 1).If there are a few plots you don’t want to use in the comparison, add them to the
blacklist
table. They will be ignored by contur.Alternatively, if there are only a few plots you do want to use in the comparison, add them to the
whitelist
table. All other plots from the analysis will be ignored by Contur.If there are several statistically independent plots in your analysis, you can add them to a subpool in the
subpool
table to maximise sensitivity.If the analysis is a search analysis, add it to the
searches
table.Check the other tables:
metratio
,neddtheory
,higgsgg
,higgsww
,atlaswz
,bveto
. These flag up various special cases. If you just want to run locally you can probably ignore them, but if you want to contribute your new work to the Contur repository (encouraged!) please check them.
If you have a new local Rivet routine you want to use then just add it (the usual .cc, .yoda, .plot
and .info
files to the modified_analyses
directory of your local Contur installation, and do all the above steps in the database as well. Next time you make
, the new routne should be compiled along with the database.