event formation unit

事件形成單位

此專案實作將中子探測器事件資料處理為中子事件。用於處理來自 Gd-GEM、Muli-Grid、Multi-Blade、SoNDe 以及其他一些探測器的原始資料的管道已經實施。主要用 C/C++ 實作。

文件

有關文件結構、體系結構、原語的更多詳細信息，請參閱文件/README.md

入門

essdaq 儲存庫有用於自動下載和​​編譯專案的腳本。下面是手動編譯事件形成單元軟體的說明。

先決條件

要建置和運行該軟體，需要以下相依性。

• Conan conan 腳本必須在目前$PATH中可用。使用小於 2 的最新版本。
• CMake至少需要 CMake 版本 2.8.12。一些需要更新版本的 CMake 的套件會將其作為依賴項下載。
• bash用於正確設定 conan 提供的依賴項的路徑。
• 最近的 C/C++ 編譯器支援 C++14。

Conan 用於下載依賴項。為了讓 conan 知道可以從哪裡下載依賴項，必須透過執行以下命令來新增 ecdc 軟體包儲存庫：

• conan remote add ecdc-conan-release https://artifactory.esss.lu.se/artifactory/api/conan/ecdc-conan-release

另請注意，對於附加功能，您可能需要手動安裝以下相依性：

• libpcap
• Valgrind用於進行記憶體使用（和其他）測試。
• lcov/gcov/gcovr產生覆蓋率報告所需。

大樓

運行以下命令：

git clone https://github.com/ess-dmsc/event-formation-unit.git

cd event-formation-unit

mkdir build

cd build

cmake ..

make

Ubuntu 16 下構建

當使用 conan 提供依賴項時，必須提供一個額外的選項： --settings compiler.libcxx=libstdc++11 。因此對 conan 的調用變成：

conan install --build=outdated .. --settings compiler.libcxx=libstdc++11

運行測試

單元測試

若要執行該專案的單元測試，請執行以下命令：

 make runtest

其他測試

如果已安裝所需的先決條件，還可以獲得測試覆蓋率報告。為此，您必須使用 cmake 在 makefile 中啟用覆蓋率測試。若要啟用 makefile 的覆蓋率測試，請執行

 cmake -DCOV=Y

然後要取得覆蓋率報告，請運行

 make coverage

若要執行記憶體洩漏測試（使用 Valgrind），請執行：

 make valgrind

運行事件形成應用程式

運行事件形成管道（在本例中為freia管道）所需的命令範例如下：

 make efu freia
cd bin
./efu -d ../modules/freia --nohwcheck

請注意，對於freia模組，您還需要提供一個設定檔。

若要取得可用的命令列參數，請使用-h或--help 。這在提供檢測器模組參數時也有效。例如：

 ./efu -d ../modules/freia -h

貢獻

請閱讀 CONTRIBUTING.md 文件，以了解有關我們的行為準則以及向我們提交拉取請求的流程的詳細資訊。

作者

• 莫滕·賈格·克里斯滕森
• 馬丁·謝蒂
• 喬納斯·尼爾森
• 珍妮·沃克

另請參閱 Github 上的貢獻者清單。

執照

該項目已獲得 BSD-2 許可證的許可，有關詳細信息，請參閱許可證文件。