Next:
Contents
Contents
MAUS Analysis User System
User Guide
Contents
What Who and How?
Who Should Use MAUS
Getting the Code and Installing MAUS
Citing MAUS
Running MAUS
Run Control
Other Applications
Choosing the Unpacker Version
Accessing Data
Loading ROOT Files in Python Using PyROOT
Loading ROOT Files in C++ Compiled Analysis Code
Loading ROOT Files on the ROOT Command Line
Using and Modifying the Data Structure
Metadata
The Spill Datastructure
Image Datastructure
Accessing ROOT files
Conversion to, and Working With, JSON
Extending the Data Structure
Pointer Handling
Pointer Resolution
Introduction to the MAUS API
Motivation
Everything starts with a `Module'
Inheritance
Data Mangling
Module Initialisation and Destruction
Global Objects - Objects for Many Modules
Global Object Initialisation
Internal Classes
Abstraction Layers
C++ Python Wrapper
Data Mangling
Utilities
Logging
Running the Monte Carlo
Beam Generation
Beam Polarisation
Amplitude Momentum Correlation
Getting the Right Answer
Geometry
Tracking
Energy Deposition and Showering
GEANT4 Bindings
Geometry
Geometry Access Scripts
Using the Geometry Download Executables
A Little GDML
Define
Materials
Solids
Structure
Additional Features and Sensitive Detectors
Creation of New Geometries in MAUS
How to Define a Geometry
Configuration File
Substitutions
Expressions
Expression Substitutions
Module Files
Volume and Dimensions
Properties
Child Modules
Module Hierarchy and GEANT4 Physical Volumes
A Sample Configuration File
A Sample Child Module File
Geometry and Tracking MiceModule Properties
General Properties
Sensitive Detectors
Scintillating Fibre Detector (SciFi)
Cerenkov Detector (CKOV)
Time Of Flight Counter (TOF)
Special Virtual Detectors
Virtual Detectors
Envelope Detectors
Unconventional Volumes
Trapezoid Volume
Volume Wedge
Volume Polycone
Volume Quadrupole
Volume Multipole
Volume Boolean
Volume Sphere
Repeating Modules
Beam Definition and Beam Envelopes
Optimiser
Field Properties
FieldType CylindricalField
FieldType RectangularField
FieldType Solenoid
FieldType FieldAmalgamation
FieldType DerivativesSolenoid
Phasing Models
Tracking Stability Around RF Cavities
FieldType PillBox
FieldType RFFieldMap
FieldType Multipole
FieldType CombinedFunction
EndFieldTypes
FieldType MagneticFieldMap
MAUStext Field Map Format
g4bl3dGrid Field Map Format
TOF Detector
Simulation
Digitization
Reconstruction
Database
The Trackers
Introduction
Overview
Quick start guide
Definitions
Labelling of upstream and downstream trackers
Station numbering
Doublet layer
Doublet-layer numbering
Fibre-channel numbering
Reference surfaces and coordinate systems
Doublet layer
Station
Tracker
Coordinate transformations
Doublet-layer to station
Reconstruction Algorithms
Hits and clusters
Space-point reconstruction
Selection of clusters that form the space-point
Crossing-position calculation
Pattern recognition
Straight-line pattern recognition
Helix pattern recognition
Track fit
Data structure
Code Design
General Code Structure
MapCppTrackerDigits
MapCppTrackerMCDigitisation
MapCppTrackerRecon
ReduceCppPatternRecognition
Reducer Backend
Tracker configuration variables
The Monte Carlo
Station Geometry
MC VLPC Dark Count
Building Digits
Global Track Matching
Purpose
Process
4th Order Runge-Kutta Propagation
TOF1, TOF2, KL
TOF0
Cherenkov Detectors
EMR
Upstream-Downstream Matching
Usage
Configuration
Global PID
Introduction
Using the PID scripts
Producing PDFs
Performing PID with pre-existing hypotheses
MapCppGlobalPID and ReduceCppGlobalPID
MapCppGlobaPID
ReduceCppGlobalPID
PID Variables
PID Base Class
PID Variable Classes
ComPIDVars
PIDVars
Adding PID Variables
Placing cuts on PIDVar value ranges
Accessing Global Tracks
The PrimaryChain Object
Identifying Decay Candidates
Tracks and Space Points from Local Reconstruction
The Envelope Tool
Example Usage
Envelope Tool main window
Beam Setup
Magnet Setup
Plot Setup
G4beamline-MAUS Integration
Appendix C: Tracker Appendices
Kuno's Conjecture
Space-point variance
Circle parameters from three points
Helical Track Pattern Recognition
About this document ...
root 2018-06-24