ROTPRBIN

Sets the amount of storage and storage precision for binnings (single or double). Sets also the correspondence between rotations/translations and binnings.

     WHAT(1) : sets the run-time storage precision of binnings

          -1 < WHAT(1) =< 0 --> ignored
          =< -1.0 --> reset the storage precision to default (double)
          = xxz01 --> set the storage precision to single
          = xxz00 --> set the storage to only a fraction of the required memory,
                      that is only xx.z percent of the required memory for this
                      binning is actually allocated
               Default = double precision storage and full memory allocation

     WHAT(2) :  index (or name) of the rotation/translation matrix (defined by a
                ROT-DEFIni card) which is associated to the binning(s) indicated
                by WHAT(4) ... WHAT(6) (see Note 4).
          =<-1.0 --> resets the associated rotation/translation to identity
                     (transformation index = 0)

     WHAT(3) :  not used

     WHAT(4) = lower index bound of binnings in which the requested storage
               precision and/or transformation must be applied
               ("From binning WHAT(4)...")
               Default = 1.0

     WHAT(5) = upper index bound of binnings in which the requested storage
               precision and/or transformation must be applied
               ("...To  binning WHAT(5)..."
               Default = WHAT(4)

     WHAT(6) = step length in assigning indices ("...in steps of WHAT(6)").
               Default = 1.0

     SDUM :    not used

Notes:

1) Command ROTPRBIN can be used for two different tasks, both related to binnings requested by the user by means of EVENTBIN or USRBIN:

             a) to define the precision used at run-time to store the
                accumulated scores of selected binnings
             b) to set the correspondence between the index of a transformation
                (rotation/translation as defined by command ROT-DEFIni) and the
                index of selected binnings.

2) The USRBIN/EVENTBIN output values are always in single precision, regardless of the run-time storage precision used. Run-time storage precision, which is double by default, should never be changed for binnings defined by USRBIN to prevent severe loss of data (adding small amounts in the rounding can result in values no longer increasing with the number of primary particles). However, this is unlikely to happen with EVENTBIN binnings, which are reset at the end of each history.

3) In many cases, binnings defined by EVENTBIN result in a number of sparse "hit" cells, while all other bins are empty (scoring zero). In such cases, it is convenient to allocate less storage than required by the whole binning structure. In these circumstances, it may also be convenient to print to file only the content of non-empty cells (see Note 2 to option EVENTBIN).

4) Binning space transformations (rotations and translations) are those defined by a ROT-DEFIni card. That is, the variables used for scoring are the primed one (x',y',z') (see the Notes 3 and 4 to option ROT-DEFIni).

Example 1:

 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 ROTPRBIN      85500.       0.0       0.0       2.0       6.0       2.0
 *  Allocate only 85.5% of the required memory to binnings 2, 4 and 6

Example 2:

 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 ROTPRBIN      10001.       0.0       0.0       3.0       5.0       0.0
 *  Set single storage precision for binnings 3, 4 and 5

Example 3:

 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 ROTPRBIN              myMatrix             energyA   HEhadrA
 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 ROT-DEFIni       44.        0.        0.        0.        0.   -16000.myMatrix
 ROT-DEFIni      244.        0.       10.        0.        0.        0.myMatrix
 ROT-DEFIni       44.        0.        0.        0.    10000.    10000.myMatrix
 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 USRBIN           11.    ENERGY      -21.        1.        5.      50. energyA
 USRBIN           -1.       -1.       -5.       10.       10.      50.   &
 USRBIN           11.      DOSE      -21.        1.        5.      50. doseA
 USRBIN           -1.       -1.       -5.       10.       10.      50.   &
 USRBIN           11.  HADGT20M      -21.        1.        5.      50. HEhadrA
 USRBIN           -1.       -1.       -5.       10.       10.      50.   &
 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
 * Associate the "myMatrix" ROT-DEFIni to the "energyA", "doseA" and "HEhadrA"
 * USRBINS

Informativa cookies