7. Analysis

The analysis package collects modules and tools for high-level analysis of Belle II data. With analysis modules you are able to open mdst format files, create final state particles, and build more complicated decays. With these particle decay candidates, you can use high level tools such as Tree Fitter, Flavor Tagger, and the Full event interpretation (FEI).

Tip

For a series of hands-on introductory lessons, take a look at Section 3.4.

The core data objects of the basf2 analysis package, are the Particle class, and the ParticleList class. Almost all analysis modules are concerned with the manipulation of ParticleList s.

Examples of analysis steering files can be found in tutorial directory of analysis package:

ls $BELLE2_RELEASE_DIR/analysis/examples/tutorials

• 7.1. Particles
  • 7.1.1. Standard Particles
  • 7.1.2. DecayString
  • 7.1.3. Cut strings and selections
• 7.2. Modular analysis convenience functions
  • 7.2.1. ModularAnalysis
  • 7.2.2. Photon functions
• 7.3. Variables
  • 7.3.1. VariableManager
  • 7.3.2. Variables by group
  • 7.3.3. Collections and Lists
  • 7.3.4. Operations with variable lists
  • 7.3.5. Miscellaneous helpers for using variables
  • 7.3.6. Writing your own variable
• 7.4. Output for offline analysis
  • 7.4.1. Variable Manager Output
  • 7.4.2. (Advanced) user mDST files
• 7.5. Vertex (and kinematic) fitting
  • 7.5.1. Tree Fitter
  • 7.5.2. Other vertex (and kinematic) fitters in basf2
  • 7.5.3. Vertex-fitting convenience functions
  • 7.5.4. Kinematic-fitting convenience functions
• 7.6. Event based analysis
  • 7.6.1. VariablesToEventBasedTree
  • 7.6.2. Event based selection
• 7.7. Truth-matching
  • 7.7.1. MC matching
  • 7.7.2. MC decay finder module ParticleCombinerFromMC
  • 7.7.3. MC decay finder module MCDecayFinder
  • 7.7.4. MC decay string
  • 7.7.5. Generated decay modes
  • 7.7.6. Tau decay MC modes
  • 7.7.7. Track matching
  • 7.7.8. Photon matching
  • 7.7.9. Topology analysis
• 7.8. Advanced Topics
  • 7.8.1. Rest Of Event
  • 7.8.2. How to Veto
  • 7.8.3. Flavor Tagger
  • 7.8.4. Deep Flavor Tagger
  • 7.8.5. Full event interpretation
  • 7.8.6. Graph-based Full Event Interpretation
  • 7.8.7. EventShape
  • 7.8.8. Continuum suppression
  • 7.8.9. Basf2 MVA interface
  • 7.8.10. PID Prior Probabilities
  • 7.8.11. ksSelector
  • 7.8.12. PID Calibration Weights
  • 7.8.13. Signal Embedding
  • 7.8.14. Offline reweighting
• 7.9. Full list of analysis modules