gibuu is hosted by Hepforge, IPPP Durham
GiBUU

TABLE OF CONTENTS

/offShellPotential [ Modules ]

[ Top ] [ Modules ]

NAME

module offShellPotential

PURPOSE

This module calculates the offshell potential.

offShellPotential/OffShell_debug [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

Switch on or off whether the debug information shall be given.

SOURCE

  logical, parameter :: OffShell_debug=.false.

offShellPotential/useOffShellPotentialBaryons [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

Switch on or off whether the offshellness should be used for baryons.

SOURCE

  logical, save :: useOffShellPotentialBaryons=.false.

NOTES

offShellPotential/useOffShellPotentialMesons [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

Switch on or off whether the offshellness should be used for mesons.

SOURCE

  logical, save :: useOffShellPotentialMesons=.false.

offShellPotential/offshell_cutoff [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

If abs(offshellParameter) is less than this value, then we treat it as zero -> getoffshellMass returns the pole mass!

SOURCE

  real, parameter :: offshell_cutoff = 1E-5

offShellPotential/max_offshellparameter [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

The maximal value for the offshell parameter. Note: empirical value! This only applies to baryons. For mesons we have no restrictions on the offshell parameter.

SOURCE

  real, save :: max_offshellparameter=5.

offShellPotential/extrapolateBaryonWidth [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

Whether to extrapolate the baryon width below minimal mass or not.

SOURCE

  logical, save :: extrapolateBaryonWidth=.true.

offShellPotential/relativistic [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

  • false: Use non-rel. off-shell parameter x=Delta m/Gamma, which obeys Stefan Leupold's non-rel. EOM.
  • true: Use rel. off-shell parameter x=Delta m^2/Gamma, which obeys Cassing's rel. EOM.

SOURCE

  logical, save :: relativistic = .false.

offShellPotential/SetOffShellEnergyFlag [ Global module-variables ]

[ Top ] [ offShellPotential ] [ Global module-variables ]

PURPOSE

  • false: the energy of off-shell particle is constant during time evolution (static nucleus)
  • true: the energy of off-shell particle varies during time evolution (dynamic case, e.g. heavy ion collision)

SOURCE

  logical, save :: SetOffShellEnergyFlag = .false.

offShellPotential/setOffShellParameter [ Subroutines ]

[ Top ] [ offShellPotential ] [ Subroutines ]

NAME

Interface setOffShellParameter

PURPOSE

This is an interface which can be called like a subroutine using "call setOffShellParameter(p,success)".

It calculates the offshell parameter for a single particle or a set of particles. If it fails for one of them, then it returns .false., otherwise .true. . The particles should be properly initialized, only the offshellparameter should be left-over to initialize.

INPUTS

  • type(particle), intent(inout), dimension (:) :: p

or:

OUTPUT

  • logical :: success -- .true. if the offshell parameter could be evaluated for all particles

offShellPotential/readInput [ Subroutines ]

[ Top ] [ offShellPotential ] [ Subroutines ]

NAME

subroutine readInput

PURPOSE

Reads input in jobcard out of namelist "OffShellPotential".

offShellPotential/OffShellPotential [ Namelists ]

[ Top ] [ offShellPotential ] [ Namelists ]

NAME

NAMELIST /OffShellPotential/

PURPOSE

Includes the switches:

offShellPotential/get_useOffShellPotentialBaryons() [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

logical function get_useOffShellPotentialBaryons()

PURPOSE

returns the value of useOffShellPotentialBaryons

offShellPotential/get_useOffShellPotentialMesons() [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

logical function get_useOffShellPotentialMesons()

PURPOSE

returns the value of useOffShellPotentialMesons

offShellPotential/get_OffShell_debug() [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

logical function get_OffShell_debug()

PURPOSE

returns the value of OffShell_debug (which is a parameter)

offShellPotential/treatParticleOffShell(partID, partOffShellParameter) [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

logical function treatParticleOffShell(partID,partOffShellParameter)

PURPOSE

returns for a given particle, whether it is treated as offShell particle (e.g. in propagation).

offShellPotential/HamiltonFunc_offshell [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

real function HamiltonFunc_offshell(part,outOfBounds,massIsDetermined,full_offShell,flagOk)

PURPOSE

determines Hamilton function for the offshell potential prescription

INPUTS

  • type(particle) :: part -- the particle
  • logical, OPTIONAL :: massIsDetermined -- ???
  • logical, OPTIONAL :: full_offShell -- ???

OUTPUT

  • function value
  • logical :: outOfBounds -- .true. if the width table is out of bounds
  • logical, OPTIONAL :: flagOk -- .true. if success

NOTES

in the case of an internal failure (e.g. 'negative mass in massDet'), the return value is 99999.

offShellPotential/getOffShellParameter [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

real function getOffShellParameter(partID,bareMass,momentum,position, success)

PURPOSE

This function calculates the offshell parameter to be set into particle%offshellPar. When calling this routine, make sure, that momentum(0) is set correctly!

INPUTS

  • integer :: partID -- ID of particle
  • real :: bareMass -- bare mass= %mass
  • real, dimension(0:3) :: momentum -- 4-momentum at production point
  • real, dimension(1:3) :: position -- production point

OUTPUT

  • function value
  • logical :: success -- .true. if offshell parameter could be evaluated

offShellPotential/getOffShellMass [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

real function getOffShellMass(partID,offshellparameter,momentum,baremass, mediumAtPosition,outOfBounds,success)

FUNCTION

This function calculates the offshellmass of a particle depending on its offshellparameter and the current kinematics -> full four-momentum needed!!!

INPUTS

  • integer :: partID -- ID of particle
  • real :: offshellparameter --
  • real :: bareMass -- bare mass= %mass
  • real, dimension(0:3) :: momentum -- 4-momentum
  • type(medium) :: mediumAtPosition -- medium information

OUTPUT

  • real :: getOffShellMass
  • logical :: outOfBounds -- true if mass is not in grid
  • logical, OPTIONAL :: success -- indicates failure

offShellPotential/SetOffShellEnergy [ Subroutines ]

[ Top ] [ offShellPotential ] [ Subroutines ]

NAME

subroutine SetOffShellEnergy(part,errCode)

PURPOSE

Calculate the offshell energy and offshell mass of a particle depending on its offshellparameter and three-momentum.

INPUT * type(particle) :: part

OUTPUT

  • type(particle) :: part -- with redefined part%mom(0) and part%mass
  • integer, OPTIONAL :: errCode -- 0 if okay, otherwise = 1,...5

offShellPotential/getBaryonWidth [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

real function getBaryonWidth(partID,bareMass,momentum,mediumAtPosition, outofBounds)

PURPOSE

returns the baryonWidth. In case, extrapolateBaryonWidth is set to .true. the baryon width is extrapolated to masses below minimalmass.

IMPORTANT: *** Baryon Width is calculated in the Lab Frame! ***

INPUTS

  • integer :: partID -- ID of particle
  • real :: bareMass -- bare mass= %mass
  • real, dimension(0:3) :: momentum -- 4-momentum
  • type(medium) :: mediumAtPosition -- medium information

OUTPUT

  • function value

offShellPotential/getMesonWidth [ Functions ]

[ Top ] [ offShellPotential ] [ Functions ]

NAME

real function getMesonWidth

PURPOSE

Returns the meson width in the meson rest frame.

INPUTS

  • integer :: partID -- ID of particle
  • real :: bareMass -- bare mass= %mass
  • real, dimension(0:3) :: momentum -- 4-momentum
  • type(medium) :: mediumAtPosition -- medium information

OUTPUT

  • function value

offShellPotential/offShellErrorMessage [ Subroutines ]

[ Top ] [ offShellPotential ] [ Subroutines ]

NAME

subroutine offShellErrorMessage(partID,bareMass,momentum,position)

PURPOSE

Routine prints particle information.

INPUTS