<!DOCTYPE article PUBLIC "-//NLM//DTD JATS (Z39.96) Journal Archiving and Interchange DTD v1.0 20120330//EN" "JATS-archivearticle1.dtd">
<article xmlns:xlink="http://www.w3.org/1999/xlink">
  <front>
    <journal-meta />
    <article-meta>
      <title-group>
        <article-title>Development of database complex for the CBM experiment</article-title>
      </title-group>
      <contrib-group>
        <contrib contrib-type="author">
          <string-name>E.P. Akishina</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>E.I. Alexandrov</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>I.N. Alexandrov</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>I.A. Filozova</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>V. Friese</string-name>
          <xref ref-type="aff" rid="aff0">0</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <contrib contrib-type="author">
          <string-name>V.V. Ivanov</string-name>
          <xref ref-type="aff" rid="aff1">1</xref>
          <xref ref-type="aff" rid="aff2">2</xref>
          <xref ref-type="aff" rid="aff3">3</xref>
        </contrib>
        <aff id="aff0">
          <label>0</label>
          <institution>GSI Helmholtz Centre for Heavy Ion Research</institution>
          ,
          <addr-line>1 Plankstr, Darmstadt, 64291</addr-line>
          ,
          <country country="DE">Germany</country>
        </aff>
        <aff id="aff1">
          <label>1</label>
          <institution>Joint Institute for Nuclear Research</institution>
          ,
          <addr-line>6 Joliot-Curie, Dubna, 141980</addr-line>
          ,
          <country country="RU">Russia</country>
        </aff>
        <aff id="aff2">
          <label>2</label>
          <institution>National Research Nuclear University ”MEPhI“</institution>
          ,
          <addr-line>31 Kashirskoe shosse, Moscow, 115409</addr-line>
          ,
          <country country="RU">Russia</country>
        </aff>
        <aff id="aff3">
          <label>3</label>
          <institution>2016 Elena P. Akishina, Evgeny I. Alexandrov, Igor N. Alexandrov, Irina A. Filozova</institution>
          ,
          <addr-line>Volker Friese, Viktor .V. Ivanov</addr-line>
        </aff>
      </contrib-group>
      <fpage>85</fpage>
      <lpage>90</lpage>
      <abstract>
        <p>The results on the development of complex databases for the CBM experiment are presented. The set of basic structural characteristics of the required databases is provided. It is based on the analysis of databases used for data processing in high-energy physics experiments. The complex includes the following databases: Configuration DB, Condition DB, Geometry DB, TagEvent DB and Component DB. The description of the component database (Component DB) is given. The main principles of the functioning of the geometric database (Geometry DB) are considered.</p>
      </abstract>
      <kwd-group>
        <kwd>DBMS</kwd>
        <kwd>component DB</kwd>
        <kwd>geometry DB</kwd>
      </kwd-group>
    </article-meta>
  </front>
  <body>
    <sec id="sec-1">
      <title>-</title>
      <p>The CBM (Compressed Baryonic Matter) experimental facility that is being built at GSI
(Darmstadt, Germany) at the accelerator complex of antiprotons and heavy ions FAIR (Facility for
Antiproton and Ion Research) is intended for studying the properties of superdense baryonic matter
generating in 8-45 GeV/nucleon proton-nuclear and nucleus-nucleus collisions [Friman, 2011].</p>
      <p>Figure 1 presents a dielectron version of the CBM installation intended for research on
shortliving vector mesons and charmonium decaying into an electron-positron pair.</p>
      <p>Inside the dipole magnet there is a target and a coordinate tracking system STS (Silicon Tracking
System) containing 8 stations of 300 mkm two-way strip detectors. Together with the dipole magnet,
STS is used to reconstruct charged particle trajectories and to determine their momenta. The
Cherenkov detector RICH (Ring Imaging Cherenkov) and the Transition Radiation Detector (TRD)
should provide a reliable registration of electrons/positrons with the pulses of more than 1 GeV/s. The
time-of-light detector (TOF) constructed on the basis of Resistive Plate Chambers (RPC) is intended
for hadron identification in a wide energy range. The Electromagnetic Calorimeter (ECAL) is used for
electron/photon identification. The Projectile Spectator Detector (PSD) is intended for the reaction
plane determination.</p>
      <p>Due to high beam intensity and high multiplicity of secondary particles, huge data is expected to
be accumulated by the DAQ (Data acquisition) system for further analysis.</p>
      <p>At the current moment the CBM collaboration moves from the stage of prototypes research and
tests to detectors and their components production. The high level of control for manufacturing
process is required because of the complexity and high price of the detector components.</p>
      <p>
        As a result, there is a need for development of a database complex for the CBM experiment. This
paper presents a complex of Database Management Systems (DBMS) for the CBM collaboration and
describes a current status of its implementation. DBMS structure was designed based on the
experience of using databases at the LHC and other experiments in high-energy physics [
        <xref ref-type="bibr" rid="ref2">Akishina,
2014</xref>
        ].
      </p>
    </sec>
    <sec id="sec-2">
      <title>Complex of DBMS</title>
      <p>In the CBM databases the following data should be supported: detector production and
installation, survey data, event data and metadata, detector geometry, online configuration, run conditions
DCS (Distributed Control System) and others, online calibrations and alignments data.</p>
      <p>Below we present the list of main databases together with their brief description.</p>
      <p>Configuration database: to store a large number of parameters describing the topology of the
DAQ system, hardware and software components and run parameters. It only stores the parameters
that are directly required to start and support in efficient operating conditions of all elements of DAQ
system.</p>
      <p>Conditions database: to store, retrieve and manipulate condition, alignment and calibration data.
Condition data keep the state of the CBM setup at the time when events are collected. A subset of the
data will be used both for online (FLES [Hutter,2015]) and offline computing.</p>
      <p>Tag Event database: to store, retrieve and manipulate event data and corresponding metadata
from all stages of data processing (Raw, Event Summary Data, Analysis Object Data, etc.).</p>
      <p>Geometry database: to store, retrieve, manipulate and load the detector geometry that is stored
as a set of well tested and versioned detectors geometry in a view of ROOT files and metadata.</p>
      <p>Component database: to manage properties of detectors and electronic components obtained in
QA (Quality Assurance) process after mass fabrication. Component database includes
mechanical/engineering production data and electronics data (calibrations, chip thresholds etc) which are kept
separately in general.</p>
      <p>
        Most of the databases should be implemented as relational databases. The exclusion is the
Configuration DB. It stores different types of data as hardware description, software description including
programs with their run parameters etc. There should be a possibility to change data in easy and
convenient way as such procedure is frequent one. The possible solution for Configuration DB is to use
the object oriented database such as in the ATLAS experiment [
        <xref ref-type="bibr" rid="ref6">Almeida, 2008</xref>
        ].
      </p>
    </sec>
    <sec id="sec-3">
      <title>Component database</title>
      <p>
        The Component Database (DB) is the first database that was designed and implemented as a part
of the CBM databases project [
        <xref ref-type="bibr" rid="ref2">Akishina, 2014</xref>
        ] according to the User Requirements Document
[
        <xref ref-type="bibr" rid="ref3 ref4">Akishina, User Requirements…, 2015</xref>
        ]. The Component DB is used to store and manage the
properties of the detectors hardware and electronic components. It contains characteristics, statuses, test
results, certificates and other parameters both numeric/strings and images. The current relational DB
structure allows to use it for any CBM detector performing minor adjustments. The components of
different detectors (STS, Magnet, PSD, RICH, ToF, MUCH, MVD, TRD, ECAL) will be stored in
different databases. Data will be accessed through the common authorization service. The Component
DB has a tree structure. The root of the tree has a name of the CBM facility part such as Magnet,
MVD, STS, etc. The list of the detector components is stored in the tree. The tree leaf is connected to a
table with corresponding names and values. The tests, certificates and statuses are stored in DB as the
references. Testing results of the components are presented in form of images. The certificates details
depend on the component and can be implemented for each detector. The catalog of different statuses
can be defined for each detector separately.
      </p>
      <p>The DBMS PostgreSQL v8.4.20 [PostgreSQL group] was used for implementation of
Component DB. Basic services are supported for each CBM detector via WEB access to data bases: data
viewing of detector components, search in navigation mode, inserting and editing components data,
support of the catalogs, authorization services for system access. The authorization is based on
affiliation to the detector’s group.</p>
      <p>The implementation is realized on the basis of client-server interaction. The same schema for all
detectors was produced. Scripts and their usage in according html-pages were implemented. Figure 2
presents an example of the Magnet main page.</p>
      <p>
        The database structures for several detector systems (magnet, STS, MVD) were confirmed with
the responsible persons. Currently, the Component DB includes eleven tables, six of which are the
catalogs [
        <xref ref-type="bibr" rid="ref3 ref4">Akishina, Component database…, 2015</xref>
        ]. The tables were modified according to the needs of
the various detector systems. The system of catalogs was refined. The following catalogs are currently
approved: the catalog of production companies, the catalog of component categories, the catalog of
component batches, the catalog of statuses, the catalog of the units of quality measurements, and the
catalog of quality criteria.
      </p>
    </sec>
    <sec id="sec-4">
      <title>Geometry database</title>
      <p>
        The Geometry Database is designed and implemented as a part of the CBM Databases project
according to the User Requirements Document (URD) [
        <xref ref-type="bibr" rid="ref5">Akishina, 2016</xref>
        ].The CBM geometry describes
the CBM setup on the detail level required for simulation of particles transport using GEANT
[
        <xref ref-type="bibr" rid="ref1">Agostinelli, 2003</xref>
        ]. It represents an ”ideal“ geometry in the sense of the construction blueprint.
Deviations from this ideal geometry, as e.g. obtained by optical surveillance after installation or by
alignment procedures, will be described as additional datasets, which will be handled by Conditions DB.
      </p>
      <p>The basic notations are defined in the URD. According the URD a geometry module is defined as
some metadata and a file in ROOT format with content of detector geometry. Metadata includes
module name, unique module index and other data. Geometry module linked with transformation
matrix is the module setup. Complex of setup modules which represents the full CBM geometry is
defined as setup.</p>
      <p>Currently, the geometry ROOT files are stored and distributed through the CBM software
repository. Setups as combinations of geometry files are defined on the ROOT macro level. Such a situation
is rather complicated, error-prone and, thus, not ideal. Moreover, handling by the software repository
does not match the requirement that a given geometry version must not change in time. The
distribution of the module geometries as well as entire setups through a database thus appears as desirable
solution.</p>
      <p>The Geometry DB will store the CBM geometry and setup modules as well as setups as
combination of setup modules. It provides appropriate interfaces to view, retrieve and update setup modules
and setups. The URD also characterizes three categories of users of the Geometry DB: CBM user,
Developer, and Lead Developer. The basic use cases for those categories are Load Geometry, Download
Geometry, WEB View, Add Geometry, Add Setup Module, and Add Setup, the detailed description of
which is in progress.</p>
      <p>The prototype of the Geometry DB is implemented. It includes two parts: server and client.
Server part is used to view and edit setup and its content. Figure 3 shows a content page of the Geometry
DB for a specific setup. Client part is used for loading the geometry into memory, for simulation and
reconstruction. It also includes the ROOT macros to load the setup by a tag.</p>
    </sec>
    <sec id="sec-5">
      <title>Conclusion</title>
      <p>The complex of databases is an important part of the software for the CBM experiment. The set
of databases is defined and two first databases were designed and implemented. The Component DB
stores all data on the CBM construction and it will be used intensively during CBM commissioning.
Though the database is ready for use it is supposed that it will be upgraded on the base of experience
of its usage. The Geometry DB has benefits both for employees and top management already in the
current stage. This is a transparency and usability, reduced geometry loading code, business
transparency, and advantages in monitoring of geometry. The beta version of the Geometry DB is ready for
use.
Friman B. et al. Compressed Baryonic Matter in Laboratory Experiments // The CBM Physics Book—
2011.</p>
      <p>Hutter D. et al. CBM FLES input interface developments // CBM Progress Report 2014— 2015—
p.101.</p>
      <p>PostgreSQL group PostgreSQL Documentation // (https://www.postgresql.org/docs/manuals/)
S. Agostinelli et al., Geant4—a simulation toolkit // Nuclear Instruments and Methods A 506 (2003)
250-303.</p>
    </sec>
  </body>
  <back>
    <ref-list>
      <ref id="ref1">
        <mixed-citation>
          <string-name>
            <surname>Agostinelli S</surname>
          </string-name>
          . et al, Geant4
          <article-title>-a simulation toolkit // Nuclear Instruments</article-title>
          and Methods A 506 - 2003- pp
          <fpage>250</fpage>
          -
          <lpage>303</lpage>
        </mixed-citation>
      </ref>
      <ref id="ref2">
        <mixed-citation>
          <string-name>
            <surname>Akishina E.P.</surname>
          </string-name>
          et al.
          <article-title>Conceptual considerations for</article-title>
          CBM databases // JINR Communication- 2014
          <string-name>
            <surname>- E10-</surname>
          </string-name>
          2014-103.
        </mixed-citation>
      </ref>
      <ref id="ref3">
        <mixed-citation>
          <string-name>
            <surname>Akishina E.P.</surname>
          </string-name>
          et al.
          <source>User Requirements Document for CBM Component Database</source>
          ,
          <fpage>2015</fpage>
          -URL: (http://lt-jds.jinr.ru/record/67403?ln=en).
        </mixed-citation>
      </ref>
      <ref id="ref4">
        <mixed-citation>
          <string-name>
            <surname>Akishina E. P.</surname>
          </string-name>
          et al.
          <article-title>Component database development for the CBM experiment /</article-title>
          / JINR Communication - 2015
          <string-name>
            <surname>- E10-</surname>
          </string-name>
          2015-106.
        </mixed-citation>
      </ref>
      <ref id="ref5">
        <mixed-citation>
          <string-name>
            <surname>Akishina E. P.</surname>
          </string-name>
          et al.
          <article-title>User Requirements Document of the Geometry DB for the CBM experiment, 2016-URL: (http://lt-jds.jinr</article-title>
          .ru/record/69336?ln=en).
        </mixed-citation>
      </ref>
      <ref id="ref6">
        <mixed-citation>
          <string-name>
            <surname>Almeida J.</surname>
          </string-name>
          et al.
          <article-title>The ATLAS DAQ system online configurations database service challenge</article-title>
          . // Journal of Physics: Conference Series- 2008 - Volume 119- Issue 2- pp.
          <fpage>022004</fpage>
          .
        </mixed-citation>
      </ref>
    </ref-list>
  </back>
</article>