<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta http-equiv="content-type" content="text/html;
      charset=ISO-8859-1">
  </head>
  <body bgcolor="#ffffff" text="#000000">
    Dear Mark and Dmitry,<br>
    <br>
    Below is an attempt to specify requirements for the conditions
    database.&nbsp; Please get back to me if you need additional
    information...we can iterate as required.<br>
    <br>
    Thanks,<br>
    <br>
    Elliott<br>
    <br>
    <br>
    <b><br>
      <br>
      <br>
      <u>Requirements for Hall D Conditions Database</u></b><br>
    <br>
    <div align="left">Elliott Wolin<br>
      11-Nov-2011<br>
    </div>
    <br>
    <br>
    <br>
    <u>General Remarks</u><br>
    <br>
    The Hall D conditions database needs to store a wide variety of
    types of data relevant to configuring and running the apparatus and
    taking data.&nbsp; The information in the conditions database will be
    used by the offline reconstruction and analysis effort, and might
    further be used for debugging of online problems.&nbsp; Further, it is
    important that this data be easily accessible from the analysis
    programs from both on- and off-site.&nbsp; The data must be tagged
    appropriately, and the schema shown by Mark at the April 2011 Online
    meeting seems like it should work.<br>
    <br>
    Note that the conditions database need not duplicate the function of
    the EPICS archiver, which records a vast quantity of fine-grained
    data from a large number of sensors.&nbsp; Most of this data is not
    needed by the offline effort, but it is difficult to predict in
    advance which data will or will not be needed.&nbsp; It does make sense,
    however, to record selected EPICS data in the conditions database
    that surely will be used by the offline, for example the solenoid
    setpoint current at the beginning of each run.<br>
    <br>
    <br>
    <u>Input Requirements</u><br>
    <u><br>
    </u>Data will be input to the conditions database in a variety of
    ways during experiment operations.&nbsp; These include input from C++ and
    Java programs and from Python and shell (and perhaps Perl) scripts.
    Some input will come from long-running programs or scripts, some
    from short-lived programs or scripts launched as part of a run
    control transition, and some from CRON jobs.<br>
    <br>
    Entry size will vary from single numbers or short strings to long
    strings containing many thousands of characters.<br>
    <br>
    Entry frequency varies widely, with flurries of activity expected at
    the beginning and end of data taking runs, with relatively few
    entries during steady-state data taking.&nbsp; <br>
    <br>
    Entry rates will peak within about 20 seconds after the start of a
    new run, with something like 10-20 processes making about 100-200
    entries with a maximum aggregate size of less than 1 MB.&nbsp; Note that
    how long these entries take is not critical as they will be made by
    programs and scripts running in the background.<br>
    <u><br>
    </u>API requirements are not particularly strict, as only a few
    experienced members of the online group will be involved in making
    entries into the conditions database.&nbsp; <br>
    <br>
    <u><br>
      <br>
      Retrieval Requirements</u><br>
    <br>
    These are largely driven by offline requirements, and are almost
    identical to those of the calibration database.&nbsp; It is highly
    desirable that the API and access mechanisms for the conditions and
    calibration databases be as similar as possible. <br>
    <br>
    An important consideration concerns export of the conditions
    database to other sites.&nbsp; Some of the data entered will only be
    useful to the online group, although it is never clear whether any
    particular data type will be needed by the offline.&nbsp; A mechanism
    needs to be provided that allows selective export of the database
    contents, e.g. by run range and data type.<br>
    <br>
    <br>
    <pre class="moz-signature" cols="72">-- 

                                Sincerely,
                                        Elliott
 

================================================================================


 Those raised in a morally relative or neutral environment will hold
                    no truths to be self-evident.
                                   

Elliott Wolin
Staff Physicist, Jefferson Lab
12000 Jefferson Ave
Suite 8 MS 12A1
Newport News, VA 23606
757-269-7365

================================================================================
</pre>
    <br>
  </body>
</html>