event formation unit Download - event formation unit Quellcode herunterladen

event formation unit

Andere Kategorien

verable-MS35

Herunterladen

Veranstaltungsformationseinheit

Dieses Projekt implementiert die Verarbeitung von Neutronendetektor-Ereignisdaten in Neutronenereignisse. Pipelines zur Verarbeitung von Rohdaten von Gd-GEM, Muli-Grid, Multi-Blade, SoNDe sowie einigen anderen Detektoren wurden implementiert. Größtenteils in C/C++ implementiert.

Dokumentation

Weitere Einzelheiten zur Dateistruktur, Architektur und Grundelementen finden Sie in der Dokumentation/README.md

Erste Schritte

Das essdaq-Repository verfügt über Skripte zum automatischen Herunterladen und Kompilieren dieses Projekts. Es folgen Anweisungen zum manuellen Kompilieren der Software für die Ereignisbildungseinheit.

Voraussetzungen

Um diese Software zu erstellen und auszuführen, sind die folgenden Abhängigkeiten erforderlich.

Conan Das Conan-Skript muss im aktuellen $PATH verfügbar sein. Verwenden Sie die neueste Version kleiner als 2.
CMake Mindestens CMake Version 2.8.12 ist erforderlich. Einige Pakete, die neuere Versionen von CMake erfordern, laden dies als Abhängigkeit herunter.
bash Zum korrekten Festlegen von Pfaden zu den von Conan bereitgestellten Abhängigkeiten.
Ein aktueller C/C++-Compiler mit Unterstützung für C++14.

Conan wird zum Herunterladen von Abhängigkeiten verwendet. Damit Conan weiß, woher die Abhängigkeiten heruntergeladen werden können, muss das ecdc-Paket-Repository durch Ausführen des folgenden Befehls hinzugefügt werden:

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

Beachten Sie auch, dass Sie für zusätzliche Funktionen möglicherweise die folgenden Abhängigkeiten manuell installieren möchten:

libpcap
Valgrind Zur Durchführung von Speichernutzungstests (und anderen Tests).
lcov/gcov/gcovr Erforderlich zum Generieren von Abdeckungsberichten.

Gebäude

Führen Sie die folgenden Befehle aus:

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

cd event-formation-unit

mkdir build

cd build

cmake ..

make

Erstellen unter Ubuntu 16

Wenn Conan zum Bereitstellen der Abhängigkeiten verwendet wird, muss eine zusätzliche Option bereitgestellt werden: --settings compiler.libcxx=libstdc++11 . So wird aus dem Aufruf an Conan:

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

Ausführen der Tests

Unit-Tests

Führen Sie die folgenden Befehle aus, um die Komponententests für dieses Projekt auszuführen:

 make runtest

Andere Tests

Es ist auch möglich, einen Testabdeckungsbericht zu erhalten, wenn die erforderlichen Voraussetzungen installiert wurden. Dazu müssen Sie den Coverage Test im Makefile mit cmake aktivieren. Führen Sie Folgendes aus, um den Abdeckungstest für Makefiles zu aktivieren:

 cmake -DCOV=Y

Führen Sie dann Folgendes aus, um den Abdeckungsbericht zu erhalten:

 make coverage

Führen Sie Folgendes aus, um einen Speicherlecktest (mit Valgrind) durchzuführen:

 make valgrind

Ausführen der Anwendung zur Ereignisbildung

Es folgt ein Beispiel für die Befehle, die zum Ausführen einer Ereignisformationspipeline (in diesem Fall der Freia -Pipeline) erforderlich sind:

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

Beachten Sie, dass Sie auch im Fall des Freia -Moduls eine Konfigurationsdatei bereitstellen müssen.

Um die verfügbaren Befehlszeilenargumente abzurufen, verwenden Sie -h oder --help . Dies funktioniert auch, wenn ein Detektormodulargument bereitgestellt wird. Zum Beispiel:

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

Mitwirken

Bitte lesen Sie die Datei CONTRIBUTING.md, um Einzelheiten zu unserem Verhaltenskodex und dem Verfahren zur Übermittlung von Pull-Anfragen an uns zu erfahren.