Analysis Tools Tutorial: Difference between revisions

From Mu2eWiki
Jump to navigation Jump to search
No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page and the linked tutorials are under construction
This page and the linked tutorials are under construction. We are currently looking for feedback on Exercises 1, 2, 3a, and 3b. Let us know what you think on the #analysis-tools-tutorial Slack channel.


== Introduction ==
== Introduction ==
Line 12: Line 12:
== Exercises ==
== Exercises ==


=== Logging into and Using the Elastic Analysis Facility (EAF) ===
=== [https://github.com/Mu2e/Tutorial/blob/main/EAF/README.md 1. Logging into and Using the Elastic Analysis Facility (EAF)] ===
The documentation for this tutorial is [https://github.com/Mu2e/Tutorial/blob/main/EAF/README.md here]. By the end, you will be able to:
By the end of this tutorial, you will be able to:
* TODO
* access the EAF, and
* open and use a python notebook on the EAF.


=== [https://github.com/Mu2e/EventNtuple/blob/main/tutorial/eventntuple-basics.md EventNtuple Basics] ===
=== [https://github.com/Mu2e/EventNtuple/blob/main/tutorial/eventntuple-basics.md 2. EventNtuple Basics] ===
By the end of this tutorial, you will be able to:
By the end of this tutorial, you will be able to:
* describe the difference between single-object branches, vector branches, and vector-of-vector branches, and
* describe the difference between single-object branches, vector branches, and vector-of-vector branches, and
* find the leaf and branch definitions using either ntuplehelper or GitHub
* find the leaf and branch definitions using either ntuplehelper or GitHub


=== Analyzing the EventNtuple with ROOT (RooUtil) ===
=== [https://github.com/Mu2e/EventNtuple/blob/main/tutorial/eventntuple-rooutil.md 3a. Analyzing the EventNtuple with ROOT (RooUtil)] ===
The documentation for this tutorial is [https://github.com/Mu2e/EventNtuple/blob/main/tutorial/eventntuple-rooutil.md here]. By the end, you will be able to:
By the end of this tutorial, you will be able to:
* analyze EventNtuple datasets,
* analyze EventNtuple datasets,
* select subsets of the data, and
* select subsets of the data, and
Line 28: Line 29:
in ROOT.
in ROOT.


=== Analyzing the EventNtuple with Python (pyutils) ===
=== [https://github.com/Mu2e/EventNtuple/blob/main/tutorial/eventntuple-pyutil.md 3b. Analyzing the EventNtuple with Python (pyutils)] ===
The documentation for this tutorial is [https://github.com/Mu2e/pyutils/blob/main/README.md here]. By the end, you will be able to:
By the end of this tutorial, you will be able to:
* analyze EventNtuple datasets,
* analyze EventNtuple datasets,
* select subsets of the data, and
* select subsets of the data, and
Line 35: Line 36:
in python.
in python.


=== Visualizing an interesting event with EventDisplay ===
=== [??? 4. Visualizing an interesting event with EventDisplay] ===
The documentation for this tutorial is [??? here]. By the end, you will be able to:
By the end of this tutorial, you will be able to:
* TODO
* TODO


=== Generating a Mock Dataset ===
=== [??? 5. Generating a Mock Dataset] ===
The documentation for this tutorial is [??? here]. By the end, you will be able to:
By the end of this tutorial, you will be able to:
* generate a mock dataset
* generate a mock dataset


=== Performing a Cut-And-Count Analysis ===
=== 6. Performing a Cut-And-Count Analysis ===
Now that you have a mock dataset and can analyze EventNtuple files, you can now perform a Cut-And-Count Analysis and compare to the Reference Analysis. The cuts used in the Reference Analysis are documented [??? here] and the results from the Reference Analysis are [??? here]. Can you improve the sensitivity with changes to the cuts or style of analysis? Can you do something other than the conversion search (e.g.
Now that you have a mock dataset and can analyze EventNtuple files, you can now perform a Cut-And-Count Analysis and compare to the Reference Analysis. The cuts used in the Reference Analysis are documented [??? here] and the results from the Reference Analysis are [??? here]. Can you improve the sensitivity with changes to the cuts or style of analysis? Can you do something other than the conversion search (e.g. measure a background)

Latest revision as of 19:16, 12 August 2025

This page and the linked tutorials are under construction. We are currently looking for feedback on Exercises 1, 2, 3a, and 3b. Let us know what you think on the #analysis-tools-tutorial Slack channel.

Introduction

This tutorial will lead you through using tools maintained by the Analysis Tools group in an analysis workflow.

By the end of these tutorials, you will be able to:

Exercises

1. Logging into and Using the Elastic Analysis Facility (EAF)

By the end of this tutorial, you will be able to:

  • access the EAF, and
  • open and use a python notebook on the EAF.

2. EventNtuple Basics

By the end of this tutorial, you will be able to:

  • describe the difference between single-object branches, vector branches, and vector-of-vector branches, and
  • find the leaf and branch definitions using either ntuplehelper or GitHub

3a. Analyzing the EventNtuple with ROOT (RooUtil)

By the end of this tutorial, you will be able to:

  • analyze EventNtuple datasets,
  • select subsets of the data, and
  • create histograms of selected data

in ROOT.

3b. Analyzing the EventNtuple with Python (pyutils)

By the end of this tutorial, you will be able to:

  • analyze EventNtuple datasets,
  • select subsets of the data, and
  • create histograms of selected data

in python.

[??? 4. Visualizing an interesting event with EventDisplay]

By the end of this tutorial, you will be able to:

  • TODO

[??? 5. Generating a Mock Dataset]

By the end of this tutorial, you will be able to:

  • generate a mock dataset

6. Performing a Cut-And-Count Analysis

Now that you have a mock dataset and can analyze EventNtuple files, you can now perform a Cut-And-Count Analysis and compare to the Reference Analysis. The cuts used in the Reference Analysis are documented [??? here] and the results from the Reference Analysis are [??? here]. Can you improve the sensitivity with changes to the cuts or style of analysis? Can you do something other than the conversion search (e.g. measure a background)