Difference between revisions of "Mu2e Offline Tutorial"

Revision as of 00:01, 30 May 2019

Tutorial Session Goal

This tutorial will show you how to work within the Mu2e Offline computing environment.

Session Prerequisites and Advance Preparation

This tutorial may require attendees to have already completed other tutorials, and may 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:

Perform the tutorial on running Mu2e art Framework jobs Tutorial_2019_June:Framework_jobs
Read the root documentation on histogram fitting
Download and install root (v6.14 or later) on your machine
Run the root combined fit tutorial
Install the following docker containers ()

Session Introduction

Mu2e Offline is a collection of code and scripts used for simulation, reconstruction and analysis of Mu2e data. Offline is kept in a git repository. It depends on external software provided through cvmfs (Cern virtual machine file system). Users interact with Offline in several ways, with more or less of the code resident in your local working area. to link the slides to the session page. This tutorial will cover the basic structure of Offline, and show you how to create the local environment to work with Offline.

Exercises

make sure everyone has a working install of docker and has downloaded the necessary containers
- Maybe we can use a loaner computer for people having problems?
test docker using some standard containers (helloworld, bash, ...)
start an interactive docker session using the tutorial container, and explore the structure of Offline
Examine the directory tree and substructure
- Look at the different kinds of source files: .cc, .inc, .fcl, _module.cc
- Search for content (data products) in RecoDataProducts, MCDataProducts, etc
- Search for algorithms (modules) that (say) build tracks, find clusters, identify background ,...
setup a satellite release (or partial checkout?)
explore scons script and run a simple build
experiment with .build_opts
look at content in /cvmfs
look at setup.sh
log in to mu2egpvm* machine?
kinit? certificates? docdb?

Reference Materials

other wiki pages on Offline

@@ Line 13: / Line 13: @@
 * Install the following docker containers ()
 == Session Introduction ==
-* Plan on spending 5 minutes in the beginning making sure everyone has fulfilled the prerequisites and has performed the advance preparation.
+Mu2e Offline is a collection of code and scripts used for simulation, reconstruction and analysis of Mu2e data.
-* If necessary, present a brief (~5 minutes) overview on goals, background information, and context.  Make sure to link the slides to the session page.
+Offline is kept in a git repository.  It depends on external software provided through cvmfs (Cern virtual machine file system).
+Users interact with Offline in several ways, with more or less of the code resident in your local working area.
+to link the slides to the session page.  This tutorial will cover the basic structure of Offline,
+and show you how to create the local environment to work with Offline.
 == Exercises ==