python.processes.external.external_madspin.ExternalMadSpin Class Reference

Class for running external MadSpin process. More...

Inheritance diagram for python.processes.external.external_madspin.ExternalMadSpin:

Collaboration diagram for python.processes.external.external_madspin.ExternalMadSpin:

Public Member Functions
def	__init__ (self, process)
	Constructor. More...
def	needs_scheduling (self, process)
	Report whether the MadSpin process should be scheduled. More...
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
	name
	Name of this external process. More...
	executable
	External executable that will be used. More...
	parameters
	List of available parameters. More...

Detailed Description

Class for running external MadSpin process.

Author

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

Definition at line 11 of file external_madspin.py.

Constructor & Destructor Documentation

__init__()

def python.processes.external.external_madspin.ExternalMadSpin.__init__	(		self,
			process
	)

Constructor.

Parameters

process

MadSpin process description string.

Definition at line 17 of file external_madspin.py.

    def __init__(self, process):
        """! Constructor.
 
        @param process  MadSpin process description string.
        """
        super(ExternalMadSpin, self).__init__("MadSpin", os.environ["MADPATH"], "MadSpin", "madspin")
 
        # Add parameters used by MadSpin
        self.add_keyword("alphaem_inv")
        self.add_keyword("alphaqcd")
        self.add_keyword("BR_t_to_Wb")
        self.add_keyword("BR_t_to_Wd")
        self.add_keyword("BR_t_to_Ws")
        self.add_keyword("BR_W_to_hadrons")
        self.add_keyword("BR_W_to_leptons")
        self.add_keyword("bwcutoff")
        self.add_keyword("ebeam1")
        self.add_keyword("G_F")
        self.add_keyword("MadSpin_decays")
        self.add_keyword("MadSpin_enabled")
        self.add_keyword("MadSpin_model")
        self.add_keyword("MadSpin_mode")
        self.add_keyword("MadSpin_nFlavours")
        self.add_keyword("MadSpin_process", process)
        self.add_keyword("MadSpin_taus_are_leptons")
        self.add_keyword("MadSpin_max_weight_ps_point")
        self.add_keyword("MadSpin_Nevents_for_max_weight")
        self.add_keyword("MadSpin_paramcard")
        self.add_keyword("mass_b")
        self.add_keyword("mass_H")
        self.add_keyword("mass_t")
        self.add_keyword("mass_tau")
        self.add_keyword("mass_W")
        self.add_keyword("mass_Z")
        self.add_keyword("powheg_top_decays_enabled")
        self.add_keyword("width_H")
        self.add_keyword("width_t")
        self.add_keyword("width_W")
        self.add_keyword("width_Z")
        self.add_keyword("Wolfenstein_lambda") # for madspin decays with ckm-changing models
        self.add_keyword("Wolfenstein_A") # for madspin decays with ckm-changing models
        self.add_keyword("Wolfenstein_rho") # for madspin decays with ckm-changing models
        self.add_keyword("Wolfenstein_eta") # for madspin decays with ckm-changing models
 

Member Function Documentation

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))
 

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)
 

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)
 

needs_scheduling()

def python.processes.external.external_madspin.ExternalMadSpin.needs_scheduling	(		self,
			process
	)

Report whether the MadSpin process should be scheduled.

Parameters

process

PowhegBox process.

Reimplemented from python.processes.external.external_base.ExternalBase.

Definition at line 61 of file external_madspin.py.

    def needs_scheduling(self, process):
        """! Report whether the MadSpin process should be scheduled.
 
        @param process PowhegBox process.
        """
        # Check that MadSpin is not disabled
        self.expose()
        if not self.MadSpin_enabled:
            logger.warning("MadSpin not enabled")
            return False
        # Check that tops have not already been decayed
        if self.powheg_top_decays_enabled:
            logger.info("Powheg top quark decays are enabled. MadSpin will not be used for decays.")
            return False
        # Check that decays are in correct format
        if not isinstance(self.MadSpin_decays, list):
            logger.warning("Could not interpret 'MadSpin_decays' argument as a list of allowed decays!")
            return False
        # Check that decay list has at least one entry otherwise add defaults
        if len(self.MadSpin_decays) == 0:
            logger.warning("No MadSpin decays specified, so defaults will be used.")
            for decay in ("t > w+ b, w+ > l+ vl", "t~ > w- b~, w- > l- vl~", "t > w+ b, w+ > j j", "t~ > w- b~, w- > j j"):
                logger.info("... adding MadSpin decay: 'decay {0}'".format(decay))
                list(self.parameters_by_name("MadSpin_decays"))[0].value.append("decay {0}".format(decay))
        return True

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]

Member Data Documentation

executable

python.processes.external.external_base.ExternalBase.executable

inherited

External executable that will be used.

Definition at line 32 of file external_base.py.

name

python.processes.external.external_base.ExternalBase.name

inherited

Name of this external process.

Definition at line 28 of file external_base.py.

parameters

python.processes.configurable.Configurable.parameters

inherited

List of available parameters.

Definition at line 19 of file configurable.py.

---

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

• external_madspin.py