Download MAUS Analysis User System User Guide

Contents
1 What Who and How?
1.1 Who Should Use MAUS . . . . . . . . . . . . . . . . . . . . . .
1.2 Getting the Code and Installing MAUS . . . . . . . . . . . . .
1.3 Citing MAUS . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.4 Running MAUS . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.4.1 Run Control . . . . . . . . . . . . . . . . . . . . . . . .
1.4.2 Other Applications . . . . . . . . . . . . . . . . . . . . .
1.4.3 Choosing the Unpacker Version . . . . . . . . . . . . . .
1.5 Accessing Data . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.5.1 Loading ROOT Files in Python Using PyROOT . . . .
1.5.2 Loading ROOT Files in C++ Compiled Analysis Code .
1.5.3 Loading ROOT Files on the ROOT Command Line . .
.
.
.
.
.
.
.
.
.
.
.
3
3
3
3
4
4
5
5
5
5
6
6
2 Using and Modifying the Data Structure
2.1 Metadata . . . . . . . . . . . . . . . . . .
2.2 The Spill Datastructure . . . . . . . . . .
2.3 Image Datastructure . . . . . . . . . . . .
2.4 Accessing ROOT files . . . . . . . . . . .
2.5 Conversion to, and Working With, JSON
2.6 Extending the Data Structure . . . . . . .
2.6.1 Pointer Handling . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
8
8
10
11
12
12
12
13
3 Introduction to the MAUS API
3.1 Motivation . . . . . . . . . . . . . . . . . .
3.2 Everything starts with a ‘Module’ . . . . .
3.3 Inheritance . . . . . . . . . . . . . . . . . .
3.4 Data Mangling . . . . . . . . . . . . . . . .
3.5 Module Initialisation and Destruction . . .
3.6 Global Objects - Objects for Many Modules
3.6.1 Global Object Initialisation . . . . .
3.7 Internal Classes . . . . . . . . . . . . . . . .
3.7.1 Abstraction Layers . . . . . . . . . .
3.7.2 C++ Python Wrapper . . . . . . . .
3.7.3 Data Mangling . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
15
15
15
16
16
16
17
17
17
17
18
18
2