Luminosity Functions

A group of functions which all deal with calculating luminosity. More...

Functions
virtual float	AthMonitorAlgorithm::lbAverageInteractionsPerCrossing (const EventContext &ctx) const
	Calculate the average mu, i.e.
virtual float	AthMonitorAlgorithm::lbInteractionsPerCrossing (const EventContext &ctx) const
	Calculate instantaneous number of interactions, i.e.
virtual float	AthMonitorAlgorithm::lbAverageLuminosity (const EventContext &ctx) const
	Calculate average luminosity (in ub-1 s-1 => 10^30 cm-2 s-1).
virtual float	AthMonitorAlgorithm::lbLuminosityPerBCID (const EventContext &ctx) const
	Calculate the instantaneous luminosity per bunch crossing.
virtual double	AthMonitorAlgorithm::lbDuration (const EventContext &ctx) const
	Calculate the duration of the luminosity block (in seconds).
virtual float	AthMonitorAlgorithm::lbAverageLivefraction (const EventContext &ctx) const
	Calculate the average luminosity livefraction.
virtual float	AthMonitorAlgorithm::livefractionPerBCID (const EventContext &ctx) const
	Calculate the live fraction per bunch crossing ID.
virtual double	AthMonitorAlgorithm::lbLumiWeight (const EventContext &ctx) const
	Calculate the average integrated luminosity multiplied by the live fraction.

Detailed Description

A group of functions which all deal with calculating luminosity.

Function Documentation

lbAverageInteractionsPerCrossing()

float AthMonitorAlgorithm::lbAverageInteractionsPerCrossing ( const EventContext & ctx ) const

virtual

Calculate the average mu, i.e.

<mu>.

Definition at line 236 of file AthMonitorAlgorithm.cxx.

{
    if (!m_lumiDataKey.empty()) {
        SG::ReadCondHandle<LuminosityCondData> lumi (m_lumiDataKey, ctx);
        return lumi->lbAverageInteractionsPerCrossing();
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbAverageInteractionsPerCrossing() - luminosity tools are not retrieved.");
        return -1.0;
    }
}

lbAverageLivefraction()

float AthMonitorAlgorithm::lbAverageLivefraction ( const EventContext & ctx ) const

virtual

Calculate the average luminosity livefraction.

Definition at line 288 of file AthMonitorAlgorithm.cxx.

{
    if (m_environment == Environment_t::online
        || m_dataType == DataType_t::monteCarlo) {
        return 1.0;
    }
 
    if (!m_trigLiveFractionDataKey.empty()) {
        SG::ReadCondHandle<TrigLiveFractionCondData> live (m_trigLiveFractionDataKey, ctx);
        return live->lbAverageLiveFraction();
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbAverageLivefraction() - luminosity not available.");
        return -1.0;
    }
}

lbAverageLuminosity()

float AthMonitorAlgorithm::lbAverageLuminosity ( const EventContext & ctx ) const

virtual

Calculate average luminosity (in ub-1 s-1 => 10^30 cm-2 s-1).

Definition at line 264 of file AthMonitorAlgorithm.cxx.

{
    if (!m_lumiDataKey.empty()) {
        SG::ReadCondHandle<LuminosityCondData> lumi (m_lumiDataKey, ctx);
        return lumi->lbAverageLuminosity();
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbAverageLuminosity() - luminosity tools are not retrieved.");
        return -1.0;
    }
}

lbDuration()

double AthMonitorAlgorithm::lbDuration ( const EventContext & ctx ) const

virtual

Calculate the duration of the luminosity block (in seconds).

Definition at line 333 of file AthMonitorAlgorithm.cxx.

{
    if ( m_environment == Environment_t::online
         || m_dataType == DataType_t::monteCarlo ) {
        return m_defaultLBDuration;
    }
 
    if (!m_lbDurationDataKey.empty()) {
        SG::ReadCondHandle<LBDurationCondData> dur (m_lbDurationDataKey, ctx);
        return dur->lbDuration();
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbDuration() - luminosity tools are not retrieved.");
        return m_defaultLBDuration;
    }
}

lbInteractionsPerCrossing()

float AthMonitorAlgorithm::lbInteractionsPerCrossing ( const EventContext & ctx ) const

virtual

Calculate instantaneous number of interactions, i.e.

mu.

Definition at line 248 of file AthMonitorAlgorithm.cxx.

{
    if (!m_lumiDataKey.empty()) {
        SG::ReadCondHandle<LuminosityCondData> lumi (m_lumiDataKey, ctx);
        float muToLumi = lumi->muToLumi();
        if (muToLumi > 0) {
          return lumi->lbLuminosityPerBCIDVector().at (ctx.eventID().bunch_crossing_id()) / muToLumi;
        }
        return 0;
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbInteractionsPerCrossing() - luminosity tools are not retrieved.");
        return -1.0;
    }
}

lbLuminosityPerBCID()

float AthMonitorAlgorithm::lbLuminosityPerBCID ( const EventContext & ctx ) const

virtual

Calculate the instantaneous luminosity per bunch crossing.

Definition at line 276 of file AthMonitorAlgorithm.cxx.

{
    if (!m_lumiDataKey.empty()) {
        SG::ReadCondHandle<LuminosityCondData> lumi (m_lumiDataKey, ctx);
        return lumi->lbLuminosityPerBCIDVector().at (ctx.eventID().bunch_crossing_id());
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbLuminosityPerBCID() - luminosity tools are not retrieved.");
        return -1.0;
    }
}

lbLumiWeight()

double AthMonitorAlgorithm::lbLumiWeight ( const EventContext & ctx ) const

virtual

Calculate the average integrated luminosity multiplied by the live fraction.

Definition at line 322 of file AthMonitorAlgorithm.cxx.

{
    if (!m_lumiDataKey.empty()) {
        return (lbAverageLuminosity(ctx)*lbDuration(ctx))*lbAverageLivefraction(ctx);
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::lbLumiWeight() - luminosity tools are not retrieved.");
        return -1.0;
    }
}

livefractionPerBCID()

float AthMonitorAlgorithm::livefractionPerBCID ( const EventContext & ctx ) const

virtual

Calculate the live fraction per bunch crossing ID.

Definition at line 305 of file AthMonitorAlgorithm.cxx.

{
    if (m_environment == Environment_t::online
        || m_dataType == DataType_t::monteCarlo) {
        return 1.0;
    }
 
    if (!m_trigLiveFractionDataKey.empty()) {
        SG::ReadCondHandle<TrigLiveFractionCondData> live (m_trigLiveFractionDataKey, ctx);
        return live->l1LiveFractionVector().at (ctx.eventID().bunch_crossing_id());
    } else {
        ATH_MSG_DEBUG("AthMonitorAlgorithm::livefractionPerBCID() - luminosity not available.");
        return -1.0;
    }
}