jobproperties – Properties of the simulation job

class penelopetools.api.input.penepma2011.jobproperties.Simulation(showers=2000000000.0, randomnumberseeds=None, time=100, uncertaintylimit=None)

Bases: penelopetools.api.input.penelope.jobproperties.Simulation

Parameters of the simulation job.

Parameters:

• showers – number of showers to simulate
• randomnumberseeds (RandomNumberSeeds) – seeds for the random number generator
• time – time of the simulation (s)
• uncertaintylimit (UncertaintyLimit) – uncertainty limit

classmethod from_inputfile(lines)

Creates a Simulation from lines of a IN file.

Parameters:lines – lines

classmethod from_xml(root)

Creates a Simulation from a XML element.

Parameters:element – XML element

get_parameters(prefix)

to_html(header_level=1)

Returns a HTML representation of this option.

to_inputfile()

Returns the lines of this option to create a IN file.

to_xml()

Returns a XML representation of this option.

uncertaintylimit

Parameters of the error limit stopping mechanism. The attribute is a UncertaintyLimit. If the attribute is deleted, an uncertainty limit is returned. The latter has uncertainty limits of 0%, i.e. no effect on the simulation.

class penelopetools.api.input.penepma2011.jobproperties.UncertaintyLimit(transition=None, detector=-1, characteristic=0.0, fluorescence=0.0)

Bases: penelopetools.api.input.penelope.option.Option

Stopping mechanism for a simulation based on the error on a photon line. If the error at a given energy of a photon detector is below the specified error, the simulation is stop. The error can either be the error on the characteristic probability density or the error on the fluorescence contribution to the probability density.

Parameters:

• transition – photon transition
• characteristic – uncertainty limit on the characteristic probability density (%)
• fluorescence – uncertainty limit on the fluorescence contribution to the probability density (%)
• detector –

  photon detector for which the error should be below the limit

  • = -1: the simulation stops when x-ray line error is below the limit of one detector
  • = 0: the simulation stops when x-ray line error is below the limit for all detectors
  • > 0: the simulation stops when x-ray line error is below the limit of detector XLIMPD.

ATTR_CHARACTERISTIC = 'characteristic'

ATTR_DETECTOR = 'detector'

ATTR_FLUORESCENCE = 'fluorescence'

KEYWORD_XLIM = <penelopetools.api.input.penelope.util.Keyword object at 0x689bf50>

TAG_NAME = 'uncertaintyLimit'

characteristic

Uncertainty limit on the characteristic probability density. The limit is given in percent between 0 and 1. The value is stored in a magnitude.Magnitude.

detector

Photon detector for which the error should be below the limit.

• = -1: the simulation stops when x-ray line error is below the limit of one detector
• = 0: the simulation stops when x-ray line error is below the limit for all detectors
• > 0: the simulation stops when x-ray line error is below the limit of detector XLIMPD.

fluorescence

Uncertainty limit on the fluorescence contribution to probability density. The limit is given in percent between 0 and 1. The value is stored in a magnitude.Magnitude.

classmethod from_inputfile(lines)

Creates a ErrorLimit from lines of a IN file.

Parameters:lines – lines

classmethod from_xml(root)

Creates a UncertaintyLimit from a XML element.

Parameters:element – XML element

get_parameters(prefix)

to_html(header_level=1)

Returns a HTML representation of this option.

to_inputfile()

Returns the lines of this option to create a IN file.

to_xml()

Returns a XML representation of this option.

transition

Photon transition.