diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 33367ec8cc6..3054a2d9261 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -18,7 +18,7 @@ jobs: python-version: 3.8 - name: Build documentation run: | - python3 -m pip install mkdocs pymdown-extensions mkdocs-cinder + python3 -m pip install mkdocs pymdown-extensions mkdocs-material mkdocs build --verbose --clean - name: Deploy documentation uses: peaceiris/actions-gh-pages@v3 diff --git a/data/splash.txt b/data/splash.txt index 7f3844d5a84..f9cefd77e17 100644 --- a/data/splash.txt +++ b/data/splash.txt @@ -1,48 +1,32 @@ -@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ -@.%&&&&&&&&&&&&&&&&&&&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&#*.......,/#&&&&&&&&*&&&&&&&&&&&&&&&&&&&&%%@@@@@@@@@@&/.....,#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&* ./&&&&&&&&&&&*.%&&&&&# .%&&&&&&&&&&&&&&&&&,.,&&@@@@@@..(@@@@@@@,(@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&...(&&&&&&&&&&&&&&&&&&&&&,.. (&&&&&&&&&&&&&&%... &&&&&&@../@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&% ..%&&&&&&&&&&&&&&&&&&&&&& (# .*&&&&&&&&&&&&/.%*. %&&&&&&...%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&...*&&&&&&&&&&&&&&&&&&&&&&#.%&&...%&&&&&&&&&,,&&% ./&&&&&&&,..../&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&.../&&&&&&&&&&&&&&&&&&&&&&,.&&&&*. #&&&&&&% (&&&&...&&&&&&&&&&#*.....,&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@/% -@.%&&&&&&&&,..,&&&&&&&&&&&&&&&&&&&&&& *&&&&&(..,&&&&/.%&&&&&...&&&&&&&&&&&&&&&#...,@@@@@@@@@@@@@@@@@@@@@@@@&@@@@@@@@@@/% -@.%&&&&&&&&& ..(&&&&&&&&&&&&&&&&&&&&( #&&&&&&%.. %&.,&&&&&&&/. (&&&&&&&&&&&&&&&&*. &@@@@@@@@@@@@@@@@@@@@@*(@@@@@@@@@@@/% -@.%&&&&&&&&&&,..*&&&&&&&&&&&&&&&&&&&. &&&&&&&&&... /&&&&&&&&# .,&&&&&%&&&&&&&&&&,./&&&@@@@@@@@@@@@@@@@@@//@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&/...#&&&&&&&&&#,.&&&% .&&&&&&&&&&, #&&&&&&&&&& ..&&&&( .#&&&&&&(..%&&&&&&@@@@@@@@@@@@@@@(*@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&%(/****/(%&&&&&&%%%&&&&&&&&&&&&&&&&&&&&&&&#%%&&&&&&&#/***/#&&&&&&&&&&&&@@@@@@@@@@@@#,@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@@@@%,&@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&##%&&&&&&&&&&#%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@@&,&@@@@@@@@@@@@@@@/% -@.%&&&&&&&&&&&(.(&&( #&&&&#((&&&&##%(%#(%&&&.(#(#&&&&&%###&&&&&%#%((%&&&&&&#(#&&&&&&&&&&&&&&&&&&@@@&,&@@@@@@@@@@@@@@@@/% -@.#######%%%%%./&&&&&&&&.,&&&( %&% %% &#.&&&.,&&&,.&&&&&,,&&&&&& /&&*,&&& ,(((,.&&&&&&&&&&&&&&&&&&@,%@@@@@@@@@@@@@@@@@/% -@.(###########(.,//*./##/ /#(.,&&( /% /#.(&(../#( *&&%//..//&&&( *%%,.#&&*./#(/*&&&&&&&&&&&&&&&&&&,#@@@@@@@@@@@@@@@@@@/% -@.(############################%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,#&&@@@@@@@@@@@@@@@@@/% -@.(#################################%&&&&&&&&&&&&&&&&&&&&&&&&(#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,(&&&&@@@@@@@@@@@@@@@@/% -@.(#####################################%&&&&&&&&&&&&&&&&&&&(*&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,(&&&&&&&@@@@@@@@@@@@@@/% -@.(#########################################&&&&&&&&&&&&&&&*/&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,(&&&&&&&&&@@@@@@@@@@@@@/% -@.(############################################&&&&&&&&&&&%#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,(&&&&&&&&&&&@@@@@@@@@@@@/% -@.(###############################################&&&&&&&*#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&,#&&&&&&&&&&&&&&@@@@@@@@@@/% -@.(#################################################%&&%(&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&%,#&&&&&&&&&&&&&&&&@@@@@@@@@/% -@.(//#((##############################################%%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&%,%&&&&&&&&&&&&&&&&&&@@@@@@@@/% -@.(############/*(/(#################################/*#%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&%,%&&&&&&&&&&&&&&&&&&&&@@@@@@@/% -@.###################(/#/(##########################(#####%&&&&&&&&&&&&&&&&&&&&&&&&&&&&#,&&&&&&&&&&&&&&&&&&&&&&&@@@@@@/% -@.#########################//#####################(,(#######&&&&&&&&&&&&&&&&&&&&&&&&&&(,&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@/% -@.############################((/################//##########%&&&&&&&&&&&&&&&&&&&&&&&/*&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@@/% -@.#######################/,/(((((/,*(###########//#############&&&&&&&&&&&&&&&&&&&&&*/&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@@*% -@.####################**(###########/,,(######/,(###############&&&&&&&&&&&&&&&&&&&*(&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@@*% -@.&&&&&&&&&&&%#####(*/################/**/####(##################&&&&&&&&&&&&&&&&&,%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@*% -@.&&&&&&&&&&&&&&&&//####################*/**,(####################&&&&&&&&&&&&&&%,%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@@*% -@.&&&&&&&&&&&&&&#*&&&%###################(*(,/#####################&&&&&&&&&&&&(*&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@*% -@.&&&&&&&&&&&&&*#&&&&&&&################(/#*((,(###################%&&&&&&&&&&/(&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@*% -@.&&&&&&&&&&&%,&&&&&&&&&&&############,*####/(#**###################&&&&&&&&&,#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.%&&&&&&&&&/(&&&&&&&&&&&&&%#######(*########((##,(##################&&&&&&%,&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.%&&&&&&&&,&&&&&&&&&&&&&&&&&#####(/##########(###(,(################%&&&&(/&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.%&&&&&&#*&&&&&&&&&&&&&&&&&&&#*,(#############/####*/################&&&,%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.%&&&&&*%&&&&&&&&&&&&&&&&&&(,#################*(####(,(##############&(*&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.&@@&/(&&&&&&&&&&&&&&&&&*&&&&&#################*######(,(###########(,%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.(@/(@@&&&&&&&&&&&%(/&%&&&&&&&%################*########(**#######/*(%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*% -@.(&&#/%%,,,#%,,*(#############(/////////////////////////////*,,,,/////(((((((((((((((((((((((((((((((((((((((((((((((,% +@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ +@&&&&&&&&&&&&&&&&#(@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@% +@&&&&&&&&&&&&&&&&&&&&&&&&&(&@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@% +@&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&#@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@% +@&&&&&&&&&&&@#....,(@&&&&&.&&&&&&&&&&&(@@@@@@@@@@*...*@@@@@@@@@@@@@@@@@@@@@@@@@% +@&&&&&&&&...&&&&&&&&&#&&&@..&&&&&&&&&&&,../@@@*.&@@@@@.@@@@@@@@@@@@@@@@@@@@@@@@% +@&&&&&&@..@&&&&&&&&&&&&&&,,..@&&&&&&&&.#..&&&&..&@@@@@@@@@@@@@@@@@@@@@*@@@@@@@@% +@&&&&&&...&&&&&&&&&&&&&&&.@&../&&&&&@.@&..@&&&&.....@@@@@@@@@@@@@@@@@(@@@@@@@@@% +@&&&&&&...&&&&&&&&&&&&&&@.@&&*..&&&,.&&&..(&&&&&&&&&...#@@@@@@@@@@@@*@@@@@@@@@@% +@&&&&&&@..&&&&&&&&&&&&&&..&&&&@..@.#&&&&%..&&&&&&&&&&@..@@@@@@@@@@@/@@@@@@@@@@@% +@&&&&&&&&(..@&&&&&&&&*&&.*&&&&&&..@&&&&&@..@&&.@&&&&&..@&&@@@@@@@*#@@@@@@@@@@@@% +@&&&&&&&&&&&&@&%#&@@&&&&@@&&&&&&&&&&&&&&&@@@&&&@&#%@@&&&&&&&%@@@%@@@@@@@@@@@@@@% +@&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*@@@@@@@@@*@@@@@% +@&&&&&&&&,.&&&&&&&,%&#.&&.*&&&,,&&.&*.&&.&&.%&&&(&&.&&.&&&&&&&&&%@@@@@@@*@@@@@@% +@%%%%%%%%.(#/&&&&.&&&&&.&.&.&.%,&&.%/.&&.&&,&.#&#&&.,.&&&&&&*@&&&&@@@@@&*@@@@@@% +@%%%%%%%%%%..*..%%/.%/#&%.#&.&(.%&./.%&#.##.&&&.#&#.(/.&&&&@&&&&&&&%@@@*@@@@@@@% +@%%%%%%%%%%%%%%%%%%%%%%%*&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*#&&&&&&&&&&@&*@@@@@@@% +@%%%%%%%%%%%%%%%%%%%%%%%%%%%#&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&*@@@@@@@@% +@%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%#&&&&&&&&&&&&&&&&&&&&&&*%&&&&&&&&&&&&&*/&@@@@@@@% +@%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&@*&&&@@@@@@% +@%%%%%%#. ,%%%%%%%%%%%%%%%%%%%%%%%%%%&&&&&&&&&&&&&@*@&&&&&&&&&&&&&&&*@&&&&@@@@@% +@%%%%%%%%%%%%%%(*****(&%%%%%%%%%%%%%%%&&&&&&&&&&&&&&&&&&&&&&&&&&&&&**&&&&&&@@@@% +@%%%%%%%%%%&**%%%%% %%%@**%%%%%%%%%%%%%%&&&&&&&**&&&&&&&&&&&&&&&&&@*&&&&&&&&@@@% +@%%%%%%%%&*@%%%%%%%%%% %%%&*/%%%%%%%%%%%%&&&&*(&&&&&&&&&&&&&&&&&&&*&&&&&&&&&#@@% +@%%%%%%%**%%%%%%%%%%%%%% %%%%(*&%%%%%%%%%%*@*&&&&&&&&&&&&&&&&&&&&*@&&&&&&&&&&%@% +@&&&&/#*@%%%%%%%%%%%%%%%%% %%%%@*@%%%%%%&*/(&&&&&&&&&&&&&&&&&&&&*@&&&&&&&&&&&&@% +@&&&&&*@&&&%%%%%%%%%%%%%%%%%#%%%%&*%%%@%%%%%/&&&&&&&&&&&&&&&&&&*&&&&&&&&&&&&&&#% +@&&&&*&&&&&&&&%%%%%%%%%%%%%%%.%%%%%&*/%%%%%%%&&&&&&&&&&&&&&&&&*@&&&&&&&&&&&&&&&% +@%%&*@&&&&&&&&&&%%%%%%%%%%%%%%*%@**%%%**%%%%%%&&&&&&&&&&&&&&@*&&&&&&&&&&&&&&&&&% +@@@*@@@%&&&&&&&&&%%%%%%%%%%%%/#%%%%%%%%%%*@%%%%&&&&&&&&&&&&*(&&&&&&&&&&&&&&&&&&/ +@@*(@@@@@&&&&&&&&&%%%%%%@%%@%%%.%%%%%%%%%%%**@(&&&&&&&&&&**&&&&&&&&&&&&&&&&&&&&/ +@%*@@@**(@&@@@@&&/**(%&%%%%%%%% %%%%%%%%%%%%%%&**(&@&/**@&&&&&&&&&&&&&&&&&&&&&&# diff --git a/docs/index.md b/docs/index.md index 3737f44abbe..bbf83793aea 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,5 +1,9 @@ +hide: + - navigation + # Introduction + These pages document the [RooStats](https://twiki.cern.ch/twiki/bin/view/RooStats/WebHome) / [RooFit](https://root.cern.ch/roofit) - based software tool used for @@ -11,15 +15,16 @@ The package exists on GitHub under [https://github.com/cms-analysis/HiggsAnalysi For more information about Git, GitHub and its usage in CMS, see [http://cms-sw.github.io/cmssw/faq.html](http://cms-sw.github.io/cmssw/faq.html) -The code can be checked out from GitHub and compiled on top of a CMSSW release that includes a recent RooFit/RooStats +The code can be checked out from GitHub and compiled on top of a CMSSW release that includes a recent RooFit/RooStats, or via standalone compilation without CMSSW dependencies. See the instructions for installation of Combine below. + -# Installation instructions +## Installation instructions Installation instructions and recommended versions can be found below. Since v9.0.0, the versioning follows the [semantic versioning 2.0.0 standard](https://semver.org/). Earlier versions are not guaranteed to follow the standard. -## Within CMSSW (recommended for CMS users) +### Within CMSSW (recommended for CMS users) The instructions below are for installation within a CMSSW environment. For end users that do not need to commit or do any development, the following recipes @@ -27,7 +32,7 @@ should be sufficient. To choose a release version, you can find the latest releases on github under [https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit/releases](https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit/releases) -### Combine v9 - recommended version +#### Combine v9 - recommended version The nominal installation method is inside CMSSW. The current release targets the CMSSW `11_3_X` series because this release has both python2 and python3 ROOT @@ -52,7 +57,7 @@ git checkout v9.1.0 scramv1 b clean; scramv1 b # always make a clean build ``` -### Combine v8: `CMSSW_10_2_X` release series +#### Combine v8: `CMSSW_10_2_X` release series Setting up the environment (once): @@ -73,7 +78,7 @@ git checkout v8.2.0 scramv1 b clean; scramv1 b # always make a clean build ``` -### SLC6/CC7 release `CMSSW_8_1_X` +#### SLC6/CC7 release `CMSSW_8_1_X` Setting up OS using apptainer ([see detailed instructions](http://cms-sw.github.io/singularity.html)): @@ -98,7 +103,7 @@ git checkout v7.0.13 scramv1 b clean; scramv1 b # always make a clean build ``` -## Oustide of CMSSW (recommended for non-CMS users) +### Oustide of CMSSW (recommended for non-CMS users) Pre-compiled versions of the tool are available as container images from the [CMS cloud]([https://gitlab.cern.ch/cms-cloud/combine-standalone](https://gitlab.cern.ch/cms-cloud/combine-standalone/container_registry/15235)). These containers can be downloaded and run using [Docker](https://cms-opendata-guide.web.cern.ch/tools/docker/). If you have docker running you can pull and run the *latest* image using, @@ -109,7 +114,7 @@ docker run --name combine -it gitlab-registry.cern.ch/cms-cloud/combine-standalo You will now have the compiled Combine binary available as well as the complete package of tool. The container can be re-started using `docker start -i combine`. -## Standalone compilation +#### Standalone compilation The standalone version can be easily compiled using [cvmfs](https://cernvm.cern.ch/fs/) as it relies on dependencies that are @@ -129,7 +134,7 @@ make -j 4 You will need to source `env_standalone.sh` each time you want to use the package, or add it to your login environment. -### Standalone compilation with LCG +##### Standalone compilation with LCG For compilation outside of CMSSW, for example to use ROOT versions not yet available in CMSSW, one can compile against LCG releases. The current default is to compile with LCG_102, which contains ROOT 6.26: ```sh git clone https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit.git HiggsAnalysis/CombinedLimit @@ -145,7 +150,7 @@ batch job if the following files are included in the job tarball: tar -zcf Combine_LCG_env.tar.gz build interface src/classes.h --exclude=obj ``` -### Standalone compilation with `conda` +##### Standalone compilation with `conda` This recipe will work both for linux and MacOS ``` git clone https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit.git HiggsAnalysis/CombinedLimit @@ -171,7 +176,7 @@ conda activate combine **Note:** on OS X, Combine can only accept workspaces, so run `text2workspace.py` first. This is due to an issue with child processes and `LD_LIBRARY_PATH` (see note in Makefile) -### Standalone compilation with CernVM +##### Standalone compilation with CernVM Combine, either standalone or not, can be compiled via CVMFS using access to `/cvmfs/cms.cern.ch/` obtained using a virtual machine - [`CernVM`](https://cernvm.cern.ch/). To use `CernVM` You should have access to CERN IT resources. If you are a CERN user you can use your account, otherwise you can request a lightweight account. If you have a CERN user account, we strongly suggest you simply run one of the other standalone installations, which are simpler and faster than using a VM. @@ -190,7 +195,7 @@ At least 2GB of disk space should be reserved on the virtual machine for Combine jobs to batch systems or crab, which was originally developed in the context of Higgs to tau tau analyses. Since the repository contains a certain amount of analysis-specific code, the following scripts can be used to clone it with a sparse checkout for just the core [`CombineHarvester/CombineTools`](https://github.com/cms-analysis/CombineHarvester/blob/master/CombineTools/) subpackage, speeding up the checkout and compile times: diff --git a/docs/logo.pdf b/docs/logo.pdf new file mode 100644 index 00000000000..f95c2492dad Binary files /dev/null and b/docs/logo.pdf differ diff --git a/docs/logo.png b/docs/logo.png index a392ead4a08..62016daec56 100644 Binary files a/docs/logo.png and b/docs/logo.png differ diff --git a/docs/mystyle.css b/docs/mystyle.css index 57f24c52e2b..8afa81923ce 100644 --- a/docs/mystyle.css +++ b/docs/mystyle.css @@ -1,12 +1,3 @@ -@media (min-width: 992px) { - .bs-sidebar.affix { - position: fixed; /* Undo the static from mobile first approach */ - top: 80px; - max-height: calc(100% - 90px); - overflow-y: auto - } -} - details { display: block; border-left: 0.1em solid #909090; diff --git a/docs/part2/physicsmodels.md b/docs/part2/physicsmodels.md index 99900de4c56..1ad60058b62 100644 --- a/docs/part2/physicsmodels.md +++ b/docs/part2/physicsmodels.md @@ -254,17 +254,17 @@ for an example. However, the computational performance scales quadratically with the number of POIs, and can get extremely expensive for 10 or more, as may be encountered often with EFT analyses. To alleviate this issue, an accelerated interference modeling technique is implemented for template-based analyses via -the `interferenceModel` physics model. In this model, each bin yield $w$ is parameterized +the `interferenceModel` physics model. In this model, each bin yield $y$ is parameterized $$ -w(\vec{\mu}) = w_0 (\vec{\mu}^\top M \theta) +y(\vec{\mu}) = y_0 (\vec{\mu}^\top M \vec{\mu}) $$ -as a function of the POI vector $\vec{\mu}$, a nominal template $w_0$, and a scaling matrix $M$. +as a function of the POI vector $\vec{\mu}$, a nominal template $y_0$, and a scaling matrix $M$. To see how this parameterization relates to that of the previous section, we can define: $$ -w_0 = A_b^2, \qquad +y_0 = A_b^2, \qquad M = \frac{1}{A_b^2} \begin{bmatrix} |A_s|^2 & \Re(A_s^* A_b) \\ \Re(A_s A_b^*) & |A_b|^2 diff --git a/mkdocs.yml b/mkdocs.yml index 639cd5154e3..c698b0e9073 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -26,9 +26,23 @@ nav: - "Exercise: unfolding in combine": tutorial2023_unfolding/unfolding_exercise.md theme: - name: cinder - include_sidebar: true - highlightjs: true + name: material + logo: logo.png + favicon: logo.png + features: + - content.code.copy + - navigation.footer + - navigation.expand + - navigation.indexes + - navigation.sections + - navigation.tracking + - navigation.tabs + - navigation.tabs.sticky + - navigation.top + - search.highlight + - search.suggest + - toc.follow + extra_css: - "mystyle.css"