initial commit

AUTHORS

@@ -1 +1,3 @@
-FIXME: list authors' names and email addresses.
+* [Martin Kwok](https://github.com/kakwok)
+* Abdollah Mohammadi
+* Elisa Fontanesi

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

_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: <USERNAME>/<PROJECT> is correct.
-repository: <USERNAME>/<PROJECT>
+repository: kakwok/LPCTriggerHATS
 
 # Email address, no mailto:
 email: "team@carpentries.org"

_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 %}
 

_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 %}
+

_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 %}
+

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)