1事例格式.docVIP

BESIII在线数据格式说明 V1.1 2007.4.26 BESIII DAQ Group  目录 目录 2 1 事例格式 3 1.1 通用格式 3 1.2 事例片断头部格式 4 1.3 ROD片段格式 6 1.4 其他片段格式 6 1.4.1 ROB对ROD的封装 6 1.4.2 读出PC级（ROS） 2 1.4.3 探测器级Sub-detector 2 1.4.4 完整事例 3 2 数据单元格式定义 3 2.1 MDC 3 2.2 TOF 4 2.3 EMC 4 2.4 MUC 4 3 数据文件结构 4 3.1 文件名 4 3.2 文件结构 5 3.3 文件示例 7  事例格式 BESIII实验的数据获取系统（DAQ）是在ATLAS TDAQ软件基础上开发的，在线数据事例格式也参考了ATLAS实验的事例格式。 通用格式 BESIII DAQ的一个完整事例的格式如图1所示。事例格式建立在片断（Fragment）的基础上：一个完整事例由一或多个子探测器片断（Sub-detector Fragment）构成；每个子探测器片断由一个或多个ROS片断（ROS Fragment）构成；每个ROS片断由一个或多个ROB片断（ROB Fragment）构成；每个ROB片断包含一个ROD片断；ROD片段比较特殊，和其它片段有较大不同。每个片断均含有自身的头部（Header）。 图1 完整事例的通用格式 如图2所示为事例格式实现的类图。相应于完整事例、子探测器、ROS和ROB这些对象的差别，其各自的事例片断类：FullEventFragment，SubDetectorFragment，ROSFragment和ROBFragment也有所不同，但是它们的组织结构是相同的：头部（header）+数据区（data）。因此很自然地这些事例片断类都继承了头部类。它们包含在名字空间eformat中，定义在eformat库中。 ROB和ROD的对应是个例外，一个ROB固定封装一个ROD，它们可以等价看待。只有ROD包含的才是具体的以32位为单元的探测器击中信息。 图2 事例格式的类图 如图3为在线事例层次结构与硬件的对应关系。 图3 层次与硬件的对应关系 事例片断头部格式 头部分为通用部分和专用部分。前者在所有的事例片断类中都存在，而后者则根据事例片断类型的不同而不同。 事例片段通用头部格式如图4所示，各个字段含义分别介绍如下： 图4 事例片段通用头部格式 Header marker头部标记，指示一个fragment的开始。不同的fragment的标记不同，详见eformat/HeadMarker.h文件： enum HeaderMarker { ROD = 0xee1234ee, /// ROD标记 ROB = 0xdd1234dd, /// ROB标记 ROS = 0xcc1234cc, /// ROS标记 SUB_DETECTOR = 0xbb1234bb, ///子探测器标记 FULL_EVENT = 0xaa1234aa ///完整事例标记 }; Fragment size和Header size顾名思义，前者是整个事例片断的大小，包括头部和数据，后者只是头部的大小。两者均以字为单位计数。 Format version Number，事例格式的版本号。目前最新的事例格式版本号是3.0，不同版本的事例格式有略微区别。当处理到有区别的地方时，软件会做版本号的判断，以防止程序出错。 Source identifier，该域指明了事例的来源。如它包含了两部分信息：子探测器ID号和模块ID号。这两个值的组合在整个BESIII DAQ软件中能唯一标明事例来源。 表1 Source identifier格式 字节位置 3 2 1 0 内容 保留 子探测器ID号 模块ID号 子探测器ID已经事先静态分配了，如表2所示。由于事例筛选将追加数据到事例数据中，追加的数据内容以一个单独的子探测片断的方式添加，该片断的子探测器ID定义为0x7C，Source identifier一般为0x7C0000。 表2 子探测器ID号定义 探测器类型 EF MDC TOF EMC MUC TRG ID值 0x7C 0xA1 0xA2 0xA3 0xA4 0xA5 在ROB和ROD一级，模块ID号也就是PowerPC的编号。 Number of status elements，status element的数目。 Status element，描述了事例片断中数据的状态。该字段由构造这个事例片断的软件模块负责定义和填写。 Number of fragment sp