combine v8.1.0 for CMSSW_10_2_X on CC7

This release includes the latest developments made for the Higgs preliminary combination HIG-19-005.

Improvements to the code include:

• Options to speed up discrete minimisation (a6950ba). Enabled by including the option --X-rtd MINIMIZER_freezeDisassociatedParams, can now also include the following

  • --X-rtd MINIMIZER_multiMin_hideConstants: hide the constant terms in the likelihood when recreating the minimizer
  • --X-rtd MINIMIZER_multiMin_maskConstraints: hide the constraint terms during the discrete minimization process
  • --X-rtd MINIMIZER_multiMin_maskChannels=<choice> mask in the NLL the channels that are not needed:
    • <choice> 1: keeps unmasked all channels that are participating in the discrete minimization
    • <choice> 2: keeps unmasked only the channel whose index is being scanned at the moment (works only in multipleMinimize mode 0, makes discrete minimization faster)

• Add option to completely skip discrete minimization (for DEBUG purposes only) --X-rtd MINIMIZER_skipDiscreteIterations (b3802ae)

• Added option in text2workspace.py: --just-check-physics-model to test a physics model quickly without building the full workspace (f162ceb)

• Improved tool test/scanScalefactorsFromWS.py to allow producing scans of scale-factors from PhysicsModels using workspace directly.

• General improvements in memory management in workspace creation.

combine v8.0.1 for CMSSW_10_2_X on CC7

Updates in this tag compared to v8.0.0:

• Fix for TTree branch format in FitDiagnostics
• Documentation updates

For more extensive changes in v8.0.0 with respect to the 8_1_X branch see here.

combine v8.0.0 for CMSSW_10_2_X on CC7

Updates in this tag compared to v7.0.12:

• New documentation pages, using the mkdocs framework. The documentation source is included in the repository as simple markdown files. Users are welcome to make additions and corrections as pull requests to this repo.
• It is now possible to include additional constraint terms for regularisiation when unfolding using combine. Detailed documentation for this is given here.
• The option -S 0 to remove all systematic uncertainties has been removed. Instead, to freeze all constrained nuisance parameters the option --freezeParameters allConstrainedNuisances should be used, which replaces the previous shortcut of --freezeParameters all.
• The possibility to use some old method names has now been fully removed. When setting the -M option, FitDiagnostics, AsymptoticLimits and Significance must be used instead of, respectively, MaxLikelihoodFit, Asymptotic and ProfileLikelihood.
• Nuisance edit selections for bins, processes or systematic names now require a complete string match. For example, nuisance edit add procA binA [...] will no longer match procAB and binAB. Note that regex selections can still be used to match multiple labels, but again are now required to match the full strings.
• Nuisance parameters can now be frozen using attributes that have been assigned to the corresponding RooRealVars. Syntax is --freezeWithAttributes attr1,attr2,...,attrN.
• For Higgs analyses: added YR4 cross sections, branching ratios and partial width uncertainties in data/lhc-hxswg/sm/, as used in HIG-17-031
• [EXPERIMENTAL] For binned analyses using autoMCStats a faster implementation of the vertical template morphing for shape uncertainties can be enabled at runtime with the option --X-rtd FAST_VERTICAL_MORPH. Any results using this flag should be validated carefully against the default.

combine v7.0.13 for CMSSW_8_1_X on CC7/SLC6

Updates in this tag compared to v7.0.12:

• Nuisance edit selections for bins, processes or systematic names now require a complete string match. For example, nuisance edit add procA binA [...] will no longer match procAB and binAB. Note that regex selections can still be used to match multiple labels, but again are now required to match the full strings.
• Nuisance parameters can now be frozen using attributes that have been assigned to the corresponding RooRealVars. Syntax is --freezeWithAttributes attr1,attr2,...,attrN.
• For Higgs analyses: added YR4 cross sections, branching ratios and partial width uncertainties in data/lhc-hxswg/sm/, as used in HIG-17-031
• [EXPERIMENTAL] For binned analyses using autoMCStats a faster implementation of the vertical template morphing for shape uncertainties can be enabled at runtime with the option --X-rtd FAST_VERTICAL_MORPH. Any results using this flag should be validated carefully against the default.

Moriond 2016 release

This is a pre-release for HiggsAnalysis/CombinedLimit for use in the run up to the Moriond 2016 combination. It can be used on CMSSW_7_1_5 (or later 7.1.X) on the slc6_amd64_gcc481 architecture.

The release contains several bug-fixes with respect to v5.0.1 and in particular new features advertised in the tutorial sessions.

v6.0.0

ROOT6 release for CMSSW_7_4_X.
Note: this has not yet been systematically validated.

v5.0.1 SLC6 release

This is the first good SLC6 release for HiggsAnalysis/CombinedLimit, that can be used on CMSSW_7_1_5 (or later 7.1.X) on the slc6_amd64_gcc481 architecture.

With respect to the previously announced v5.0, it fixes a bug in the code that warns about nuisance parameters close to their boundaries, which would under some circumstances cause a crash (PR #166)

It includes everything in the v4.0.1-sl5 release plus some pdfs needed for combination with ATLAS.

v4.0.1-sl5: SL5 legacy bugfix release

This is the latest SL5 release, including everything that was developed so far in SL5.

With respect to the previously announced v4.0-sl5, it fixes a bug in the code that warns about nuisance parameters close to their boundaries, which would under some circumstances cause a crash (PR #165)

To be used on top of CMSSW_6_1_1 (or any release with the same roofit and roostats versions) for SL5

v5.0: First SL6 release

Please use v5.0.1 instead, which fixes a bug that could cause crashes in some circumstances (#166)

This is the first SLC6 release for HiggsAnalysis/CombinedLimit, that can be used on CMSSW_7_1_5 (or later 7.1.X) on the slc6_amd64_gcc481 architecture.

It includes everything in the v4.0-sl5 release plus some pdfs needed for combination with ATLAS.

v4.0-sl5: legacy SL5 release

Please use v4.0.1-sl5 instead, which fixes a bug that could cause crashes in some circumstances (#165)

This is the latest SL5 release, including everything that was developed so far in SL5.

To be used on top of CMSSW_6_1_1 (or any release with the same roofit and roostats versions) for SL5