Luminosity Interfaces

Service name: LuminosityManager

Luminosity processing - interfaces

  • int saveLuminosityByLs(long startTime, long endTime, string label, vector<
    LuminosityByLs>
    luminosity)
    Description: Saves luminosity by lumi-section data into the database. Luminosity
    can be further indentified by a given validity interval (startTime, endTime) and a
    label describing the data. The method returns version number of saved data (in
    case of multiple similar inserts the old one is not removed, but new version of the
    same data is created instead).
    Parameters:
    startTime - a start time of fill validity interval. Nonnegative long value.
    endTime - an end time of fill validity interval. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
    luminosity - vector of structures containing luminosity data
    (i.e. UTC time, lumi section, Beam status, energy etc.). Cannot be null or empty vector. All structures are
    further described in next section. The structures are saved into the database
    in the same order as they are in the vector.
  • vector<LuminosityByLs> loadLuminosityByLs(long timestamp, string
    label)
    Description: Loads the latest version of luminosity data (bound to given timestamp
    and label) from the database and returns it as a vector of LuminosityByLs
    structures. The order of structures in the vector is the same as it was while saving by saveLuminosityByLs method.
    Parameters:
    timestamp - a timestamp value, it should be between startTime and endTime
    specified in saveLuminosityByLs method. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
  • vector<LuminosityByLs> loadLuminosityByLs((long timestamp,
    string label, int version)
    Description: Loads the specified version of luminosity data (bound to given timestamp
    and label) from the database and returns it as a vector of LuminosityByLs
    structures. The order of structures in the vector is the same as it was while saving
    by saveLuminosityByLs method.
    Parameters:
    timestamp - a timestamp value, it should be between startTime and endTime
    specified in saveLuminosityByLs method. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
    version - a version number, positive integer value.
  • vector<LuminosityMetadata> listAllLuminosityByLs()
    Description: Loads the vector of metadata of all luminosity by lumi-section measurments.
    For each measurment, LuminosityMetadata contains information about
    startTime and endTime (specified in saveLuminosityByLs method), label and
    number of versions of luminosity data.
  • vector<LuminosityMetadata> listLuminosityByLs(long startTime, long
    endTime )
    Description: Loads the vector of metadata of luminosity by lumi-section measurments
    in given period of time: [startTime, endTime].
    Parameters:
    startTime - a start time. Nonnegative long value.
    endTime - an end time. Nonnegative long value.
  • int saveLuminosityByLsXing(long startTime, long endTime, string label,
    vector<LuminosityByLsXing> luminosity)
    Description: Saves luminosity by lumi-section crossing data into the database.
    Luminosity can be further indentified by a given validity interval (startTime, end-
    Time) and a label. The method returns version number of saved data (in case of
    multiple similar inserts the old one is not removed, but new version of the same
    data is created instead).
    Parameters:
    startTime - a start time of fill validity interval. Nonnegative long value.
    endTime - an end time of fill validity interval. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
    luminosity - luminosity data vector. Cannot be null or empty vector. LuminosityByLsXing
    is a structure containing luminosity data (i.e. UTC time, lumi section, and
    luminosity value for each Bunch Crossing ID). All structures are further described
    in next section. The structures are saved into the database in the same
    order as they are in the vector.
  • vector<LuminosityByLsXing> loadLuminosityByLsXing(long timestamp,
    string label)
    Description: Loads the latest version of luminosity by lumi-section crossing data(
    bound to given timestamp and label) from the database and returns it as a
    vector of luminosity structures. Values are held in LuminosityByLsXing, which is
    further described in next section. The order of structures in the vector is the same
    as it was while saving by saveLuminosityByLsXing method.
    Parameters:
    timestamp - a timestamp value, it should be between startTime and endTime
    specified in saveLuminosityByLsXing method. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
  • vector<LuminosityByLsXing> loadLuminosityByLsXing(long
    timestamp, string label, int version)
    Description: Loads the specified version of luminosity by lumi-section crossing
    data(bound to given timestamp and label) from the database and returns it as a
    UTC time - luminosity structure value map. Values are held in LuminosityByLsXing,
    which is further described in next section. The order of structures in the
    vector is the same as it was while saving by saveLuminosityByLsXing method.
    Parameters:
    timestamp - a timestamp value, it should be between startTime and endTime
    specified in saveLuminosityByLsXing method. Nonnegative long value.
    label - a text label, description of data, i. e. concatenation of lumitype, datatag,
    normtag and worktag strings separated by semicolon( HF; V 3;HFV 2a; V 04−
    01 − 01 ). Cannot be null or empty string.
    version - a version number, positive integer value.
  • vector<LuminosityMetadata> listAllLuminosityByLsXing()
    Description: Loads the vector of metadata of all luminosity by lumi-section
    crossing measurments. For each measurment, LuminosityMetadata contains information
    about startTime and endTime (specified in saveLuminosityByLsXing
    method), label and number of versions of luminosity data.



  • vector<LuminosityMetadata> listLuminosityByLsXing(long startTime,
    long endTime)
    Description: Loads the vector of metadata of luminosity by lumi-section crossing
    measurments in given period of time: [startTime, endTime].
    Parameters:
    startTime - a start time. Nonnegative long value.
    endTime - an end time. Nonnegative long value.

Luminosity processing - structures

  • LuminosityByLs - a structure representing single luminosity by lumi-section
    measurment
    Fields:
    long timestamp - a UTC Time of the measurment
    string cmsRun - a label of CMS run number i.e. 198898
    string fill - a label of fill number i.e. 2836
    string ls - a label describing a luminosity section, i.e. 1:1
    string beamStatus - a label describing beam status, i.e. SQUEEZE,
    STABLE BEAMS, ADJUST
    double energy - a value of energy in GeV
    double delivered - a value of delivered luminosity
    double lslengthsec - a value of luminosity section length in sec
    double recorder - a value of recorded luminosity
    double avgPU - a value of average PU
  • LuminosityByLsXing - a structure representing single luminosity by lumisection
    crossing measurment
    Fields:
    long timestamp - a UTC Time of the measurment
    string cmsRun - a label of CMS run number i.e. 198898
    string fill - a label of fill number i.e. 2836
    string ls - a label describing a luminosity section, i.e. 1:1
    double delivered - a value of delivered luminosity
    double lslengthsec - a value of luminosity section length in sec
    double recorder - a value of recorded luminosity
    vector<double> luminosity - luminosity value vector. Each element of
    the vector corresponds to BCID(Bunch Crossing ID), i.e. luminosity[0] is
    the value of luminosity for BCID = 0. Length of the vector is established
    in server configuration file (as a default it equals 3564)
  • LuminosityMetadata - a structure representing luminosity metadata
    Fields:
    long startTime - a start time (UTC Time) specified while saving luminosity
    data
    long endTime - a end time (UTC Time) specified while saving luminosity
    data
    string label - a text label, description of data, i. e. concatenation of
    lumitype, datatag, normtag and worktag strings separated by semicolon(
    HF; V 3;HFV 2a; V 04 − 01 − 01 ).
    int numberOfVersions - a number of different versions, positive integer
    value. This value is incremented while insertion data for the same validity
    interval and label more than once.
Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r3 - 2012-09-11 - unknown
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TOTEM All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback