Instantaneous luminosity

Instantaneous luminosity and proton and anti-proton halos

Code for accessing the information about instantaneous luminosity and proton and anti-proton halos is independent on the code for integrated luminosity. The users interface is also much simpler. An example how to determine the instantaneous luminosity is in example_tick.cpp.

In order to determine the instantaneous luminosity, the following steps needs to be followed:

1.
The only header file you have to include into your source code from package lm_access is LumPerTick.hpp
      #include "lm_access/LumPerTick.hpp"
2.
In the very beginning of your code declare an instance of class LumPerTick
      LumPerTick lTick;
Do not declare the variable in the loop over the data. Class LumPerTick contains simple caching mechanism that reduces the number of accesses to the luminosity flat files.
3.
Before accessing any luminosity information you MUST CHECK that this information exists for a given luminosity block number (LBN) and tick. You need to call method
      lTick.isGoodTick(lbn, tick)
4.
If the method returns true you can access the luminosity information.

Method lTick.luminosity(lbn, tick) returns the instantaneous luminosity in a given tick for particular LBN. The units are 10³⁰ cm^-2.s^-1.

Methods lTick.protonHalo(lbn, tick) and lTick.pbarHalo(lbn, tick) return proton and anti-proton halo frequency in Hz.

Method lTick.avgNumInelastic(lbn, tick) returns the average number of proton anti-proton inelastic interactions per bunch crossing that corresponds to the particular tick.

Last update Jun 9, 2003, by AK.

1.	The only header file you have to include into your source code from package lm_access is LumPerTick.hpp #include "lm_access/LumPerTick.hpp"
2.	In the very beginning of your code declare an instance of class LumPerTick LumPerTick lTick; Do not declare the variable in the loop over the data. Class LumPerTick contains simple caching mechanism that reduces the number of accesses to the luminosity flat files.
3.	Before accessing any luminosity information you MUST CHECK that this information exists for a given luminosity block number (LBN) and tick. You need to call method lTick.isGoodTick(lbn, tick)
4.	If the method returns true you can access the luminosity information. Method lTick.luminosity(lbn, tick) returns the instantaneous luminosity in a given tick for particular LBN. The units are 10³⁰ cm^-2.s^-1. Methods lTick.protonHalo(lbn, tick) and lTick.pbarHalo(lbn, tick) return proton and anti-proton halo frequency in Hz. Method lTick.avgNumInelastic(lbn, tick) returns the average number of proton anti-proton inelastic interactions per bunch crossing that corresponds to the particular tick.