Belle 2 Software Documentation

This document contains documentation of the Belle 2 Software, its command line tools and the Python API.

Note

Generated on Jan 04, 2022 for release release-05-02-19, commit d29a80143a.

This Documentation is not yet complete. In case of questions regarding the Belle 2 Software or for additional information, please

• look at the Confluence Pages

• check Belle 2 Questions

---

• 1. What’s New
• 2. Installation and Setup
  • 2.1. Belle II Software Tools
  • 2.2. Local Installation
  • 2.3. Setup of the Belle II Software
• 3. Command Line Tools
  • 3.1. basf2: The Main Belle2 Software Executable
  • 3.2. Tools for file handling
  • 3.3. Testing Tools
  • 3.4. Tools which will provide you help
  • 3.5. Tools to help with debugging and checking code quality
  • 3.6. b2conditionsdb: Conditions DB interface
  • 3.7. Tools for luminosity
• 4. Belle II Python Interface
  • 4.1. Modules and Paths
  • 4.2. Logging
  • 4.3. Module Statistics
  • 4.4. Conditions Database
  • 4.5. Additional Functions
  • 4.6. Other Modules
• 5. List of Core Modules
• 6. Analysis
  • 6.1. Particles
  • 6.2. Modular analysis convenience functions
  • 6.3. Variables
  • 6.4. Output for offline analysis
  • 6.5. Event-based analysis
  • 6.6. Truth-matching
  • 6.7. Advanced Topics
  • 6.8. Full list of analysis modules
• 7. B2BII
  • 7.1. b2biiConversion
  • 7.2. b2biiMonitors
• 8. Background module
• 9. Calibration
  • 9.1. Calibration Framework (CAF)
  • 9.2. Prompt Calibration
• 10. Event Generators
  • 10.1. The generators Python Module
  • 10.2. Modules in the Generators Package
• 11. Tools for Validation of the SoftwareTrigger
  • 11.1. b2hlt_combine_results.py
• 12. KLM (\(K_{L}^0\) and Muon Detector)
  • 12.1. Modules
  • 12.2. Clusterization
  • 12.3. Muon identification
  • 12.4. Calibration
  • 12.5. Tools
• 13. Belle II File Format
  • 13.1. Python interface
  • 13.2. C++ dataobjects
  • 13.3. ROOT and compatibility guarantee
• 14. MVA package
  • 14.1. Overview
  • 14.2. Supported frameworks/backends
  • 14.3. Using the mva package
  • 14.4. How to upload/download the training into the database
  • 14.5. Examples
  • 14.6. Contributions
  • 14.7. Python-based frameworks
  • 14.8. Backward Compatibility
  • 14.9. Reading List
• 15. Reconstruction
  • 15.1. Functions in reconstructions.py
• 16. Simulation
  • 16.1. Geant4 version in the externals library
  • 16.2. Physics list for Geant4
  • 16.3. Secondary particles
  • 16.4. FullSim
  • 16.5. Functions in simulation.py
• 17. Skims
  • 17.1. Systematics skims
  • 17.2. Physics skims
  • 17.3. Standard skim lists
  • 17.4. Information for skim experts
• 18. TRG
  • 18.1. Functions in mdst.py
• 19. Tools for Physics Validation of the Software
  • 19.1. Command line utilities
  • 19.2. Convenience Functions
• 20. How to document your code with Sphinx
  • 20.1. Documentation of Python Code
  • 20.2. Referencing Components
  • 20.3. Inserting Figures
  • 20.4. Documentation of Variables and Modules in C++
  • 20.5. Google Style Docstrings
  • 20.6. Add Basf2 Modules Documentation to Sphinx
  • 20.7. Add Basf2 Variables Documentation to Sphinx
  • 20.8. Additional Features
  • 20.9. Additional boxes for the online lessons
  • 20.10. How to test locally
• 21. Online textbook
  • 21.1. Welcome!
  • 21.2. Fundamentals
  • 21.3. Software Prerequisites
  • 21.4. Working with Belle II software.
  • 21.5. Offline analysis
  • 21.6. Data model and computing
  • 21.7. Join us

Indices and tables

• Index

• Module Index

• Basf2 Module Index

• Basf2 Variable Index

• Search Page