steve-42 / topoana Goto Github PK

Abstract: Inclusive Monte-Carlo samples are indispensable for signal selection and background suppression in many high energy physics experiments. A clear knowledge of the topology of the samples, including the categories of physics processes and the number of processes in each category, is a great help to investigating signals and backgrounds. To help analysts get the topology information from the raw data of the samples, we develop a topology analysis program, TopoAna, with C++, ROOT, and LaTeX. The program implements the functionalities of component analysis and signal identification by recognizing, categorizing, counting, and tagging events. Independent of specific software frameworks, the program is applicable to many experiments. At present, it has come into use in three e+e- colliding experiments: the BESIII, Belle, and Belle II experiments. The use of the program in other experiments is also prospective. (Please contact me ([email protected]) if you want to employ the program for other experiments. Now, you can try the program with examples under the directory examples)

An essential description of the program is in the document: share/paper_draft_v1.1.pdf

A detailed description of the program is in the document: share/user_guide_v3.7.pdf

Here, we just briefly introduce how to install and use the program.

1. How to install the program

   1.1. Set up the package path with the following command: ./Configure

   • Notably, you are recommended to manually set up the environment variable PATH according to the guidelines printed out by the command.

   • Executing the command and setting the PATH once is sufficient, unless the package is moved.

   1.2. Compile the program with the following command: make

   • Executing the command once is sufficient, unless the C++ header, source, or script files are updated or revised, or the package is moved.

   1.3. Set up the experiment name with the following command: ./Setup ExpNm

   • Here, the formal argument ExpNm is short for experiment name, and the actual values supported at present are BESIII, Belle_II, or Example.

     • If you want to employ the program for the BESIII experiment, please execute: ./Setup BESIII.

     • If you want to employ the program for the Belle II experiment, please execute: ./Setup Belle_II.

     • If you want to try the program with examples under the directory examples, please execute: ./Setup Example.

   • Executing the command once is sufficient, unless you want to alter the targeted experiment.

2. How to use the program

   1.1. Prepare the input data

   • The input data of the program, namely the raw topology data of the inclusive MC samples, can be obtained with the interface to the program in the software system of your experiment. For the BESIII, Belle, and Belle II experiments, such interfaces have already been developed.

   1.2. Fill in the card file

   • You can refer to the template topoana card file: share/template_topoana.card.

   1.3. Execute the command line: topoana.exe cardFileName

   • The argument cardFileName is optional, and its default value is topoana.card.