Default Powheg configuration for Z-boson pair production including interference for identical leptons. More...

Inheritance diagram for python.processes.powheg.ZZ.ZZ:

Collaboration diagram for python.processes.powheg.ZZ.ZZ:

Public Member Functions
def	__init__ (self, base_directory, **kwargs)
	Constructor: all process options are set here. More...

def	validate_decays (self)
	Validate idvecbos and vdecaymode keywords. More...

def	default_PDFs (self)
	Default PDFs for this process. More...

def	default_scales (self)
	Default scale variations for this process. More...

def	files_for_cleanup (self)
	Wildcarded list of files created by this process that can be deleted. More...

def	integration_file_names (self)
	Wildcarded list of integration files that might be created by this process. More...

def	mandatory_integration_file_names (self)
	Wildcarded list of integration files that are needed for this process. More...

def	powheg_version (self)
	Version of PowhegBox process. More...

def	stage_is_completed (self, stage)
	Set whether the specified POWHEG-BOX generation stage is complete. More...

def	hoppet_info (self)

def	hoppet_warning (self)

def	openloops_error (self)

def	manually_set_openloops_paths (self)

def	manually_set_openloops_gnu_paths (self)

def	link_madloop_libraries (self)

def	link_external_powheg_libraries (self, librarypath)

def	add_algorithm (self, alg_or_process)
	Add an algorithm or external process to the sequence. More...

def	prepare_to_parallelise (self, n_cores)
	Scale calculation parameters by n_cores. More...

def	validate_parameters (self)
	Validate any parameters which need it before preparing runcard. More...

def	validate_integration_parameters (self)
	Validate integration keywords by forcing to integer values. More...

def	check_decay_mode (self, decay_mode, allowed_decay_modes=None)
	Check whether a decay mode is allowed an raise an exception if it is not. More...

def	check_using_integration_files (self)

def	modify_parameter (self, stage=0)

def	set_parameter_in_config (self, key, value)

def	add_keyword (self, keyword, value=None, name=None, frozen=None, hidden=None, description=None, **kwargs)
	Register configurable parameter that is exposed to the user. More...

def	expose (self)
	Add all names to the interface of this object. More...

def	has_keyword (self, keyword)

def	has_parameter (self, parameter)

def	parameters_by_keyword (self, keyword)
	Retrieve all parameters that use a given keyword. More...

def	parameters_by_name (self, name)
	Retrieve all parameters that use a given name. More...

Public Attributes
	allowed_decay_modes
	List of allowed decay modes. More...

	executable
	Powheg executable that will be used. More...

	process_revision
	SVN revision of process code. More...

	powhegbox_revision
	Log the PowhegBox version and process-code revision for AMI etc. More...

	cores
	Number of cores to use. More...

	algorithms
	List of additional algorithms to schedule. More...

	externals
	List of external processes to schedule. More...

	validation_functions
	List of validation functions to run before preparing runcard. More...

	is_reweightable
	Switch to determine whether reweighting is allowed. More...

	use_XML_reweighting
	Switch to determine whether XML reweighting should be used. More...

	remove_oldStyle_rwt_comments
	Switch to determine if the #rwgt and #pdf comments should be kept in lhe files despite using xml reweighting. More...

	warning_output
	Special treatment for some log messages. More...

	info_output

	error_output

	parameterStageDict
	Dictionary used to change parameters of the Powheg input. More...

	parameters
	List of available parameters. More...

Detailed Description

Default Powheg configuration for Z-boson pair production including interference for identical leptons.

Create a configurable object with all applicable Powheg options.

Author: James Robinson james.nosp@m..rob.nosp@m.inson.nosp@m.@cer.nosp@m.n.ch

Definition at line 10 of file ZZ.py.

Constructor & Destructor Documentation

◆ init()

def python.processes.powheg.ZZ.ZZ.__init__	(		self,
			base_directory,
		**	kwargs
	)

Constructor: all process options are set here.

Parameters

base_directory	path to PowhegBox code.
kwargs	dictionary of arguments from Generate_tf.

Definition at line 18 of file ZZ.py.

     def __init__(self, base_directory, **kwargs):
         """! Constructor: all process options are set here.
  
         @param base_directory: path to PowhegBox code.
         @param kwargs          dictionary of arguments from Generate_tf.
         """
         super(ZZ, self).__init__(base_directory, "ZZ", **kwargs)
  
         # Add parameter validation functions
         self.validation_functions.append("validate_decays")
  
         
         self.allowed_decay_modes = ["z z > e+ e- e+ e-", "z z > e+ e- tau+ tau-", "z z > j j j j", "z z > j j l+ l-",
                                     "z z > l+ l- l'+ l'-", "z z > mu+ mu- e+ e-", "z z > mu+ mu- mu+ mu-",
                                     "z z > tau+ tau- mu+ mu-", "z z > tau+ tau- tau+ tau-", "z z > v v~ e+ e-",
                                     "z z > v v~ j j", "z z > v v~ l+ l-", "z z > v v~ mu+ mu-", "z z > v v~ tau+ tau-",
                                     "z z > v v~ v' v'~"]
  
         # Add all keywords for this process, overriding defaults if required
         self.add_keyword("bornktmin")
         self.add_keyword("bornonly")
         self.add_keyword("bornsuppfact")
         self.add_keyword("bornzerodamp")
         self.add_keyword("bottomthr")
         self.add_keyword("bottomthrpdf")
         self.add_keyword("btildeborn")
         self.add_keyword("btildecoll")
         self.add_keyword("btildereal")
         self.add_keyword("btildevirt")
         self.add_keyword("btlscalect")
         self.add_keyword("btlscalereal")
         self.add_keyword("charmthr")
         self.add_keyword("charmthrpdf")
         self.add_keyword("check_bad_st2")
         self.add_keyword("clobberlhe")
         self.add_keyword("colltest")
         self.add_keyword("compress_lhe")
         self.add_keyword("compress_upb")
         self.add_keyword("compute_rwgt")
         self.add_keyword("cutallpairs")
         self.add_keyword("doublefsr")
         self.add_keyword("dronly")
         self.add_keyword("evenmaxrat")
         self.add_keyword("facscfact", self.default_scales[0])
         self.add_keyword("fastbtlbound")
         self.add_keyword("fixedgrid")
         self.add_keyword("fixedscale")
         self.add_keyword("flg_debug")
         self.add_keyword("foldcsi", 2)
         self.add_keyword("foldphi")
         self.add_keyword("foldy", 2)
         self.add_keyword("fullrwgt")
         self.add_keyword("fullrwgtmode")
         self.add_keyword("hdamp")
         self.add_keyword("hfact")
         self.add_keyword("icsimax")
         self.add_keyword("ih1")
         self.add_keyword("ih2")
         self.add_keyword("itmx1", 6)
         self.add_keyword("itmx1rm")
         self.add_keyword("itmx2", 6)
         self.add_keyword("itmx2rm")
         self.add_keyword("iupperfsr")
         self.add_keyword("iupperisr")
         self.add_keyword("iymax")
         self.add_keyword("lhans1", self.default_PDFs)
         self.add_keyword("lhans2", self.default_PDFs)
         self.add_keyword("lhapdf6maxsets")
         self.add_keyword("lhrwgt_descr")
         self.add_keyword("lhrwgt_group_combine")
         self.add_keyword("lhrwgt_group_name")
         self.add_keyword("lhrwgt_id")
         self.add_keyword("LOevents")
         self.add_keyword("manyseeds")
         self.add_keyword("max_io_bufsize")
         self.add_keyword("maxseeds")
         self.add_keyword("minlo")
         self.add_keyword("mintupbratlim")
         self.add_keyword("mintupbxless")
         self.add_keyword("mllmin")
         self.add_keyword("ncall1", 40000)
         self.add_keyword("ncall1rm")
         self.add_keyword("ncall2", 60000)
         self.add_keyword("ncall2rm")
         self.add_keyword("ncallfrominput")
         self.add_keyword("noevents")
         self.add_keyword("novirtual")
         self.add_keyword("nubound", 20000)
         self.add_keyword("olddij")
         self.add_keyword("par_2gsupp")
         self.add_keyword("par_diexp")
         self.add_keyword("par_dijexp")
         self.add_keyword("parallelstage")
         self.add_keyword("pdfreweight")
         self.add_keyword("ptsqmin")
         self.add_keyword("ptsupp")
         self.add_keyword("radregion")
         self.add_keyword("rand1")
         self.add_keyword("rand2")
         self.add_keyword("renscfact", self.default_scales[1])
         self.add_keyword("runningwidth")
         self.add_keyword("rwl_add")
         self.add_keyword("rwl_file")
         self.add_keyword("rwl_format_rwgt")
         self.add_keyword("rwl_group_events")
         self.add_keyword("smartsig")
         self.add_keyword("softtest")
         self.add_keyword("stage2init")
         self.add_keyword("storeinfo_rwgt")
         self.add_keyword("storemintupb")
         self.add_keyword("testplots")
         self.add_keyword("testsuda")
         self.add_keyword("ubexcess_correct")
         self.add_keyword("ubsigmadetails")
         self.add_keyword("use-old-grid")
         self.add_keyword("use-old-ubound")
         self.add_keyword("withdamp")
         self.add_keyword("withinterference")
         self.add_keyword("withnegweights")
         self.add_keyword("withsubtr")
         self.add_keyword("xgriditeration")
         self.add_keyword("xupbound", 4)
         self.add_keyword("zerowidth")
         self.add_keyword("ZZeeee", self.allowed_decay_modes[0], name="decay_mode", hidden=False)
         self.add_keyword("ZZeetautau")
         self.add_keyword("ZZllll")
         self.add_keyword("ZZmumuee")
         self.add_keyword("ZZmumumumu")
         self.add_keyword("ZZqqll")
         self.add_keyword("ZZqqqq")
         self.add_keyword("ZZtautaumumu")
         self.add_keyword("ZZtautautautau")
         self.add_keyword("ZZvvee")
         self.add_keyword("ZZvvll")
         self.add_keyword("ZZvvmumu")
         self.add_keyword("ZZvvqq")
         self.add_keyword("ZZvvtautau")
         self.add_keyword("ZZvvvv")
  

Member Function Documentation

◆ add_algorithm()

def python.processes.powheg_base.PowhegBase.add_algorithm	(	self,
		alg_or_process
	)

inherited

Add an algorithm or external process to the sequence.

Parameters

process Algorithm or external process to add.

Definition at line 206 of file powheg_base.py.

     def add_algorithm(self, alg_or_process):
         """! Add an algorithm or external process to the sequence.
  
         @param process  Algorithm or external process to add.
         """
         # Either add to the list of algorithms to schedule
         if isinstance(alg_or_process, str):
             self.algorithms.append(alg_or_process)
         # ... or add as an external process
         else:
             self.externals[alg_or_process.name] = alg_or_process
  

◆ add_keyword()

def python.processes.configurable.Configurable.add_keyword	(		self,
			keyword,
			value = `None`,
			name = `None`,
			frozen = `None`,
			hidden = `None`,
			description = `None`,
		**	kwargs
	)

inherited

Register configurable parameter that is exposed to the user.

Parameters

keyword	Powheg keyword that gets written to the runcard.
value	Value of the parameter.
name	Configurable parameter name exposed to the user.
hidden	True if this parameter should be hidden from the user.
frozen	True if this parameter cannot be changed.
description	Description for the run card.
parameter	Name used in the run card if different.

Definition at line 21 of file configurable.py.

     def add_keyword(self, keyword, value=None, name=None, frozen=None, hidden=None, description=None, **kwargs):
         """! Register configurable parameter that is exposed to the user.
  
         @param keyword     Powheg keyword that gets written to the runcard.
         @param value       Value of the parameter.
         @param name        Configurable parameter name exposed to the user.
         @param hidden       True if this parameter should be hidden from the user.
         @param frozen       True if this parameter cannot be changed.
         @param description Description for the run card.
         @param parameter   Name used in the run card if different.
         """
         # Retrieve default settings from registry overriding if requested
         defaults = Registry().get_defaults(keyword)
         if value == defaults["value"] and value is not None and (hidden is not True):
             if keyword not in ["ebeam1", "ebeam2"]:
               logger.debug("Unnecessarily setting parameter {} to {} which is its default value!".format(keyword, value))
         value = [value, defaults["value"]][value is None]
         name = [name, defaults["name"]][name is None]
         description = [description, defaults["description"]][description is None]
         hidden = [hidden, defaults["hidden"]][hidden is None]
         frozen = [frozen, defaults["frozen"]][frozen is None]
         if keyword in [p.keyword for p in self.parameters]:
             raise AttributeError("Keyword '{}' has already been defined for this process".format(keyword))
         self.parameters.append(Parameter(keyword, name=name, value=value, frozen=frozen, hidden=hidden, description=description, **kwargs))
  

◆ check_decay_mode()

def python.processes.powheg_base.PowhegBase.check_decay_mode	(	self,
		decay_mode,
		allowed_decay_modes = `None`
	)

inherited

Check whether a decay mode is allowed an raise an exception if it is not.

Definition at line 281 of file powheg_base.py.

     def check_decay_mode(self, decay_mode, allowed_decay_modes=None):
         """! Check whether a decay mode is allowed an raise an exception if it is not."""
         if allowed_decay_modes is None:
             allowed_decay_modes = self.allowed_decay_modes
         if decay_mode not in allowed_decay_modes:
             logger.warning("Decay mode {} not recognised!".format(decay_mode))
             logger.info("Allowed decay modes are:")
             for allowed_decay_mode in allowed_decay_modes:
                 logger.info("... {}".format(allowed_decay_mode))
             raise ValueError("Decay mode {} not recognised!".format(decay_mode))
  

◆ check_using_integration_files()

def python.processes.powheg_base.PowhegBase.check_using_integration_files ( self )

inherited

Definition at line 292 of file powheg_base.py.

     def check_using_integration_files(self):
         
         search_strings = [] # list of filename patters to be searched for
         found_files = [] # list of found files will be printed out for info
         missing_patterns = [] # list of filename patters which hasn't been found but would be needed for pre-made integration grids
         try:
             search_strings = self.mandatory_integration_file_names
         except AttributeError:
             logger.fatal("No integration grid file name patterns defined for this process.")
             raise
         for s in search_strings:
             found = glob.glob(s)
             if found != []:
                 found_files += found
             else:
                 missing_patterns.append(s)
         if missing_patterns == []:
             logger.info("Integration grid files found locally. Event generation shall continue, skipping the integration step.")
             logger.info("Integration grid files found locally: {}".format(found_files))
         else:
             logger.info("Integration grid files needed were not found locally. Event generation shall continue, starting by the integration step.")
             logger.info("Missing integration grid files with these patterns: {}".format(missing_patterns))
             logger.info("Integration grid files found locally (if any): {}".format(found_files))
  
  

◆ default_PDFs()

def python.processes.powheg_V2.PowhegV2.default_PDFs ( self )

inherited

Default PDFs for this process.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 27 of file powheg_V2.py.

     def default_PDFs(self):
         """! Default PDFs for this process."""
         __PDF_list = list(range(260000, 260101)) # NNPDF30_nlo_as_0118 central with eigensets
         __PDF_list += [266000, 265000]      # NNPDF30_nlo_as_0119 and NNPDF30_nlo_as_0117
         __PDF_list += [303200]              # NNPDF30_nnlo_as_0118_hessian
         __PDF_list += [27400, 27100]        # MSHT20nnlo_as118, MSHT20nlo_as118
         __PDF_list += [14000, 14400]        # CT18NNLO, CT18NLO
         __PDF_list += [304400, 304200]      # NNPDF31_nnlo_as_0118_hessian, NNPDF31_nlo_as_0118_hessian
         __PDF_list += [331500, 331100]      # NNPDF40_nnlo_as_01180_hessian, NNPDF40_nlo_as_01180
         __PDF_list += [14200, 14300, 14100] # CT18ANNLO, CT18XNNLO and CT18ZNNLO
         __PDF_list += list(range(93300, 93343))  # PDF4LHC21_40_pdfas with eigensets
         return __PDF_list
  

◆ default_scales()

def python.processes.powheg_V2.PowhegV2.default_scales ( self )

inherited

Default scale variations for this process.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 41 of file powheg_V2.py.

     def default_scales(self):
         """! Default scale variations for this process."""
         return [[1.0, 1.0, 1.0, 0.5, 0.5, 2.0, 2.0],\
                 [1.0, 0.5, 2.0, 0.5, 1.0, 1.0, 2.0]]
  

◆ expose()

def python.processes.configurable.Configurable.expose ( self )

inherited

Add all names to the interface of this object.

Definition at line 46 of file configurable.py.

     def expose(self):
         """! Add all names to the interface of this object."""
         for parameter in self.parameters:
             setattr(self, parameter.name, parameter.value)
  

◆ files_for_cleanup()

def python.processes.powheg_V2.PowhegV2.files_for_cleanup ( self )

inherited

Wildcarded list of files created by this process that can be deleted.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 47 of file powheg_V2.py.

     def files_for_cleanup(self):
         """! Wildcarded list of files created by this process that can be deleted."""
         return [
             "bornequiv",
             "FlavRegList",
             "fort.18",
             "mint_upb_btildeupb.top",
             "mint_upb_remnupb.top",
             "pwg*.top",
             "pwgboundviolations*.dat",
             "pwgcounters*.dat",
             "pwgseeds.dat",
             "pwgubsigma.dat",
             "pwhg_checklimits",
             "realequiv*",
             "reweighting_input.xml",
             "virtequiv"
         ]
  

◆ has_keyword()

def python.processes.configurable.Configurable.has_keyword	(	self,
		keyword
	)

inherited

Definition at line 51 of file configurable.py.

     def has_keyword(self, keyword):
         return (len(list(self.parameters_by_keyword(keyword))) > 0)
  

◆ has_parameter()

def python.processes.configurable.Configurable.has_parameter	(	self,
		parameter
	)

inherited

Definition at line 54 of file configurable.py.

     def has_parameter(self, parameter):
         return (len(list(self.parameters_by_name(parameter))) > 0)
  

◆ hoppet_info()

def python.processes.powheg_base.PowhegBase.hoppet_info ( self )

inherited

Returns a list of strings to be treated as info messages in the log
They otherwise throw an error with HOPPET v. 1.2.0
Cf. AGENE-2016

Definition at line 23 of file powheg_base.py.

     def hoppet_info(self):
         '''
         Returns a list of strings to be treated as info messages in the log
         They otherwise throw an error with HOPPET v. 1.2.0
         Cf. AGENE-2016
         '''
         return ["-----------------------------------------------------------",
                 "Welcome to HOPPET v. 1.2.0",
                 "Higher Order Perturbative Parton Evolution Toolkit",
                 "Written by Gavin P. Salam (2001-2012)",
                 "with contributions from Juan Rojo",
                 "Frederic Dreyer and Alexander Karlberg",
                 "It is made available under the GNU public license,",
                 "with the additional request that if you use it or any",
                 "derivative of it in scientific work then you should cite:",
                 "G.P. Salam & J. Rojo, CPC 180(2009)120 (arXiv:0804.3755).",
                 "You are also encouraged to cite the original references,",
                 "for LO, NLO and NNLO splitting functions, the QCD",
                 "1, 2 and 3 loop beta functions and the coupling and",
                 "PDF and coupling mass threshold matching functions."]
  

◆ hoppet_warning()

def python.processes.powheg_base.PowhegBase.hoppet_warning ( self )

inherited

Returns a list of strings to be treated as warning messages in the log
They otherwise throw an error

Definition at line 44 of file powheg_base.py.

     def hoppet_warning(self):
         '''
         Returns a list of strings to be treated as warning messages in the log
         They otherwise throw an error
         '''
         return ["WARNING in InitMTMNNLO: using parametrisation  (less accuracte) for A2PShg"]
  

◆ integration_file_names()

def python.processes.powheg_V2.PowhegV2.integration_file_names ( self )

inherited

Wildcarded list of integration files that might be created by this process.

All files matching these patterns will be included in the gridpack.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 67 of file powheg_V2.py.

     def integration_file_names(self):
         """! Wildcarded list of integration files that might be created by this process."""
         """! All files matching these patterns will be included in the gridpack."""
         return [
             "pwg*xg*.dat",
             "pwg*upb*.dat",
             "pwggrid*.dat",
             "pwgfullgrid*.dat",
             "pwgubound*.dat",
             "pwg*stat.dat",
         ]
  

◆ link_external_powheg_libraries()

def python.processes.powheg_base.PowhegBase.link_external_powheg_libraries	(	self,
		librarypath
	)

inherited

Manual fix for external libraries path.
This library is expected to be installed in the POWHEGPATH folder.
Needs to be adjusted if the version of the library changes.

Definition at line 123 of file powheg_base.py.

     def link_external_powheg_libraries(self, librarypath):
         '''
         Manual fix for external libraries path.
         This library is expected to be installed in the POWHEGPATH folder.
         Needs to be adjusted if the version of the library changes.
         '''
         logger.warning("Applying manual fixes for library paths:" + librarypath)
         logger.debug("LD_LIBRARY_PATH (before) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
         ldpath = os.getenv('LD_LIBRARY_PATH')
         powhegpath = os.getenv('POWHEGPATH')
         librarypath = glob.glob(powhegpath+librarypath)
         ldpath_new = ldpath+ ":" + librarypath[0]
         os.environ['LD_LIBRARY_PATH'] = ldpath_new
         logger.debug("LD_LIBRARY_PATH (after) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
  

◆ link_madloop_libraries()

def python.processes.powheg_base.PowhegBase.link_madloop_libraries ( self )

inherited

Manual fix for MadLoop libraries, avoiding issues when /afs not available
This is NOT a viable long-term solution and should be made obsolete after the migration
The trick consists in making a symbolic link of some directory in the installation
which contains some files needed by MadLoop

Definition at line 95 of file powheg_base.py.

     def link_madloop_libraries(self):
         '''
         Manual fix for MadLoop libraries, avoiding issues when /afs not available
         This is NOT a viable long-term solution and should be made obsolete after the migration
         The trick consists in making a symbolic link of some directory in the installation
         which contains some files needed by MadLoop
         '''
         import os
         logger.warning("Applying manual, hard-coded fixes for MadLoop library paths")
         MadLoop_virtual = os.path.dirname(self.executable)+"/virtual"
         logger.info("Trying to link directory {} locally".format(MadLoop_virtual))
         if not os.access(MadLoop_virtual,os.R_OK):
             logger.fatal("Impossible to access directory {} needed for this process which uses MadLoop".format(MadLoop_virtual))
         if os.access("virtual",os.R_OK):# checking if link already exists
             logger.info("Found \"virtual\" probably from previous run - deleting it to recreate it with correct path")
             try:
                 os.remove("virtual")
             except Exception:
                 logger.fatal("Impossible to remove \"virtual\" symbolic link - exiting...")
                 raise
         os.symlink(MadLoop_virtual, "virtual")
         link = os.readlink("virtual")
         if link != MadLoop_virtual:
             logger.fatal("Symbolic link \"virtual\" points to {0} while it should point to {1} - linking probably didn't work. Exiting...".format(link,MadLoop_virtual))
             raise
         else:
             logger.info("Local directory \"virtual\" now points to {}".format(MadLoop_virtual))
  

◆ mandatory_integration_file_names()

def python.processes.powheg_V2.PowhegV2.mandatory_integration_file_names ( self )

inherited

Wildcarded list of integration files that are needed for this process.

If some of the patterns don't match any files before running, a warning will be made to inform that no pre-made integration grid will be used.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 80 of file powheg_V2.py.

     def mandatory_integration_file_names(self):
         """! Wildcarded list of integration files that are needed for this process."""
         """! If some of the patterns don't match any files before running, a warning will be made to inform that no pre-made integration grid will be used."""
         return [
             "pwg*xg*.dat",
             #"pwg*upb*.dat", # not needed by ttj MiNNLO
             "pwggrid*.dat",
             #"pwgfullgrid*.dat", # not needed by ttj MiNNLO
             "pwgubound*.dat",
         ]
  

◆ manually_set_openloops_gnu_paths()

def python.processes.powheg_base.PowhegBase.manually_set_openloops_gnu_paths ( self )

inherited

Manual fix for OpenLoops libraries path, avoiding issues when /afs not available
This is NOT a viable long-term solution and should be made obsolete after the migration
away from AFS is more advanced.

Definition at line 76 of file powheg_base.py.

     def manually_set_openloops_gnu_paths(self):
         '''
         Manual fix for OpenLoops libraries path, avoiding issues when /afs not available
         This is NOT a viable long-term solution and should be made obsolete after the migration
         away from AFS is more advanced.
         '''
         import os
         logger.warning("Applying manual, hard-coded fixes for OpenLoops library paths")
         logger.info("OpenLoopsPath (before) = {0}".format(os.getenv('OpenLoopsPath')))
         logger.debug("LD_LIBRARY_PATH (before) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
         OLPath = os.path.dirname(self.executable)+"/obj-gnu"
         os.environ['OpenLoopsPath'] = OLPath
         ldpath = os.getenv('LD_LIBRARY_PATH')
         ldpath_new = OLPath+ ":" + OLPath + "/proclib:" + ldpath
         os.environ['LD_LIBRARY_PATH'] = ldpath_new
         logger.info("OpenLoopsPath (after) = {0}".format(os.getenv('OpenLoopsPath')))
         logger.debug("LD_LIBRARY_PATH (after) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
  
  

◆ manually_set_openloops_paths()

def python.processes.powheg_base.PowhegBase.manually_set_openloops_paths ( self )

inherited

Manual fix for OpenLoops libraries path, avoiding issues when /afs not available
This is NOT a viable long-term solution and should be made obsolete after the migration
away from AFS is more advanced.

Definition at line 58 of file powheg_base.py.

     def manually_set_openloops_paths(self):
         '''
         Manual fix for OpenLoops libraries path, avoiding issues when /afs not available
         This is NOT a viable long-term solution and should be made obsolete after the migration
         away from AFS is more advanced.
         '''
         import os
         logger.warning("Applying manual, hard-coded fixes for OpenLoops library paths")
         logger.info("OpenLoopsPath (before) = {0}".format(os.getenv('OpenLoopsPath')))
         logger.debug("LD_LIBRARY_PATH (before) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
         OLPath = os.path.dirname(self.executable)+"/obj-gfortran"
         os.environ['OpenLoopsPath'] = OLPath
         ldpath = os.getenv('LD_LIBRARY_PATH')
         ldpath_new = OLPath+ ":" + OLPath + "/proclib:" + ldpath
         os.environ['LD_LIBRARY_PATH'] = ldpath_new
         logger.info("OpenLoopsPath (after) = {0}".format(os.getenv('OpenLoopsPath')))
         logger.debug("LD_LIBRARY_PATH (after) = {0}".format(os.getenv('LD_LIBRARY_PATH')))
  

◆ modify_parameter()

def python.processes.powheg_base.PowhegBase.modify_parameter	(	self,
		stage = `0`
	)

inherited

Definition at line 317 of file powheg_base.py.

     def modify_parameter(self, stage = 0):
  
         #skip modifying if dict is empty
         if not bool(self.parameterStageDict):
             return
  
         logger.info("Modifying parameters for the stages : {0}".format(self.parameterStageDict))
  
         
         for key in self.parameterStageDict:
             settingsList = self.parameterStageDict[key]
             if abs(settingsList[2] - stage) <=1e-09:
                 self.set_parameter_in_config(key,settingsList[1])
             else: 
                 self.set_parameter_in_config(key,settingsList[0])
  

◆ openloops_error()

def python.processes.powheg_base.PowhegBase.openloops_error ( self )

inherited

Returns a list of strings to be treated as error messages in the log
They otherwise do not throw an error

Definition at line 51 of file powheg_base.py.

     def openloops_error(self):
         '''
         Returns a list of strings to be treated as error messages in the log
         They otherwise do not throw an error
         '''
         return ["[POWHEG-BOX+OpenLoops] Process not found!"]
  

◆ parameters_by_keyword()

def python.processes.configurable.Configurable.parameters_by_keyword	(	self,
		keyword
	)

inherited

Retrieve all parameters that use a given keyword.

Parameters

keyword Powheg keyword that gets written to the runcard.

Definition at line 57 of file configurable.py.

     def parameters_by_keyword(self, keyword):
         """! Retrieve all parameters that use a given keyword.
  
         @param keyword  Powheg keyword that gets written to the runcard.
         """
         return [p for p in self.parameters if p.keyword == keyword]
  

◆ parameters_by_name()

def python.processes.configurable.Configurable.parameters_by_name	(	self,
		name
	)

inherited

Retrieve all parameters that use a given name.

Parameters

name	Configurable parameter name exposed to the user.

Definition at line 64 of file configurable.py.

     def parameters_by_name(self, name):
         """! Retrieve all parameters that use a given name.
  
         @param name        Configurable parameter name exposed to the user.
         """
         return [p for p in self.parameters if p.name == name]

◆ powheg_version()

def python.processes.powheg_V2.PowhegV2.powheg_version ( self )

inherited

Version of PowhegBox process.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 92 of file powheg_V2.py.

     def powheg_version(self):
         """! Version of PowhegBox process."""
         return "V2"
  

◆ prepare_to_parallelise()

def python.processes.powheg_base.PowhegBase.prepare_to_parallelise	(	self,
		n_cores
	)

inherited

Scale calculation parameters by n_cores.

Definition at line 248 of file powheg_base.py.

     def prepare_to_parallelise(self, n_cores):
         """! Scale calculation parameters by n_cores."""
         __nEvents_unscaled = self.parameters_by_keyword("numevts")[0].value
         for keyword in ["ncall1", "ncall1rm", "ncall2", "ncall2rm", "nubound", "numevts"]:
             for parameter in self.parameters_by_keyword(keyword):
                 if int(parameter.value) > 0:
                     parameter.value = int(math.ceil(float(parameter.value) / n_cores))
         __nEvents_scaled = self.parameters_by_keyword("numevts")[0].value
         logger.info("Scaling number of events per job from {} down to {}".format(__nEvents_unscaled, __nEvents_scaled))
         # Freeze parallelstage parameters before printing list for user
         [parameter.freeze() for parameter in self.parameters_by_name("parallelstage")]
  

◆ set_parameter_in_config()

def python.processes.powheg_base.PowhegBase.set_parameter_in_config	(	self,
		key,
		value
	)

inherited

Definition at line 333 of file powheg_base.py.

333 def set_parameter_in_config(self, key, value):

334 FileParser("powheg.input").text_replace(key+".*", key+" {}".format(value))

◆ stage_is_completed()

def python.processes.powheg_V2.PowhegV2.stage_is_completed	(	self,
		stage
	)

inherited

Set whether the specified POWHEG-BOX generation stage is complete.

Reimplemented from python.processes.powheg_base.PowhegBase.

Definition at line 96 of file powheg_V2.py.

     def stage_is_completed(self, stage):
         """! Set whether the specified POWHEG-BOX generation stage is complete."""
         if stage == 1:
             required_files = ["pwg*xg*.dat"]
         elif stage == 2:
             required_files = ["pwg*upb*.dat", "pwggrid*.dat"]
         elif stage == 3:
             required_files = ["pwgfullgrid*.dat", "pwgubound*.dat"]
         else:
             return False
  
         # Check that required files have been found
         for required_file in required_files:
             if not glob.glob(required_file):
                 return False
         return True

◆ validate_decays()

def python.processes.powheg.ZZ.ZZ.validate_decays ( self )

Validate idvecbos and vdecaymode keywords.

Definition at line 157 of file ZZ.py.

     def validate_decays(self):
         """! Validate idvecbos and vdecaymode keywords."""
         # See https://docs.google.com/spreadsheets/d/1Aa7FwB74ppHbXles5LyHrKGlvUFi5PxbZC-Mrc3Lz90 for meanings
         self.expose()  # convenience call to simplify syntax
         self.check_decay_mode(self.decay_mode, self.allowed_decay_modes)
         # Enable appropriate decay mode
         list(self.parameters_by_keyword("ZZeeee"))[0].value = 0  # disable the one used as a proxy for decay mode
         __decay_mode_lookup = {"z z > e+ e- e+ e-": "ZZeeee",
                                "z z > e+ e- tau+ tau-": "ZZeetautau",
                                "z z > j j j j": "ZZqqqq",
                                "z z > j j l+ l-": "ZZqqll",
                                "z z > l+ l- l'+ l'-": "ZZllll",
                                "z z > mu+ mu- e+ e-": "ZZmumuee",
                                "z z > mu+ mu- mu+ mu-": "ZZmumumumu",
                                "z z > tau+ tau- mu+ mu-": "ZZtautaumumu",
                                "z z > tau+ tau- tau+ tau-": "ZZtautautautau",
                                "z z > v v~ e+ e-": "ZZvvee",
                                "z z > v v~ j j": "ZZvvqq",
                                "z z > v v~ l+ l-": "ZZvvll",
                                "z z > v v~ mu+ mu-": "ZZvvmumu",
                                "z z > v v~ tau+ tau-": "ZZvvtautau",
                                "z z > v v~ v' v'~": "ZZvvvv"}
         list(self.parameters_by_keyword(__decay_mode_lookup[self.decay_mode]))[0].value = 1

◆ validate_integration_parameters()

def python.processes.powheg_base.PowhegBase.validate_integration_parameters ( self )

inherited

Validate integration keywords by forcing to integer values.

Definition at line 270 of file powheg_base.py.

     def validate_integration_parameters(self):
         """! Validate integration keywords by forcing to integer values."""
         self.expose()  # convenience call to simplify syntax
         for name in ("foldcsi", "foldphi", "foldy", "itmx1", "itmx2", "ncall1", "ncall2", "nEvents"):
             for parameter in self.parameters_by_name(name):
                 try:
                     parameter.value = int(parameter.value)
                 except TypeError:
                     logger.fatal("Failed to validate {} with value {}".format(name, parameter.value))
                     raise
  

◆ validate_parameters()

def python.processes.powheg_base.PowhegBase.validate_parameters ( self )

inherited

Validate any parameters which need it before preparing runcard.

Definition at line 265 of file powheg_base.py.

     def validate_parameters(self):
         """! Validate any parameters which need it before preparing runcard."""
         for function_name in self.validation_functions:
             getattr(self, function_name)()
  

Member Data Documentation

◆ algorithms

python.processes.powheg_base.PowhegBase.algorithms

inherited

List of additional algorithms to schedule.

Definition at line 171 of file powheg_base.py.

◆ allowed_decay_modes

python.processes.powheg.ZZ.ZZ.allowed_decay_modes

List of allowed decay modes.

Definition at line 30 of file ZZ.py.

◆ cores

python.processes.powheg_base.PowhegBase.cores

inherited

Number of cores to use.

Definition at line 168 of file powheg_base.py.

◆ error_output

python.processes.powheg_base.PowhegBase.error_output

inherited

Definition at line 200 of file powheg_base.py.

◆ executable

python.processes.powheg_base.PowhegBase.executable

inherited

Powheg executable that will be used.

Definition at line 152 of file powheg_base.py.

◆ externals

python.processes.powheg_base.PowhegBase.externals

inherited

List of external processes to schedule.

Definition at line 174 of file powheg_base.py.

◆ info_output

python.processes.powheg_base.PowhegBase.info_output

inherited

Definition at line 199 of file powheg_base.py.

◆ is_reweightable

python.processes.powheg_base.PowhegBase.is_reweightable

inherited

Switch to determine whether reweighting is allowed.

Definition at line 189 of file powheg_base.py.

◆ parameters

python.processes.configurable.Configurable.parameters

inherited

List of available parameters.

Definition at line 19 of file configurable.py.

◆ parameterStageDict

python.processes.powheg_base.PowhegBase.parameterStageDict

inherited

Dictionary used to change parameters of the Powheg input.

The structure is: {"parameter" : [default_value, changed_value, parallelstage_to_changed_value]}

Definition at line 204 of file powheg_base.py.

◆ powhegbox_revision

python.processes.powheg_base.PowhegBase.powhegbox_revision

inherited

Log the PowhegBox version and process-code revision for AMI etc.

Also set environment variable POWHEGVER to this contain this information SVN revision of PowhegBox code

Definition at line 165 of file powheg_base.py.

◆ process_revision

python.processes.powheg_base.PowhegBase.process_revision

inherited

SVN revision of process code.

Definition at line 155 of file powheg_base.py.

◆ remove_oldStyle_rwt_comments

python.processes.powheg_base.PowhegBase.remove_oldStyle_rwt_comments

inherited

Switch to determine if the #rwgt and #pdf comments should be kept in lhe files despite using xml reweighting.

Definition at line 195 of file powheg_base.py.

◆ use_XML_reweighting

python.processes.powheg_base.PowhegBase.use_XML_reweighting

inherited

Switch to determine whether XML reweighting should be used.

Definition at line 192 of file powheg_base.py.

◆ validation_functions

python.processes.powheg_base.PowhegBase.validation_functions

inherited

List of validation functions to run before preparing runcard.

Definition at line 177 of file powheg_base.py.

◆ warning_output

python.processes.powheg_base.PowhegBase.warning_output

inherited

Special treatment for some log messages.

Definition at line 198 of file powheg_base.py.

The documentation for this class was generated from the following file:

ZZ.py

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Member Function Documentation

◆ add_algorithm()

◆ add_keyword()

◆ check_decay_mode()

◆ check_using_integration_files()

◆ default_PDFs()

◆ default_scales()

◆ expose()

◆ files_for_cleanup()

◆ has_keyword()

◆ has_parameter()

◆ hoppet_info()

◆ hoppet_warning()

◆ integration_file_names()

◆ link_external_powheg_libraries()

◆ link_madloop_libraries()

◆ mandatory_integration_file_names()

◆ manually_set_openloops_gnu_paths()

◆ manually_set_openloops_paths()

◆ modify_parameter()

◆ openloops_error()

◆ parameters_by_keyword()

◆ parameters_by_name()

◆ powheg_version()

◆ prepare_to_parallelise()

◆ set_parameter_in_config()

◆ stage_is_completed()

◆ validate_decays()

◆ validate_integration_parameters()

◆ validate_parameters()

Member Data Documentation

◆ algorithms

◆ allowed_decay_modes

◆ cores

◆ error_output

◆ executable

◆ externals

◆ info_output

◆ is_reweightable

◆ parameters

◆ parameterStageDict

◆ powhegbox_revision

◆ process_revision

◆ remove_oldStyle_rwt_comments

◆ use_XML_reweighting

◆ validation_functions

◆ warning_output

◆ init()