STNtuple Tutorial Session: Difference between revisions

From Mu2eWiki
Jump to navigation Jump to search
(Created page with "== Tutorial Session Goal == The goals of each session should be clearly defined at the top of the page; for instance '''In this Tutorial you will learn how to analyze TTree da...")
 
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Tutorial Session Goal ==
== Tutorial Session Goal ==
The goals of each session should be clearly defined at the top of the page; for instance
This tutorial will get you started on how to STNtuple package to analyze Mu2e data.
'''In this Tutorial you will learn how to analyze TTree data produced by TrkAna'''
 
== Session Prerequisites and  Advance Preparation ==
== Session Prerequisites and  Advance Preparation ==
This tutorial may require attendees to have already completed other tutorials, and may
This tutorial requires the user to:
require special preparations on their laptop. Prerequisites and advanced preparations should be listed at the top of the session,
together with links. Examples might be:
* have a Mu2e computing account and some preliminary use of that
* Perform the tutorial on running Mu2e art Framework jobs [[Tutorial_2019_June:Framework_jobs]]  
* have access to Mu2e internal wiki - send an email to Ray Culbertson (rlc@fnal.gov) if you need that
* Read the [https://root.cern.ch/root/htmldoc/guides/users-guide/ROOTUsersGuide.html#fitting-histograms root documentation on histogram fitting]
* Perform the [[ Mu2e_Offline_Tutorial | Tutorial on setting up the Mu2e Offline ]]
* Download and install [https://root.cern.ch/downloading-root root] (v6.14 or later) on your machine
* [https://mu2einternalwiki.fnal.gov/wiki/Stntuple Read STNTUPLE documentation in Mu2e internal wiki]
* Run the [https://root.cern.ch/doc/master/combinedFit_8C.html root combined fit tutorial]
* [https://mu2ewiki.fnal.gov/wiki/ComputingLogin#VNC Install VNC client software]
* Install the following docker containers ()
* [https://mu2einternalwiki.fnal.gov/wiki/Stntuple-Building-Stntuple-Libraries#building_STNTUPLE_libraries_in_a_satellite_release Build Stntuple libraries in v7_4_1 satellite release]
* go to [https://github.com GitHub] and create an account there
 
== Session Introduction ==
== Session Introduction ==
* Plan on spending 5 minutes in the beginning making sure everyone has fulfilled the prerequisites and has performed the advance preparation.
* make sure that all prerequisites are in place
* If necessary, present a brief (~5 minutes) overview on goals, background information, and context.  Make sure to link the slides to the session page.


== Exercises ==
== Exercises ==
The majority of the session time should be spent performing exercises, which you link or embed in the session page.
 
* Each exercise should have a title; ie ''Create a histogram of the reconstructed Ce momentum''
* [[https://mu2einternalwiki.fnal.gov/wiki/Stntuple-Tutorials STNTUPLE Tutorials]]
* Exercises may be chained (ie the output of the first is used as input to the next), but in that case make sure the output is also part of the downloads, so people who failed at step 1 can continue with the subsequent steps. Design this so that a failed step 1 does not overwrite the downloaded file that is the input to step 2.
 
* Some steps may take considerable processing time.  In that case, have your attendees perform a short version (ie process 10 events), and provide the full output (ie histograms from 10^5 events) as part of the session download for subsequent steps.
* Each exercise should take between 5 and 15 minutes to complete.  Count on your attendees taking twice as much time as would an experienced person.
* Start each exercise by bringing the exercise up on the main screen and going through its intro.
* Perform each step of the exercise on the screen, describing any decisions or issues involved as you do it.  Check with your audience to make sure most (preferably all) have finished each step before going on to the next.  If someone seems stuck, assign a session helper to help them individually and move on.
* It's OK to provide more exercises than most people will complete during the tutorial; they can be completed as homework.
== Session Organization Guideline ==
* Encourage your attendees to ask questions if they are unsure what to do.
* You may or may not have session helpers, who have already performed the tutorial
* If someone finishes a step or exercise early, have them look around for neighbors that need help.
* If someone is stuck, have them raise their hand to get help.
== Reference Materials ==
== Reference Materials ==
* Use this place to add inks to reference materials.
 
* [https://mu2einternalwiki.fnal.gov/wiki/Stntuple STNTUPLE documentation]
 
[[Category:Computing]]
[[Category:Tutorial]]
[[Category:Code]]

Latest revision as of 12:12, 24 June 2019

Tutorial Session Goal

This tutorial will get you started on how to STNtuple package to analyze Mu2e data.

Session Prerequisites and Advance Preparation

This tutorial requires the user to:

Session Introduction

  • make sure that all prerequisites are in place

Exercises

Reference Materials

Retrieved from "http://mu2ewiki.fnal.gov/w/index.php?title=STNtuple_Tutorial_Session&oldid=13736"