Functions
	TileDigitsFromPulseCfg (flags, **kwargs)

Variables
	flags = initConfigFlags()
	parser
	help
	action
	default
	type
	str
	int
	bool
	False
	args
	_
	RunType
	doOpt2
	doOptATLAS
	OfcFromCOOL
	isMC
	Files
	MaxEvents
	RunNumbers
	ConditionsRunNumber
	OverrideRunNumber
	AtlasVersion
	GlobalTag
	runNumber = flags.Input.RunNumbers[0]
	cfg = MainServicesCfg(flags)
	rawChannelBuilders = cfg.getEventAlgo('TileRChMaker').TileRawChannelBuilder
	nSamples
	OptFilterDeltaCorrelation
str	ntupleFile = f'{args.outputDirectory}/tile_{runNumber}_{args.outputVersion}.aan.root'
	NSamples
	TileRawChannelContainer
	TileRawChannelContainerOpt
	TileRawChannelContainerFit
	withDetails
	summariseProps
	printDefaults
	sc = cfg.run()

Detailed Description

@file RunTilePulseSim.py
@brief Script to run Tile pulse simulator

Function Documentation

◆ TileDigitsFromPulseCfg()

RunTilePulseSim.TileDigitsFromPulseCfg	(		flags,
		**	kwargs )

Return component accumulator with configured Tile digits from pulse algorithm

Arguments:
    flags  -- Athena configuration flags
Keyword arguments:
    OutputDigitsContainer         -- Name of container with TileDigits to write
    ImperfectionMean              -- Mean value of pulse shape broadening
    ImperfectionRMS               -- RMS of pulse shape broadening
    InTimeAmp                     -- Amplitude of in-time pulse
    OutOfTimeAmp                  -- Amplitude of out-of-time pulse
    InTimeOffset                  -- In-time pulse offset from nominal time
    OutOfTimeOffset               -- Out-of-time pulse offset from nominal time
    UseGaussNoise                 -- Set to TRUE in order to create noise from double gaussian
    GaussNoiseAmpOne              -- Amplitude of first gaussian of double gaussian noise
    GaussNoiseSigmaOne            -- Standard deviation of first gaussian of double gaussian noise
    GaussNoiseAmpTwo              -- Amplitude of second gaussian of double gaussian noise
    GaussNoiseSigmaTwo            -- Standard deviation of second gaussian of double gaussian noise
    UseInTimeAmpDist              -- Set to TRUE in order to use a distribution for the in-time amplitude instead of a const.
    UseOutOfTimeAmpDist           -- Set to TRUE in order to use a distribution for the out-of-time amplitude instead of a const
    InTimeAmpDistFileName         -- Filename of file to use for amplitude distribution of in-time pulses
    InTimeAmpDistHistogramName    -- Name of the histogram to use for in-time amplitude distribution
    InTimeAmpPulseProb            -- Probability to add an in-time pulse
    OutOfTimeAmpDistFileName      -- Filename of file to use for amplitude distribution of out-of-time pulses
    InTimeAmpPulseProb            -- Probability to add an in-time pulse
    PileUpFraction                -- Probability that an out-of-time component will be added
    GaussianC2CPhaseVariation     -- RMS for the in-time pulse offset (channel-to-channel phase variation)
    ChannelSpecificPedestal       -- Set to TRUE in order to use a channel specific value for the pedestal
    ChannelSpecificNoise          -- Set to TRUE in order to add channel specific noise
    OutOfTimeOffsetHistogramFile  -- Filename of file containing histogram of pile-up timing distribution
    OutOfTimeOffsetHistogramName  -- Name of the histogram to use for pile-up timing distribution
    AmpDistLowerLimit             -- Set all bins lower than this to zero. Default = 135
    PedestalValueHG               -- Pedestal in HG if not taken from database
    PedestalValueLG               -- Pedestal in LG if not taken from database
    SimulatePileUpWithPoiss       -- Simulate pile-up overlaying signals from distribution
    AvgMuForPileUpSimulation      -- Average number of pp collisions for pile-up simulation with SimulatePileUpWithPoiss
    PileUpAmpDistFileName         -- Distribution to simulate pile-up with SimulatePileUpWithPoiss
    RandomSeed                    -- Random seed for random number generator
    SimulatePulseChain            -- Simulate continuous output from readout cosidering HL-LHC paradigm
    Bigain                        -- Save two gains in ntuple
    NPulses                       -- The number of neighboring bunch crossings (before and after the in-time crossing) whose signals are accounted for when simulating the total contribution to a given bunch crossing

Definition at line 13 of file RunTilePulseSim.py.

def TileDigitsFromPulseCfg(flags, **kwargs):
    """Return component accumulator with configured Tile digits from pulse algorithm
 
    Arguments:
        flags  -- Athena configuration flags
    Keyword arguments:
        OutputDigitsContainer         -- Name of container with TileDigits to write
        ImperfectionMean              -- Mean value of pulse shape broadening
        ImperfectionRMS               -- RMS of pulse shape broadening
        InTimeAmp                     -- Amplitude of in-time pulse
        OutOfTimeAmp                  -- Amplitude of out-of-time pulse
        InTimeOffset                  -- In-time pulse offset from nominal time
        OutOfTimeOffset               -- Out-of-time pulse offset from nominal time
        UseGaussNoise                 -- Set to TRUE in order to create noise from double gaussian
        GaussNoiseAmpOne              -- Amplitude of first gaussian of double gaussian noise
        GaussNoiseSigmaOne            -- Standard deviation of first gaussian of double gaussian noise
        GaussNoiseAmpTwo              -- Amplitude of second gaussian of double gaussian noise
        GaussNoiseSigmaTwo            -- Standard deviation of second gaussian of double gaussian noise
        UseInTimeAmpDist              -- Set to TRUE in order to use a distribution for the in-time amplitude instead of a const.
        UseOutOfTimeAmpDist           -- Set to TRUE in order to use a distribution for the out-of-time amplitude instead of a const
        InTimeAmpDistFileName         -- Filename of file to use for amplitude distribution of in-time pulses
        InTimeAmpDistHistogramName    -- Name of the histogram to use for in-time amplitude distribution
        InTimeAmpPulseProb            -- Probability to add an in-time pulse
        OutOfTimeAmpDistFileName      -- Filename of file to use for amplitude distribution of out-of-time pulses
        InTimeAmpPulseProb            -- Probability to add an in-time pulse
        PileUpFraction                -- Probability that an out-of-time component will be added
        GaussianC2CPhaseVariation     -- RMS for the in-time pulse offset (channel-to-channel phase variation)
        ChannelSpecificPedestal       -- Set to TRUE in order to use a channel specific value for the pedestal
        ChannelSpecificNoise          -- Set to TRUE in order to add channel specific noise
        OutOfTimeOffsetHistogramFile  -- Filename of file containing histogram of pile-up timing distribution
        OutOfTimeOffsetHistogramName  -- Name of the histogram to use for pile-up timing distribution
        AmpDistLowerLimit             -- Set all bins lower than this to zero. Default = 135
        PedestalValueHG               -- Pedestal in HG if not taken from database
        PedestalValueLG               -- Pedestal in LG if not taken from database
        SimulatePileUpWithPoiss       -- Simulate pile-up overlaying signals from distribution
        AvgMuForPileUpSimulation      -- Average number of pp collisions for pile-up simulation with SimulatePileUpWithPoiss
        PileUpAmpDistFileName         -- Distribution to simulate pile-up with SimulatePileUpWithPoiss
        RandomSeed                    -- Random seed for random number generator
        SimulatePulseChain            -- Simulate continuous output from readout cosidering HL-LHC paradigm
        Bigain                        -- Save two gains in ntuple
        NPulses                       -- The number of neighboring bunch crossings (before and after the in-time crossing) whose signals are accounted for when simulating the total contribution to a given bunch crossing
    """
 
    kwargs.setdefault('InTimeAmp', 1000)
    kwargs.setdefault('InTimeAmpPulseProb', 1)
    kwargs.setdefault('ImperfectionMean', 1)
    kwargs.setdefault('ImperfectionRms', 0)
    kwargs.setdefault('TilePhaseII', False)
    kwargs.setdefault('NSamples', 7)
    kwargs.setdefault('Bigain', False)
    kwargs.setdefault('SimulatePulseChain', False)
 
    PhaseII = kwargs['TilePhaseII']
    PulseChain = kwargs['SimulatePulseChain']
 
    # PhaseII parameters
    if PhaseII:
        kwargs.setdefault('PedestalValueHG', 100)
        kwargs.setdefault('PedestalValueLG', 100)
        kwargs.setdefault('ChannelSpecificPedestal', False)
        kwargs.setdefault('UseGaussNoise', True)
    else:
        kwargs.setdefault('ChannelSpecificPedestal', True)
        kwargs.setdefault('ChannelSpecificNoise', True)
 
    kwargs.setdefault('PileUpFraction', 0)
    kwargs.setdefault('AmpDistLowerLimit', 0)
    kwargs.setdefault('SimulatePileUpWithPoiss', False)
    kwargs.setdefault('AvgMuForPileUpSimulation', 80)
 
    from TileGeoModel.TileGMConfig import TileGMCfg
    acc = TileGMCfg(flags)
 
    from TileConditions.TileCablingSvcConfig import TileCablingSvcCfg
    acc.merge(TileCablingSvcCfg(flags))
 
    from TileConditions.TileSampleNoiseConfig import TileSampleNoiseCondAlgCfg
    acc.merge( TileSampleNoiseCondAlgCfg(flags) )
 
    from RngComps.RngCompsConfig import AthRNGSvcCfg
    kwargs['RndmSvc'] = acc.getPrimaryAndMerge( AthRNGSvcCfg(flags) )
 
    # Configure TileInfoLoader to set up number of samples
    nSamples = kwargs['NSamples'] if not PulseChain else 1
    ADCmax = 4095 if PhaseII else 1023
    ADCmaskValue = 4800 if PhaseII else 2047
    from TileConditions.TileInfoLoaderConfig import TileInfoLoaderCfg
    acc.merge( TileInfoLoaderCfg(flags,
                                 NSamples=nSamples, TrigSample=((nSamples-1)//2),
                                 ADCmax=ADCmax, ADCmaskValue=ADCmaskValue) )
 
    TileDigitsFromPulse = CompFactory.TileDigitsFromPulse
    acc.addEventAlgo(TileDigitsFromPulse(**kwargs), primary=True)
 
    return acc
 
 

Variable Documentation

◆ _

RunTilePulseSim._

protected

Definition at line 140 of file RunTilePulseSim.py.

◆ action

RunTilePulseSim.action

Definition at line 130 of file RunTilePulseSim.py.

◆ args

RunTilePulseSim.args

Definition at line 140 of file RunTilePulseSim.py.

◆ AtlasVersion

RunTilePulseSim.AtlasVersion

Definition at line 168 of file RunTilePulseSim.py.

◆ bool

RunTilePulseSim.bool

Definition at line 134 of file RunTilePulseSim.py.

◆ cfg

RunTilePulseSim.cfg = MainServicesCfg(flags)

Definition at line 181 of file RunTilePulseSim.py.

◆ ConditionsRunNumber

RunTilePulseSim.ConditionsRunNumber

Definition at line 164 of file RunTilePulseSim.py.

◆ default

RunTilePulseSim.default

Definition at line 131 of file RunTilePulseSim.py.

◆ doOpt2

RunTilePulseSim.doOpt2

Definition at line 146 of file RunTilePulseSim.py.

◆ doOptATLAS

RunTilePulseSim.doOptATLAS

Definition at line 147 of file RunTilePulseSim.py.

◆ False

RunTilePulseSim.False

Definition at line 134 of file RunTilePulseSim.py.

◆ Files

RunTilePulseSim.Files

Definition at line 156 of file RunTilePulseSim.py.

◆ flags

RunTilePulseSim.flags = initConfigFlags()

Definition at line 119 of file RunTilePulseSim.py.

◆ GlobalTag

RunTilePulseSim.GlobalTag

Definition at line 169 of file RunTilePulseSim.py.

◆ help

RunTilePulseSim.help

Definition at line 128 of file RunTilePulseSim.py.

◆ int

RunTilePulseSim.int

Definition at line 133 of file RunTilePulseSim.py.

◆ isMC

RunTilePulseSim.isMC

Definition at line 155 of file RunTilePulseSim.py.

◆ MaxEvents

RunTilePulseSim.MaxEvents

Definition at line 157 of file RunTilePulseSim.py.

◆ NSamples

RunTilePulseSim.NSamples

Definition at line 216 of file RunTilePulseSim.py.

◆ nSamples

RunTilePulseSim.nSamples

Definition at line 197 of file RunTilePulseSim.py.

◆ ntupleFile

str RunTilePulseSim.ntupleFile = f'{args.outputDirectory}/tile_{runNumber}_{args.outputVersion}.aan.root'

Definition at line 202 of file RunTilePulseSim.py.

◆ OfcFromCOOL

RunTilePulseSim.OfcFromCOOL

Definition at line 148 of file RunTilePulseSim.py.

◆ OptFilterDeltaCorrelation

RunTilePulseSim.OptFilterDeltaCorrelation

Definition at line 199 of file RunTilePulseSim.py.

◆ OverrideRunNumber

RunTilePulseSim.OverrideRunNumber

Definition at line 165 of file RunTilePulseSim.py.

◆ parser

RunTilePulseSim.parser

Initial value:

=  flags.getArgumentParser(description='Run Tile pulse simulator. \
    One can use it without input file and default conditions will be used. \
    Or one can use --run to specify run number from which conditions should be used \
    (probably conditions and geometries tags should be changed also in this case). \
    Or one can use --filesInput to specify input file with HITS to take conditions from. \
    Example: athena --CA RunTilePulseSim.py --evtMax 10')

Definition at line 121 of file RunTilePulseSim.py.

◆ printDefaults

RunTilePulseSim.printDefaults

Definition at line 233 of file RunTilePulseSim.py.

◆ rawChannelBuilders

RunTilePulseSim.rawChannelBuilders = cfg.getEventAlgo('TileRChMaker').TileRawChannelBuilder

Definition at line 194 of file RunTilePulseSim.py.

◆ runNumber

RunTilePulseSim.runNumber = flags.Input.RunNumbers[0]

Definition at line 178 of file RunTilePulseSim.py.

◆ RunNumbers

RunTilePulseSim.RunNumbers

Definition at line 163 of file RunTilePulseSim.py.

◆ RunType

RunTilePulseSim.RunType

Definition at line 142 of file RunTilePulseSim.py.

◆ sc

RunTilePulseSim.sc = cfg.run()

Definition at line 236 of file RunTilePulseSim.py.

◆ str

RunTilePulseSim.str

Definition at line 132 of file RunTilePulseSim.py.

◆ summariseProps

RunTilePulseSim.summariseProps

Definition at line 232 of file RunTilePulseSim.py.

◆ TileRawChannelContainer

RunTilePulseSim.TileRawChannelContainer

Definition at line 217 of file RunTilePulseSim.py.

◆ TileRawChannelContainerFit

RunTilePulseSim.TileRawChannelContainerFit

Definition at line 224 of file RunTilePulseSim.py.

◆ TileRawChannelContainerOpt

RunTilePulseSim.TileRawChannelContainerOpt

Definition at line 221 of file RunTilePulseSim.py.

◆ type

RunTilePulseSim.type