The RETIS section

The RETIS section specifies settings for RE(PP)TIS simulations. Note that the section for TIS also needs to be defined for a RE(PP)TIS simulation.

Example RETIS section:
RETIS settings
--------------
swapfreq = 0.5
relative_shoots = None
nullmoves = True
swapsimul = True
rgen = None
seed = None

Keywords for the RETIS section

The following keywords can be set for the RETIS section:

Table 29 Keywords for the RETIS section.
Keyword Description
nullmoves Determines if we do null moves or not.
relative_shoots Selects and defines relative shooting.
priority_shooting Prioritize the ensembles with less cycles.
rgen Determines the rgen to use in retis function.
seed Determines the seed for rgen in the retis function.
swapfreq Defines how often we perform swapping moves.
swapsimul Determines if we swap multiple path ensebles at the same time or not.

Keyword nullmoves

nullmoves = boolean

If True we perform null moves in the ensembles not included in a swapping move. Otherwise, no move is done in these ensembles.

Default
No default, this setting must be specified.

Keyword relative_shoots

relative_shoots = None or list of floats

This keyword selects and defines relative shooting. Relative shooting means that we perform TIS moves in the ensembles with unequal frequencies. This is selected by specifying the relative frequency for each ensemble in a list, e.g. relative_shoots = [0.1, 0.1, 0.2, 0.6] for four ensembles, where these numbers give the relative probability of choosing an ensemble. TIS moves are then carried out in the selected ensemble and a null move or no move is carried out in the other ensembles depending on the keyword setting for nullmove.

If relative_shoots = None we are not performing relative shooting and TIS moves are performed in all path ensembles.

Default
No default, this setting must be specified.

Keyword priority_shooting

Priority_shooting = boolean

This keyword automatically and dynamically internally select the relative shooting such that ensembles with a lower cycle number, will be prioritized until they reach a cyclen number equal to the others. This setting simplify the use of PyRETIS in cluster environments in which walltime is rather short. Each ensemble can be, therefore, investigated also if launching several runs.

Default
The default value is priority_shooting = False.

Keyword rgen

rgen = string

Select the function to use to generate the random number used in the retis function. That is, (1) the selection of the swap move vs shooting or time reversal, (2) detail balance for swap when Stone Skipping or Wire Fencing with high acceptance is used.

Default
The default value is rgen = None.

Keyword seed

seed = integer

Select the seed for the random number generator to be used in the retis function.

Default
The default value is seed = None.

Keyword swapfreq

swapfreq = float

This defines how often we perform swapping moves. This gives the percentage of swapping moves in the simulation, e.g.: swapfreq = 0.5 corresponds to 50% swapping moves, the 50% other moves will be TIS moves.

Default
No default, this setting must be specified.

Keyword swapsimul

swapsimul = boolean

If True several swaps are performed at the same time, that is we attempt to swap several pairs of path ensembles. If this is False, we will only attempt to swap one pair.

Default
No default, this setting must be specified.