|
BmnRoot 26.10.0-18-g4e3414f9
Software framework of the BM@N experiment
|
C++ interface to the Unified Condition Database (UniConDa) of the BM@N experiment: periods and runs, raw and simulation files, detectors and the values of the detector parameters for run ranges. The classes connect directly to the PostgreSQL database through the ROOT TSQLServer interface; the connection settings are set in uni_db_settings.h.
Most classes correspond to the tables of the database and are generated from its scheme (see scheme): each class has static functions to create, get, delete, search and print the records of its table, and getters and setters of the table columns.
| Class | Description |
|---|---|
| UniConnection | Connection to the database (the opened connections are cached and reused) |
| UniRunPeriod | Table run_period: periods (sessions) of the experiment, list of their runs |
| UniRun | Table run_: runs with their type, time, beam and target particles, energy, magnetic field, event count and quality |
| UniRawFile | Table raw_file: raw data files of the runs with their path, event range, size and hash |
| UniSimulationFile | Table simulation_file: simulated files with their generator, collision system, energy, centrality and size |
| UniDetector | Table detector_: detectors of the experiment |
| UniParameterType | Table parameter_type: types of the parameter values |
| UniParameter | Table parameter_: parameters which can be set for the detectors |
| UniDetectorParameter | Table detector_parameter: values of the detector parameters valid for a run range (including ROOT files, e.g. alignment) |
| UniSearchCondition | Condition (column, comparison, value) for the Search functions of the classes |
| UniValue | Base structure of the parameter values; the derived value structures (BoolValue, IntValue, DoubleValue, JsonValue, …) and UniqueRunNumber are declared in uni_db_structures.h |
| File | Description |
|---|---|
| show_experiment_files.cxx | show_experiment_files utility: list of the raw data files of the runs selected by the given criteria |
| show_simulation_files.cxx | show_simulation_files utility: list of the simulation files selected by the given criteria (e.g. energy=5-9) |
| Directory | Description |
|---|---|
| examples | Examples of working with the database: parameters, run selection, file statistics |
| macros | Service macros: connection test, copying and comparison of the tables |
| scheme | SQL scheme and diagram of the database |
| docs | User guide, console utilities and reference manual of the interface |
UniDb. The utilities show_experiment_files and show_simulation_files are installed into bin.
The interface is a git submodule developed in the nica_db/unidb repository at git.jinr.ru.
Directories | |
| docs | |
| Unified Condition Database documents | |
| examples | |
| Unified Condition Database examples | |
| macros | |
| Unified Condition Database service macros | |
| scheme | |
| Unified Condition Database scheme | |