USERWEIG

Summary

Defines the extra weighting applied to yields scored via the USRYIELD option, energy and star densities obtained via USRBIN, energy deposition and star production obtained via EVENTBIN, energy depostion via DETECT, production of residual nuclei obtained via RESNUCLEi, currents calculated by means of USRBDX, and fluences calculated by means of USRBDX, USRTRACK, USRCOLL and USRBIN. ​

WHAT(1)

and WHAT(2): not used

WHAT(3) > 0.0:

yields​ obtained via USRYIELD and fluences​ or currents​ calculated with USRBDX, USRTRACK, USRCOLL, USRBIN are multiplied by a user-supplied function FLUSCW at scoring time.​

1.0 ≤

WHAT(3) ≤ 2.0: FLUSCW is called before any check on the current detector (see Note 5)

> 2.0:

FLUSCW is called only after checking that the current detector applies (see Note 5)

= 2.0

or 4.0: The routine FLDSCP is also called, applying a shift to the current binned track​​

< 0.0:

resets the default: no weighting

= 0.0:

ignored

Default

= -1.0  (no weighting)

WHAT(4) > 0.0:

the DETSCW user routine is called every time a quantity is going to be scored inside a DETECT pulse-height estimator. The to be scored hit, as well as the possible (anti)coincidence hit, can then be modified according to an user provided resolution or other recipe (see the comments inside comscw.f and SCOHLP COMMON for further details)​

WHAT(5) > 0.0:

the USRRNC user subroutine is called every time a residual nucleus​ is generated​

WHAT(6) > 0.0:

energy​ and star densities​ obtained via SCORE and USRBIN, as well as energy deposition and star production obtained via EVENTBIN, energy deposition via DETECT, and other quantities (see the comments inside comscw.f and SCOHLP COMMON for further details) are multiplied by a user-supplied function COMSCW at scoring time.​

1.0 ≤

WHAT(6) ≤ 2.0: COMSCW is called before any check on the current detector (see Note 5)

> 2.0:

COMSCW is called only after checking that the current detector applies (see Note 5)​

= 2.0

or 4.0: The routine ENDSCP is also called, applying a shift to the current binned energy loss​

< 0.0:

resets the default: no weighting

= 0.0: ignored

Default

= -1.0  (no weighting)

SDUM

not used

Default

(option USERWEIG not given): no extra weighting is applied to any scored quantity

Notes

  1. These weights are really extra, i.e. the results are multiplied by these weights at scoring time, but printed titles, headings and normalisations are not necessarily valid. It is the user’s responsibility to interpret correctly the output. Actually, it is recommended to insert into standard output​ a user-written notice​ informing about the extra weighting

  2. Setting the incident particle weight to a value different from 1.0 (in the BEAM card) will not affect the results, since the latter are always normalised​ to unit primary weight.

  3. Note that USRBIN can be used to calculate star​ or energy​ density, and in this case function COMSCW has to be used. But when using USRBIN to calculate track-length fluences​, the function to be used is FLUSCW.

  4. Note that functions FLUSCW, and COMSCW can contain user-written logic to tune the multiplication factor (which can have even a value = 0.0 or 1.0 !) according to position in space, direction, energy, material, type of particle, time, binning number etc. This allows to score only under certain conditions​, or in any case to extend considerably the capability of the code. Similar possibilities exist for the offset provided by routines FLDSCP and ENDSCP.

  5. For some applications, a call to the user routines FLUSCW or COMSCW is desired independently of whether the current detector applies. But in general this is not the case and it is convenient to check first that a score actually is taking place, saving a large number of function calls. Different values of WHAT(3) and WHAT(6) allow the user to choose one of the two possibilities.

  6. User-written functions FLUSCW, COMSCW, DETSCW, FLDSCP, ENDSCP and USRRNC are described in User routines.

Examples:

*...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
USERWEIG          0.        0.        0.        0.        0.       1.
*  Dose and star densities will be multiplied by a value returned by
*  function COMSCW according to the logic written by the user.
*  No check on the detector is done before calling the function.

USERWEIG          0.        0.        4.        0.        0.       0.
*  Fluences and currents will be multiplied by a value returned by
*  function FLUSCW according to the logic written by the user.
*  The function will be called only for detectors to which the present
*  score applies.

USERWEIG          0.        0.        0.        0.        1.       0.
*  Residual nuclei scores will be accomplished by subroutine USRRNC according to
*  the logic written by the user.