STNtuple Tutorial Session: Difference between revisions

From Mu2eWiki
Jump to navigation Jump to search
Line 13: Line 13:


== Exercises ==
== Exercises ==
The majority of the session time should be spent performing exercises, which you link or embed in the session page.
* Install STNtuple in your satellite release
* Each exercise should have a title; ie ''Create a histogram of the reconstructed Ce momentum''
* Run STNtuple on a standard file
* 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.
* Explore data structure of the ntuple produced by STNtuple
* 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.
* Event display in STNtuple
* 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.
* Advanced analysis in STNtuple
* 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 ==
== Session Organization Guideline ==
* Encourage your attendees to ask questions if they are unsure what to do.
* Encourage your attendees to ask questions if they are unsure what to do.

Revision as of 23:55, 23 May 2019

Tutorial Session Goal

This tutorial will show how to use the STNtuple package to analyze Mu2e data.

Session Prerequisites and Advance Preparation

This tutorial requires the user to:

Session Introduction

STNtuple is based on a software design developed at CDF and ported to Mu2e by Pasha Murat. The code for STNtuple is kept in a separate package from the Mu2e Offline.

Exercises

  • Install STNtuple in your satellite release
  • Run STNtuple on a standard file
  • Explore data structure of the ntuple produced by STNtuple
  • Event display in STNtuple
  • Advanced analysis in STNtuple

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

  • Use this place to add inks to reference materials.
Retrieved from "http://mu2ewiki.fnal.gov/w/index.php?title=STNtuple_Tutorial_Session&oldid=12151"