Skip to content

Commit

Permalink
updating release docs
Browse files Browse the repository at this point in the history
  • Loading branch information
ajgilbert committed Jan 25, 2023
1 parent 5db7e6f commit 610d8de
Show file tree
Hide file tree
Showing 6 changed files with 17 additions and 11 deletions.
1 change: 1 addition & 0 deletions CombineTools/scripts/sparse-checkout-https.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@ else
git remote add origin https://github.com/cms-analysis/CombineHarvester.git
git config core.sparsecheckout true; echo CombineTools/ >> .git/info/sparse-checkout
git pull origin 113x
git checkout v2.0.0
popd
fi
1 change: 1 addition & 0 deletions CombineTools/scripts/sparse-checkout-plotting-https.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@ else
git remote add origin https://github.com/cms-analysis/CombineHarvester.git
git config core.sparsecheckout true; echo CombineTools/python >> .git/info/sparse-checkout
git pull origin 113x
git checkout v2.0.0
popd
fi
1 change: 1 addition & 0 deletions CombineTools/scripts/sparse-checkout-plotting-ssh.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@ else
git remote add origin [email protected]:cms-analysis/CombineHarvester.git
git config core.sparsecheckout true; echo CombineTools/python >> .git/info/sparse-checkout
git pull origin 113x
git checkout v2.0.0
popd
fi
1 change: 1 addition & 0 deletions CombineTools/scripts/sparse-checkout-ssh.sh
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,6 @@ else
git remote add origin [email protected]:cms-analysis/CombineHarvester.git
git config core.sparsecheckout true; echo CombineTools/ >> .git/info/sparse-checkout
git pull origin 113x
git checkout v2.0.0
popd
fi
15 changes: 8 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,24 +4,25 @@ Full documentation: http://cms-analysis.github.io/CombineHarvester

## Quick start

This pacakge requires HiggsAnalysis/CombinedLimit to be in your local CMSSW area. We follow the release recommendations of the combine developers which can be found [here](https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/#setting-up-the-environment-and-installation). The CombineHarvester framework is compatible with the CMSSW 8_1_X and 10_2_X series releases. For the 11_2_X series we require a number of changes to the python interface code, and a special branch `112x` has been prepared, but note that this has not been tested or validated yet.
This package requires HiggsAnalysis/CombinedLimit to be in your local CMSSW area. We follow the release recommendations of the combine developers which can be found [here](https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/#setting-up-the-environment-and-installation). The CombineHarvester framework is compatible with the CMSSW 10_2_X and 11_3_X series releases. The default branch, `main`, is for developments in the 11_3_X releases, and the current recommended tag is `v2.0.0`. The `102x` branch should be used in CMSSW_10_2_X, and is expected to receive only minor updates.

If you just need the core CombineHarvester/CombineTools subpackge, then the following scripts can be used to clone the repository with a sparse checkout for this one only:
If you just need the core CombineHarvester/CombineTools subpackage, then the following scripts can be used to clone the repository with a sparse checkout for this one only:

git clone via ssh:
bash <(curl -s https://raw.githubusercontent.com/cms-analysis/CombineHarvester/master/CombineTools/scripts/sparse-checkout-ssh.sh)
bash <(curl -s https://raw.githubusercontent.com/cms-analysis/CombineHarvester/main/CombineTools/scripts/sparse-checkout-ssh.sh)
git clone via https:
bash <(curl -s https://raw.githubusercontent.com/cms-analysis/CombineHarvester/master/CombineTools/scripts/sparse-checkout-https.sh)
bash <(curl -s https://raw.githubusercontent.com/cms-analysis/CombineHarvester/main/CombineTools/scripts/sparse-checkout-https.sh)

A new full release area can be set up and compiled in the following steps:

export SCRAM_ARCH=slc7_amd64_gcc700
scram project CMSSW CMSSW_10_2_13
cd CMSSW_10_2_13/src
export SCRAM_ARCH=slc7_amd64_gcc900
scram project CMSSW CMSSW_11_3_4
cd CMSSW_11_3_4/src
cmsenv
git clone https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit.git HiggsAnalysis/CombinedLimit
# IMPORTANT: Checkout the recommended tag on the link above
git clone https://github.com/cms-analysis/CombineHarvester.git CombineHarvester
git checkout v2.0.0
scram b

Previously this package contained some analysis-specific subpackages. These packages can now be found [here](https://gitlab.cern.ch/cms-hcg/ch-areas). If you would like a repository for your analysis package to be created in that group, please create an issue in the CombineHarvester repository stating the desired package name and your NICE username. Note: you are not obliged to store your analysis package in this central group.
9 changes: 5 additions & 4 deletions docs/Main.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,15 +31,16 @@ This repository is a "top-level" CMSSW package, i.e. it should be located at `$C
* **CombineHarvester/CombineTools**, which contains the CombineHarvester class and other parts of the core framework
* **CombineHarvester/CombinePdfs**, which provides tools for building custom RooFit pdfs

The CMSSW version that should be used with CombineHarvester is driven by the recommendation for the HiggsAnalysis/CombinedLimit package, which is also required. The latest instructions can be found [here](https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/#setting-up-the-environment-and-installation). The CombineHarvester framework is compatible with the CMSSW 8_1_X and 10_2_X series releases. A new release area can be set up and compiled in the following steps:
The CMSSW version that should be used with CombineHarvester is driven by the recommendation for the HiggsAnalysis/CombinedLimit package, which is also required. The latest instructions can be found [here](https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/#setting-up-the-environment-and-installation). The CombineHarvester framework is compatible with the CMSSW 10_2_X and 11_3_X series releases. A new release area can be set up and compiled in the following steps:

export SCRAM_ARCH=slc6_amd64_gcc530
scram project CMSSW CMSSW_10_2_13
cd CMSSW_10_2_13/src
export SCRAM_ARCH=slc7_amd64_gcc900
scram project CMSSW CMSSW_11_3_4
cd CMSSW_11_3_4/src
cmsenv
git clone https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit.git HiggsAnalysis/CombinedLimit
# IMPORTANT: Checkout the recommended tag on the link above
git clone https://github.com/cms-analysis/CombineHarvester.git CombineHarvester
git checkout v2.0.0
scram b

If you are using this framework for the first time we recommend taking a look through some of the examples below which demonstrate the main features:
Expand Down

0 comments on commit 610d8de

Please sign in to comment.