Abstract Inclusive Monte-Carlo samples are indispensable for signal selection and background suppression in many high energy physics experiments. A clear knowledge of the physics processes involved in the samples, including the types of processes and the number of processes in each type, is a great help to investigating signals and backgrounds. To help analysts obtain the physics process information from the truth information of the samples, we develop a physics process analysis program, TopoAna, with C++, ROOT, and LaTeX. The program implements the functionalities of component analysis and signal identification with many kinds of fine, customizable classification and matching algorithms. It tags physics processes in individual events accurately in the output root files, and exports the physics process information at the sample level clearly to the output plain text, tex source, and pdf files. 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 similar experiments is also prospective. Program summary Program title: TopoAna CPC Library link to program files: http://dx.doi.org/10.17632/hjg4d9c843.1 Licensing provisions: MIT Programming language: C++ Nature of problem: A clear knowledge of the physics processes involved in inclusive Monte-Carlo samples is a great help to investigating signals and backgrounds in many high energy physics experiments. However, the raw topology truth information of the samples is counter-intuitive, diverse, and overwhelming, which makes it difficult for analysts to check the physics process information of the samples directly. Solution method: Based on accurate pattern matching, many kinds of fine, customizable classification and matching algorithms are implemented in this program, in order to help analysts obtain the physics process information of the samples from their raw truth information. Unusual features: Besides the C++ Standard Template Library, this program makes use of ROOT [1], a C++ based data analysis software universally used in modern high energy physics experiments. In addition, the program employs the Linux command, pdflatex, to compile the tex source files into the pdf documents. References [1] ROOT User’s Guide, Available online: https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html .

中文翻译：

---

TopoAna：高能物理实验中包容性蒙特卡罗样本事件类型分析的通用工具

摘要 在许多高能物理实验中，包容性蒙特卡罗样本对于信号选择和背景抑制是必不可少的。清楚了解样品所涉及的物理过程，包括过程的类型和每种类型的过程数量，对研究信号和背景有很大帮助。为了帮助分析人员从样本的真实信息中获取物理过程信息，我们开发了物理过程分析程序TopoAna，采用C++、ROOT和LaTeX。该程序通过多种精细的、可定制的分类和匹配算法实现了组件分析和信号识别的功能。它在输出根文件中准确标记单个事件中的物理过程，并将样本级别的物理过程信息清晰地导出到输出的纯文本、tex源和pdf文件中。该程序独立于特定的软件框架，适用于许多实验。目前，它已经在三个e + e - 碰撞实验中使用：BESIII、Belle和Belle II实验。该程序在其他类似实验中的使用也是有前景的。程序摘要程序名称：TopoAna CPC 库程序文件链接：http://dx.doi.org/10.17632/hjg4d9c843.1 许可条款：麻省理工学院编程语言：C++ 问题性质：清楚地了解包容性所涉及的物理过程Monte-Carlo 样本对于研究许多高能物理实验中的信号和背景有很大帮助。然而，样本的原始拓扑真值信息是违反直觉的，种类繁多，势不可挡，这使得分析人员很难直接检查样品的物理过程信息。求解方法：该程序基于精确的模式匹配，实现了多种精细的、可定制的分类匹配算法，以帮助分析人员从其原始真值信息中获取样品的物理过程信息。不寻常的功能：除了C++标准模板库之外，该程序还使用了ROOT [1]，这是一种现代高能物理实验中普遍使用的基于C++的数据分析软件。此外，该程序使用Linux 命令pdflatex 将tex 源文件编译为pdf 文档。参考文献 [1] ROOT 用户指南，在线提供：https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html。并且铺天盖地，这使得分析人员很难直接查看样品的物理过程信息。求解方法：该程序基于精确的模式匹配，实现了多种精细的、可定制的分类匹配算法，以帮助分析人员从其原始真值信息中获取样品的物理过程信息。不寻常的功能：除了C++标准模板库之外，该程序还使用了ROOT [1]，这是一种现代高能物理实验普遍使用的基于C++的数据分析软件。此外，该程序使用Linux 命令pdflatex 将tex 源文件编译为pdf 文档。参考文献 [1] ROOT 用户指南，在线提供：https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html。并且铺天盖地，这使得分析人员很难直接查看样品的物理过程信息。求解方法：该程序基于精确的模式匹配，实现了多种精细的、可定制的分类匹配算法，以帮助分析人员从其原始真值信息中获取样品的物理过程信息。不寻常的功能：除了C++标准模板库之外，该程序还使用了ROOT [1]，这是一种现代高能物理实验中普遍使用的基于C++的数据分析软件。此外，该程序使用Linux 命令pdflatex 将tex 源文件编译为pdf 文档。参考文献 [1] ROOT 用户指南，在线提供：https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html。这使得分析人员很难直接检查样品的物理过程信息。求解方法：该程序基于精确的模式匹配，实现了多种精细的、可定制的分类匹配算法，以帮助分析人员从其原始真值信息中获取样品的物理过程信息。不寻常的功能：除了C++标准模板库之外，该程序还使用了ROOT [1]，这是一种现代高能物理实验中普遍使用的基于C++的数据分析软件。此外，该程序使用Linux 命令pdflatex 将tex 源文件编译为pdf 文档。参考文献 [1] ROOT 用户指南，在线提供：https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html。这使得分析人员很难直接检查样品的物理过程信息。求解方法：该程序基于精确的模式匹配，实现了多种精细的、可定制的分类匹配算法，以帮助分析人员从其原始真值信息中获取样品的物理过程信息。不寻常的功能：除了C++标准模板库之外，该程序还使用了ROOT [1]，这是一种现代高能物理实验中普遍使用的基于C++的数据分析软件。此外，该程序使用Linux 命令pdflatex 将tex 源文件编译为pdf 文档。参考文献 [1] ROOT 用户指南，在线提供：https://root.cern/root/htmldoc/guides/users-guide/ROOTUsersGuide.html。