diff --git a/AUTHORS b/AUTHORS index 04e1f5a..7a77e31 100644 --- a/AUTHORS +++ b/AUTHORS @@ -1 +1,3 @@ -FIXME: list authors' names and email addresses. \ No newline at end of file +* [Martin Kwok](https://github.com/kakwok) +* Abdollah Mohammadi +* Elisa Fontanesi diff --git a/README.md b/README.md index 060994a..ada3bc1 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# FIXME Lesson title +# Trigger Exercise for the CMSDAS @ LPC [![Create a Slack Account with us](https://img.shields.io/badge/Create_Slack_Account-The_Carpentries-071159.svg)](https://swc-slack-invite.herokuapp.com/) @@ -24,17 +24,6 @@ Look for the tag ![good_first_issue](https://img.shields.io/badge/-good%20first% Current maintainers of this lesson are -* FIXME -* FIXME -* FIXME - - -## Authors - -A list of contributors to the lesson can be found in [AUTHORS](AUTHORS) - -## Citation - -To cite this lesson, please consult with [CITATION](CITATION) +* [Martin Kwok](https://github.com/kakwok) [lesson-example]: https://carpentries.github.io/lesson-example diff --git a/_config.yml b/_config.yml index f2ca373..8ceb83c 100644 --- a/_config.yml +++ b/_config.yml @@ -11,7 +11,7 @@ carpentry: "swc" # Overall title for pages. -title: "Lesson Title" +title: "Trigger Exercise for the CMSDAS @ LPC" # Life cycle stage of the lesson # See this page for more details: https://cdh.carpentries.org/the-lesson-life-cycle.html @@ -44,7 +44,7 @@ kind: "lesson" # Magic to make URLs resolve both locally and on GitHub. # See https://help.github.com/articles/repository-metadata-on-github-pages/. # Please don't change it: / is correct. -repository: / +repository: kakwok/LPCTriggerHATS # Email address, no mailto: email: "team@carpentries.org" diff --git a/_episodes/01-introduction.md b/_episodes/01-introduction.md index 2e156c2..a240177 100644 --- a/_episodes/01-introduction.md +++ b/_episodes/01-introduction.md @@ -1,15 +1,11 @@ --- title: "Introduction" -teaching: 0 +teaching: 30 exercises: 0 -questions: -- "Key question (FIXME)" objectives: -- "First learning objective. (FIXME)" -keypoints: -- "First key point. Brief Answer to questions. (FIXME)" +- "Overview of CMS trigger system" --- -FIXME +We will learn the overview of CMS trigger system, both L1 and HLT, with [slides](https://indico.cern.ch/event/1443889/). {% include links.md %} diff --git a/_episodes/02-HLT_timing.md b/_episodes/02-HLT_timing.md new file mode 100644 index 0000000..3f752f7 --- /dev/null +++ b/_episodes/02-HLT_timing.md @@ -0,0 +1,36 @@ +--- +title: "HLT timing studies" +teaching: 30 +exercises: 0 +objectives: +- "Measure the time it takes to run an HLT menu" +- "Reference repo: [link](https://github.com/loeschet/TimingExerciseTriggerHATS2023/blob/main/README.md)" +--- + +### Exercise 1: CPU/GPU Timing measurements without creation of a CMSSW environment + +1. Log in to lxplus and clone [the timing repository](https://gitlab.cern.ch/cms-tsg/steam/timing) somewhere (e.g. in your EOS space) + +~~~ +git clone https://gitlab.cern.ch/cms-tsg/steam/timing.git +cd timing +~~~ +{: .language-bash} + +2. Submit a timing job to the timing machine using `CMSSW_13_2_0`, the GRun menu V152 and the default dataset on the timing machine. Additionally, tell the program to merge in pull request [#42534](https://github.com/cms-sw/cmssw/pull/42534) Also use a user-specified tag to better identify your job later in the queue. + +~~~ +python3 submit.py /dev/CMSSW_13_0_0/GRun/V152 --cmssw CMSSW_13_2_0 --pull-requests 42534 --tag YOUR_TAG_HERE +~~~ +{: .language-bash} + +3. Check the status of your job using the `job_manager.py` script. + +~~~ +python3 job_manager.py +~~~ +{: .language-bash} + + +{% include links.md %} + diff --git a/_episodes/03-HLT_efficiency.md b/_episodes/03-HLT_efficiency.md new file mode 100644 index 0000000..7ab6715 --- /dev/null +++ b/_episodes/03-HLT_efficiency.md @@ -0,0 +1,18 @@ +--- +title: "Measuring trigger efficiencies" +teaching: 30 +exercises: 0 +objectives: +- "Learn how to access the trigger information stored in MiniAOD and NanoAOD" +- "Learn what is trigger objects and how to access them" +- "Measure trigger efficiency using the tag-and-probe method" +--- + +> ## Prerequisites +> Set up your machine following instructions in [setup][lesson-setup] first. +{: .prereq} + +The goal of the following exercises is to learn how to access and play with the trigger objects in our data and compute the efficiency of a specific HLT path, having a look also at its Level 1 (L1) seed. The focus will be on a HLT path used during the 2016 data-taking to select events with a certain amount of missing transverse energy: `HLT_PFMET170_HBHECleaned_v*`. + +{% include links.md %} + diff --git a/index.md b/index.md index 95ccdbd..49824c1 100644 --- a/index.md +++ b/index.md @@ -9,9 +9,37 @@ FIXME: home page introduction {% comment %} This is a comment in Liquid {% endcomment %} +> ## Links +> * [Trigger HATS@LPC 2024](https://indico.cern.ch/event/1443889/) +> * [Github repo](https://github.com/kakwok/LPCTriggerHATS) +> * [Twiki page(old)](https://twiki.cern.ch/twiki/bin/viewauth/CMS/SWGuideCMSDataAnalysisSchoolLPC2023TriggerExercise) +> * [HATS introductory slides 2024](https://indico.cern.ch/event/1443871/attachments/2906926/5099492/General%20HATS@LPC%202024%20Introductory%20Remarks.pdf) +{: .callout} + > ## Prerequisites -> -> FIXME +> 1. CERN lxplus account:[link](https://uscms.org/uscms_at_work/physics/computing/getstarted/index.shtml#GetCERNAcct) +> 2. CMS personal grid certificate::[link](https://uscms.org/uscms_at_work/physics/computing/getstarted/get_grid_cert.shtml) {: .prereq} +### Goal of this exercise + +This exercise will introduce you to the CMS trigger system and, in particular, trigger efficiency measurements. After this exercise (including the introductory lecture): + + * You will be familiar with basic concepts and terminology related to triggering, so that you can apply them in your work (e.g. turn-on, prescale, matching...) + * You will be able to describe the main features of the CMS trigger system + * You will have an overview of the CMS trigger menu, allowing you to identify suitable triggers for your physics analysis + * You will be familiar with the analysis tools needed to access trigger-related information in CMS datasets + * You will know how to perform trigger efficiency measurements + {% include links.md %} + +### Support + + * Dedicated HATS 2024 [Mattermost channel](https://mattermost.web.cern.ch/cms-exp/channels/hatslpc-2024) for live support during the tutorial + * Note that if you had never joined the CMS experiment Mattemost Team, you will first need to click this [link](https://mattermost.web.cern.ch/signup_user_complete/?id=sccjd35i7f8wde4nogq46ooipa). + +### Facilitators Trigger HATS@LPC 2024 + +* Martin Kwok (FNAL) +* Abdollah Mohammadi (UW-Madison) +* Daniel Diaz (UCSD)