CERN homepage INFN homepage
FLUKA: ROTPRBIN Previous Index Next

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....+...
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....+...
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....+...
ROTPRBIN myMatrix energyA HEhadrA
*...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
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....+...
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....+...
* Associate the "myMatrix" ROT-DEFIni to the "energyA", "doseA" and "HEhadrA"
* USRBINS
* Start_Devel_seq

Previous Index Next