TopoAna: A generic tool for the event type analysis of inclusive Monte-Carlo samples in high energy physics experiments

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.

28 pages, 5 figures, accepted by "Computer Physics Communications". The program described by the paper is available at https://github.com/buaazhouxingyu/topoana

References in corpus (4)

• The Belle II Physics Book
• Future Physics Programme of BESIII
• Physics Performance Report for PANDA: Strong Interaction Studies with Antiprotons
• Gauge Invariant Lagrangians for Free and Interacting Higher Spin Fields. A Review of the BRST formulation

Cited by in corpus (101)

• Search for an axion-like particle in radiative $J/\psi$ decays
• Measurement of cross-section for $e^{+}{e}^{-}\to {\Xi }^{-}{\bar{\Xi }}^{+}$ near threshold at BESIII
• Observation of ${\Xi }^{-}$ Hyperon Transverse Polarization in $\psi (3686)\to {\Xi }^{-}{\bar{\Xi }}^{+}$
• Model independent determination of the spin of the ${\Omega }^{-}$ and its polarization alignment in $\psi (3686)\to {\Omega }^{-}{\bar{\Omega }}^{+}$
• Measurements of the branching fractions of ${\Lambda }_c^{+}\to p\eta$ and ${\Lambda }_c^{+}\to p{\pi }^0$ decays at Belle
• First test of Lepton Flavor Universality in the charmed baryon decays ${\Omega }_c^0\to {\Omega }^{-}{\ell }^{+}{\nu }_{\ell }$ using data of the Belle experiment
• Evidence of a new excited charmed baryon decaying to ${\Sigma }_c(2455{)}^{0,++}{\pi }^{\pm }$
• Study of the resonance structures in $e^{+}{e}^{-}\to {\pi }^{+}{\pi }^{-}J/\psi$ process
• Search for the decay $D^0\to {\pi }^0\nu \bar{\nu }$
• Partial wave analysis of $J/\psi \to \gamma {\eta }^{\prime }{\eta }^{\prime }$
• First simultaneous measurement of ${\Xi }^0$ and ${\bar{\Xi }}^0$ asymmetry parameters in $\psi (3686)$ decay
• Study of $e^{+}{e}^{-}\to {\Omega }^{-}{\bar{\Omega }}^{+}$ at center-of-mass energies from 3.49 to 3.67 GeV
• Cross section measurement of $e^{+}{e}^{-}\to K_S^0{K}_L^0$ at $\sqrt{s}=2.00-3.08\mathrm{GeV}$
• Test of $CP$ Symmetry in Hyperon to Neutron Decays
• Observation of a New $X(3872)$ Production Process $e^{+}{e}^{-}\to \omega X(3872)$
• Measurement of the Branching Fraction of the Singly Cabibbo-Suppressed Decay ${\Lambda }_c^{+}\to \Lambda K^{+}$
• Search for di-photon decays of an axion-like particle in radiative $J/\psi$ decays
• Precision Measurement of the Decay ${\Sigma }^{+}\to p\gamma$ in the Process $J/\psi \to {\Sigma }^{+}{\bar{\Sigma }}^{-}$
• Observation of $\Omega (2012{)}^{-}\to \Xi (1530)\bar{K}$ and measurement of the effective couplings of $\Omega (2012{)}^{-}$ to $\Xi (1530)\bar{K}$ and $\Xi \bar{K}$
• Search for new decay modes of the ${\psi }_2(3823)$ and the process $e^{+}{e}^{-}\to {\pi }^0{\pi }^0{\psi }_2(3823)$
• Search for a $CP$-odd light Higgs boson in $J/\psi \to \gamma A^0$
• Measurement of $\psi (3686)\to \Lambda \bar{\Lambda }\eta$ and $\psi (3686)\to \Lambda \bar{\Lambda }{\pi }^0$ decays
• First Measurement of the Absolute Branching Fraction of $\Lambda \to p{\mu }^{-}{\bar{\nu }}_{\mu }$
• Study of excited $\Xi$ states in $\psi (3686)\to K^{-}\Lambda {\overline{\Xi }}^{+}+c.c.$
• Observation of $\psi (3686)\to \Xi (1530{)}^0\bar{\Xi }(1530{)}^0$ and $\Xi (1530{)}^0{\bar{\Xi }}^0$
• Search for the rare semi-leptonic decay $J/\psi \to D^{-}{e}^{+}{\nu }_e+c.c.$
• Observation of $J/\psi$ Electromagnetic Dalitz Decays to $X(1835)$, $X(2120)$ and $X(2370)$
• Search for the hyperon semileptonic decay ${\Xi }^{-}\to {\Xi }^0{e}^{-}\overline{{\nu }_e}$
• Search for a massless particle beyond the Standard Model in the ${\Sigma }^{+}\to p+\mathrm{invisible}$ decay
• Search for tetraquark states $X_{cc\bar{s}\bar{s}}$ in $D_s^{+}{D}_s^{+}(D_s^{\ast +}{D}_s^{\ast +})$ final states at Belle
• Search for a doubly-charged $DDK$ bound state in ${\rm Y}(1S,2S)$ inclusive decays and via direct production in $e^{+}{e}^{-}$ collisions at $\sqrt{s}$ = 10.520, 10.580, and 10.867 GeV
• Study of the processes ${\chi }_{cJ}\to {\Xi }^{-}{\bar{\Xi }}^{+}$ and ${\Xi }^0{\bar{\Xi }}^0$
• Measurements of Born Cross Sections of $e^{+}{e}^{-}\to D_s^{\ast +}{D}_{sJ}^{-}+c.c.$
• Measurements of branching fractions of ${\Lambda }_c^{+}\to {\Sigma }^{+}\eta$ and ${\Lambda }_c^{+}\to {\Sigma }^{+}{\eta }^{\prime }$ and asymmetry parameters of ${\Lambda }_c^{+}\to {\Sigma }^{+}{\pi }^0$, ${\Lambda }_c^{+}\to {\Sigma }^{+}\eta$, and ${\Lambda }_c^{+}\to {\Sigma }^{+}{\eta }^{\prime }$
• Search for the semi-muonic charmonium decay $J/\psi \to D^{-}{\mu }^{+}{\nu }_{\mu }+c.c.$
• Measurement of $e^{+}{e}^{-}\to \Lambda \bar{\Lambda }\eta$ from 3.5106 to 4.6988 GeV and study of $\Lambda \bar{\Lambda }$ mass threshold enhancement
• Observation of the $J/\psi$ and $\psi (3686)$ decays into $\eta {\Sigma }^{+}{\bar{\Sigma }}^{-}$
• Measurement of the branching fraction of ${\Lambda }_c^{+}\to p\omega$ decay at Belle
• Search for the decay ${\chi }_{c1}(3872)\to {\pi }^{+}{\pi }^{-}{\chi }_{c1}$
• Updated measurements of the M1 transition $\psi (3686)\to \gamma {\eta }_c(2S)$ with ${\eta }_c(2S)\to K\bar{K}\pi$
• Measurements of branching fractions and asymmetry parameters of ${\Xi }_c^0\to \Lambda {\bar{K}}^{\ast 0}$, ${\Xi }_c^0\to {\Sigma }^0{\bar{K}}^{\ast 0}$, and ${\Xi }_c^0\to {\Sigma }^{+}{K}^{\ast -}$ decays at Belle
• Measurements of the branching fractions of ${\Xi }_c^0\to {\Xi }^0{\pi }^0$, ${\Xi }_c^0\to {\Xi }^0\eta$, and ${\Xi }_c^0\to {\Xi }^0{\eta }^{\prime }$ and asymmetry parameter of ${\Xi }_c^0\to {\Xi }^0{\pi }^0$
• Evidence for ${\eta }_c$(2S)$\to\pipieta$ decay
• First observation of ${\Lambda }_c^{+}\to \Lambda K^{+}{\pi }^0$ and evidence of ${\Lambda }_c^{+}\to \Lambda K^{+}{\pi }^{+}{\pi }^{-}$
• Stringent test of $CP$ symmetry in ${\Sigma }^{+}$ hyperon decays
• Novel method to extract the femtometer structure of strange baryons using the vacuum polarization effect
• Observation of the charmonium decay ${\eta }_c\to \gamma \gamma$ in $J/\psi \to \gamma {\eta }_c$
• First Measurement of the ${\Lambda }_c^{+}\to p{\eta }^{\prime }$ decay
• Measurement of the branching fraction of ${\Xi }_c^0\to {\Lambda }_c^{+}{\pi }^{-}$ at Belle
• Improved measurement of the decays ${\eta }^{\prime }\to {\pi }^{+}{\pi }^{-}{\pi }^{+(0)}{\pi }^{-(0)}$ and search for the rare decay ${\eta }^{\prime }\to 4{\pi }^0$
• Search for the massless dark photon with $D^0\to \omega {\gamma }^{\prime }$ and $D^0\to \gamma {\gamma }^{\prime }$
• Measurement of Branching Fractions of $J/\psi$ and $\psi (3686)$ decays to ${\Sigma }^{+}$ and ${\overline{\Sigma }}^{-}$
• Search for baryon and lepton number violation decay $D^{\pm }\to n(\bar{n})e^{\pm }$
• Observations of the singly Cabibbo-suppressed decays ${\Xi }_c^{+}\to p{K}_S^0$, ${\Xi }_c^{+}\to \Lambda {\pi }^{+}$, and ${\Xi }_c^{+}\to {\Sigma }^0{\pi }^{+}$ at Belle and Belle II
• Observation of ${\chi }_{cJ}\to \Lambda \bar{\Lambda }\eta$
• Precise measurement of the branching fractions of $J/\psi \to \bar{\Lambda }{\pi }^{+}{\Sigma }^{-}+c.c.$ and $J/\psi \to \bar{\Lambda }{\pi }^{-}{\Sigma }^{+}+c.c.$
• Search for the semi-leptonic decays ${\Lambda }_c^{+}\to \Lambda {\pi }^{+}{\pi }^{-}{e}^{+}{\nu }_e$ and ${\Lambda }_c^{+}\to p{K}_S^0{\pi }^{-}{e}^{+}{\nu }_e$
• Measurement of the absolute branching fraction of the inclusive decay ${\Lambda }_c^{+}\to K_S^{0}X$
• Search for baryon and lepton number violating decays of ${\Xi }^0$ hyperons
• Observation of the decays $B^{+}\to {\Sigma }_c(2455{)}^{++}{\overline{\Xi }}_c^{-}$ and $B^0\to {\Sigma }_c(2455{)}^0{\overline{\Xi }}_c^0$
• First search for the weak radiative decays ${\Lambda }_c^{+}\to {\Sigma }^{+}\gamma$ and ${\Xi }_c^0\to {\Xi }^0\gamma$
• Search for the ${\eta }_{c2}(1D)$ in $e^{+}{e}^{-}\to \gamma {\eta }_{c2}(1D)$ at $\sqrt{s}$ near 10.6 GeV at Belle
• Search for a light Higgs boson in single-photon decays of ${\rm Y}(1S)$ using ${\rm Y}(2S)\to {\pi }^{+}{\pi }^{-}{\rm Y}(1S)$ tagging method
• Observation of $J/\psi$ decays to $e^{+}{e}^{-}{e}^{+}{e}^{-}$ and $e^{+}{e}^{-}{\mu }^{+}{\mu }^{-}$
• Observation of the decays ${\chi }_{cJ}\to n{K}_S^0\bar{\Lambda }+c.c.$
• Search for the lepton number violation decay $\varphi \to {\pi }^{+}{\pi }^{+}{e}^{-}{e}^{-}$ via $J/\psi \to \varphi \eta$
• Sensitivity Study of the Tau Lepton Electric Dipole Moment at the Super Tau-Charm Facility
• Partial wave analysis of $\psi (3686)\to \Lambda {\bar{\Sigma }}^0{\pi }^0+c.c.$
• Observation of $\psi (3686)\to 3\varphi$
• Observation of the $\psi (3686)$ decays into ${\Sigma }^{+}{\bar{\Sigma }}^{-}\omega$ and ${\Sigma }^{+}{\bar{\Sigma }}^{-}\varphi$
• First measurements of the branching fractions for the decay modes ${\Xi }_c^0\to \Lambda \eta$ and ${\Xi }_c^0\to \Lambda {\eta }^{\prime }$ and search for the decay ${\Xi }_c^0\to \Lambda {\pi }^0$ using Belle and Belle II data
• Observation of $e^{+}{e}^{-}\to pp\bar{p}\bar{n}{\pi }^{-}+c.c.$
• Observation of $e^{+}{e}^{-}\to {\pi }^0{\pi }^0{\psi }_2(3823)$
• Observation of the decay $\psi (3686)\to {\Sigma }^{-}{\bar{\Sigma }}^{+}$ and measurement of its angular distribution
• Search for charmed baryons in the ${\Lambda }_c^{+}\eta$ system and measurement of the branching fractions of ${\Lambda }_c(2880{)}^{+}$ and ${\Lambda }_c(2940{)}^{+}$ decaying to ${\Lambda }_c^{+}\eta$ and $p{D}^0$ relative to ${\Sigma }_c(2455)\pi$
• Search for the weak decay $\psi (3686)\to {\Lambda }_c^{+}{\bar{\Sigma }}^{-}+c.c$
• Observation of the decay $h_c\to 3({\pi }^{+}{\pi }^{-}){\pi }^0$
• Study of the decay ψ(3686) \to Σ^{0}\barΣ^{0}ϕ
• Study of the decays ${\chi }_{cJ}\to \Lambda \bar{\Lambda }\varphi$
• Measurement of the branching fraction for $\psi (3686)\to \omega K_S^0{K}_S^0$
• Search for the isospin-violating decays ${\mathbf{\chi }}_{\mathbf{cJ}}\to \mathbf{\Lambda }{\bar{\mathbf{\Sigma }}}^0+\mathbf{c}.\mathbf{c}.$ and ${\mathbf{\eta }}_{\mathbf{c}}\to \mathbf{\Lambda }{\bar{\mathbf{\Sigma }}}^0+\mathbf{c}.\mathbf{c}.$
• Observation of the radiative decay $D_s(2317{)}^{+}\to D_s^{\ast }\gamma$
• Measurement of the cross section of $e^{+}{e}^{-}\to \eta {\pi }^{+}{\pi }^{-}$ at center-of-mass energies from 3.872 GeV to 4.700 GeV
• Study of $f_1(1420)$ and $\eta (1405)$ in the decay $J/\psi \to \gamma {\pi }^0{\pi }^0{\pi }^0$
• Search for the semileptonic decays ${\Xi }_c^0\to {\Xi }^0{\ell }^{+}{\ell }^{-}$ at Belle
• Search for the decay $h_c\to {\pi }^{0}J/\psi$
• First measurements of the branching fractions of $J/\psi \to {\Xi }^0\bar{\Lambda }{K}_S^0+c.c.$, $J/\psi \to {\Xi }^0{\bar{\Sigma }}^0{K}_S^0+c.c.$, and $J/\psi \to {\Xi }^0{\bar{\Sigma }}^{-}{K}^{+}+c.c.$
• Search for the baryon number and lepton number violating decays ${\tau }^{-}\to \Lambda {\pi }^{-}$ and ${\tau }^{-}\to \bar{\Lambda }{\pi }^{-}$ at Belle II
• Observation of ${\chi }_{cJ}\to p\bar{p}{K}_S^0{K}^{-}{\pi }^{+}+c.c.$
• Search for the Cabibbo-suppressed decays ${\Lambda }_c^{+}\to {\Sigma }^0{K}^{+}{\pi }^0$ and ${\Lambda }_c^{+}\to {\Sigma }^0{K}^{+}{\pi }^{+}{\pi }^{-}$
• Measurements of the branching fractions of ${\Xi }_c^{+}\to {\Sigma }^{+}{K}_S^0$, ${\Xi }_c^{+}\to {\Xi }^0{\pi }^{+}$, and ${\Xi }_c^{+}\to {\Xi }^0{K}^{+}$ at Belle and Belle II
• Observation of $\psi (3686)\to {\Xi }^{-}{K}_S^0{\bar{\Omega }}^{+}$+c.c
• Search for a dark baryon in the ${\Xi }^{-}\to {\pi }^{-}+\mathrm{invisible}$ decay
• Search for the lepton number violating decay $\eta \to {\pi }^{+}{\pi }^{+}{e}^{-}{e}^{-}+c.c.$ via $J/\psi \to \varphi \eta$
• Precise Measurement of Chromoelectric Dipole Moment of the Charm Quark
• Search for hyperon $\Delta S=\Delta Q$ violating decay ${\Xi }^0\to {\Sigma }^{-}{e}^{+}{\nu }_e$
• Observation of the decay $\psi (3686)\to {\Sigma }^0{\bar{\Sigma }}^0\omega$
• Measurements of the branching fractions of the $P$-wave charmonium spin-singlet state $h_c{(}^1{P}_1)\to h^{+}{h}^{-}{\pi }^0/\eta$
• Amplitude Analysis of the Isospin-Violating Decay $J/\psi \to \gamma \eta {\pi }^0$
• Observation of ${\Lambda }_c^{+}\to n{\pi }^{+}\eta$ and search for ${\Lambda }_c^{+}\to n{a}_0(980{)}^{+}$
• Observation of ${\chi }_{cJ}(J=0,1,2)\to p\bar{p}\eta \eta$