Bookkeeping

在 Bookkeeping 中查找数据

了解数据在各 Gaudi 应用程序中的流向，是准确定位所需数据的关键。

数据在 “Bookkeeping” 中编目，首先按大类分组：真实物理数据；模拟数据；验证研究数据。随后，按应用及处理版本的树形结构继续细分，最终指向具体文件。

因此，运行首个 DaVinci 任务前需要先定位事例。本教程以衰变\( B_{s}^0 \to D_{s}^-\pi^+ \)为例，其中 \( D_{s}^+ \) 衰变为 \( K^+ K^- \pi^+ \)。

学习目标

  • 在 bookkeeping 中查找 MC
  • 在 bookkeeping 中查找真实数据
  • 找到所需衰变

通过 Data / Bookkeeping Browser 访问 bookkeeping，可同时浏览模拟数据和真实数据。

在"Bookkeeping tree"标签页底部，将 Simulation Condition 下拉菜单切换为 Event type 。此操作将按事件类型重组簿记树，便于文件定位。

我们将分析 2024 年数据，因此使用对应的 2024 年模拟数据。首先,导航至模拟数据，展开"Bookkeeping tree"窗口中的文件夹图标，再进入 MC/2024 目录，此处列出所有可用衰变类型的模拟数据。查找名称为以下格式的文件夹： 

13264021 (Bs_Dspi,KKpi=DecProdCut)
其中数字为事件类型的数值表示，文本为人类可读版本。

此模拟样本仅包含在 LHCb 接收器范围内生成的 \( B_s^{0} \to (D_{s}^- \to K^+ K^- \pi^+)\pi^+ \) 事件（衰变可能未被完全重建）。

当展开 13264021 (Bs_Dspi,KKpi=DecProdCut)文件夹后，可见多个子文件夹：名称对应不同数据采集条件（如磁极方向 MagDown/MagUp）；不同软件版本；模拟堆积量(nu)；特定模拟时间段（如2024.W37.39）本教程使用：Beam6800GeV2024.W37.39MagDownNu6.325nsPythia8 。

选择说明

通常仅需选择一两种数据采集条件与软件版本的组合，但本例中存在多种选项。建议优先选择最新版本，不确定时应咨询工作组Monte Carlo联络人。

选择模拟版本

此处仅提供 Sim10d（通常选择最新版本即可）。该目录下一般会出现 AnaProd（分析产物输出子目录）及实际数据(HLT2.DST)。

https://lhcb-starterkit-run3.docs.cern.ch/first-analysis-steps/analysis-productions/

标记样本 vs 过滤样本

常规数据采集中，触发和剥离以过滤模式运行，未通过触发线或剥离线的事件将被丢弃。模拟中常需保留这些事件以研究被拒事件特性，此时触发和剥离以标记模式运行（仅记录决策）。过滤蒙特卡洛样本适用于需要大量事件的分析。本教程使用标记样本（Flagged MC）。

点击 HLT2.DST 条目后显示可处理文件列表。页面右下角的 Save 按钮可下载指定输入文件的配置文件（用于 DaVinci 任务）。

  1. 点击 Save

  2. 选择 Save as a python file

  3. 在弹出菜单中再次点击 Save 开始下载

保存此文件至可访问位置。

示例文件路径：

/eos/lhcb/wg/dpa/wp7/Run3SK/exampleDST/MC_2024_13264021_Beam6800GeV2024.W37.39MagDownNu6.325nsPythia8_Sim10d_HLT22024.W35.39_HLT2.DST.py

快捷导航

熟悉簿记系统后，可在浏览器底部绿色"+"符号旁的文本框中直接输入路径：

evt+std://MC/2024/13264021/Beam6800GeV-2024.W35.37-MagUp-Nu6.3-25ns-Pythia8/Sim10d/HLT2-2024.W35.39 输入后点击 Go 按钮直达目标。

查找自定义衰变

尝试查找特定衰变的Monte Carlo样本（如分析目标衰变）。若无具体想法，可查找半轻子衰变 \( B^{0} \to D^{+}\mu^{-}\bar{\nu}_{\mu} \) ，其中 \( D^{+} \) 衰变为 \( K^{+}\pi^{-}\pi^{-} \) 。

了解事件类型如何定义信号衰变，请参阅 DecFiles 包文档。