Combine v10.1.0

Main changes

• Allow for flat priors also for shape parameters by @nucleosynthesis in #1040

Documentation updates

• plot1Dscan links in doc by @amarini in #1000
• Update parametric_exercise.md by @maxwrabetz in #1010
• Tutorial ABCD method with RooParamtricHist by @cesarecazzaniga in #1002

Development

• Add an option to read in a list of points from a .csv file (--fromfile) by @runtingt in #937
• Use RooDataSet constructor that takes RooFit::WeightVar argument by @guitargeek in #1009
• Adding build with ROOT 6.32.06 by @anigamova in #1008
• Update cvmfs-ci.yml with a stable ROOT 6.32.06 release by @anigamova in #1011
• Deprecating py2 for combine v10 by @jonathon-langford in #1014
• Fix Quadratic Scaling (docstring and allow pickle) by @JaLuka98 in #1013
• Factor out some mathematical details into free functions by @guitargeek in #1017
• Add global flag to set NLL evaluation backend by @guitargeek in #1018
• Update standalone LCG setup instructions by @guitargeek in #1021
• Declare SimpleGaussianConstraint as self-normalized to RooFit by @guitargeek in #1022
• Replacing deprecated Mambaforge with Miniforge3 by @anigamova in #1025
• More standard implementation of RooMultiPdf by @guitargeek in #1024
• Use std::floor instead of casting double -> int -> double by @guitargeek in #1026
• Apply a few more clang-tidy checks by @guitargeek in #1027
• implement option in FitterAlgoBase to toggle between nll backends by @pkausw in #1028
• Remove Proof from HybridNew, as it was removed from RooStats by @gpetruc in #1033
• Fix some compiler warnings by @guitargeek in #1035
• Update runningthetool.md by @nucleosynthesis in #1041
• Add public getters to useful information in combine classes by @guitargeek in #1023

New Contributors

• @runtingt made their first contribution in #937
• @cesarecazzaniga made their first contribution in #1002
• @maxwrabetz made their first contribution in #1010
• @JaLuka98 made their first contribution in #1013

Full Changelog: v10.0.2...v10.0.3

Combine v10.0.2

What's Changed

• Replace old iterators in python script (ROOT 6.32 compatibility), fixing python scripts by @anigamova in #977
• fix seg fault with FitDiagnostics plots by @kcormi in #991
• Fix #987, incorrect dependency in conda_env.yml by @pitkajuh in #988
• Fix bugs in shapeN + CMSHistFunc/Sum by @ajgilbert in #995
• Update cvmfs-ci workflow by @anigamova in #993
• Update Impacts.py (making --setParameters option in Impacts.py compatible with the one in src/Combine.cc ) by @anigamova in #996
• Adding getProcessNorms() to CMSHistErrorPropagator by @nucleosynthesis in #994

Tutorials and documentation updates

• Add tutorial material by @kcormi in #979
• Add material for tutorial on model building by @anigamova in #981
• Updating CH instructions for checkout since not needed as much now (… by @nucleosynthesis in #976
• Add approx. impacts to docs by @nucleosynthesis in #985

New Contributors

• @pitkajuh made their first contribution in #988

Full Changelog: v10.0.1...v10.0.2

Combine patch v10.0.1

This is a patch fixing a bug reported here.

What's Changed

• Fix a bug check_inf_parameters in #974

Full Changelog: v10.0.0...v10.0.1

Combine v10.0.0

This version is targeting CMSSW_14_1_0_pre4 and is compatible with ROOT >= 6.30/07 and el9 architecture.
Installation instructions are available at http://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/v10.0.X/#installation-instructions.

Major updates

• ROOT v6.30/07 support: #969 #971 #972 #947 #951 #955 #950

• Move combineTool.py scripts to Combine in #902 #970

Code and documentation improvements

• Follow up on ordered collections for nuisance parameters in #940
• Force updateGrid in expectedFromGrid HybridNew.cc in #941
• Updates in DataFrameWrapper #963
• Update logic for Feldman Cousins intervals and add example in #966
• Updated CI workflows in #965 #946 #956
• Use override keyword where necessary in #948
• Support compilation with StatAnalysis in #967

Full Changelog: v9.2.1...v10.0.0

Combine v9.2.1

Main update

• Moved to ordered collections to fix the order of nuisance parameters for the workspace build with text2workspace.py in #936

Documentation and tutorial

• Changes to mkdocs and CI for using mike to version the docs in #918 #926
• Installation instructions updates in #924 #928
• Tutorial updates in #930 #931 #932
• Physics models and general documentation updates #921 #914 #922

Full Changelog: v9.2.0...v9.2.1

Combine v9.2.0

Main updates

• Add flags for SinglePdfGenInfo to avoid using gen spec when changing nuisances per toy. in #836
• Add regex for --floatNuisances in #851
• Updates to ChannelCompatibilityCheck in #760 #805
• New logger in #868
• Updates for ROOT versions > 6.22 in #873 #874 #915 #890 #905
• Spellcheck #894 #907
• Random start points option for profiled parameters of interest in #713

Physics models

• Adding physics model for (STXSto)SMEFT fits in #855
• Accelerated interference models in #842

Documentation/tutorial updates

• New Documentation Section focused on underlying stats without code in #839
• Parametric exercise updates in #913
• Unfolding tutorial in #862
• Add Contributing Document in #838
• Update impact docs to explain multiple POI usage in #852
• Documentation language edit /spell check in #871
• Include docker installation in #864
• Adding folder CAT23001 with datacards used in the paper in #865
• Improve structure of tutorial sections in #909

Full Changelog: v9.1.0...v9.2.0

Combine v9.1.0

What's Changed

• Documentation and tutorial updates across several PRs: #812 #813 #814 #815 #816 #824
  #826
• Replace CLs and CLsplusb with Pb and Pmu in the documentation and code: #832
• Separated --dataset option in combine from text2workspace to avoid overwriting workspace location used in datacard parser when an alternative dataset is provided to combine in #832
• Added an option to assign RooUniform pdf for flatParam nuisances and restructured the loop over the systematics in #834

Full Changelog: v9.0.0...v9.0.1

Combine v9

This version is targeting CMSSW_11_3_4 but is broadly compatible with ROOT 6.22 through ROOT 6.26, and hence also CMSSW 12_X release series. Installation instructions are summarized in https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/#installation-instructions

New features include:

• Full python3 compatibility (#759)
• Improved ROOT version support (#776)
• 2D RooParametricHist class (#545)
• Shapes from pandas dataframe (#548)
• Added instructions and tools for producing inputs for simplified likelihoods (#800)
• Many bug fixes (see e.g. list of merged PRs to 112x)

From this point on, new developments should always target the main branch, with backports to release series as necessary.

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.