ABF:Controls

From PMFLib Wiki
Revision as of 14:58, 21 July 2021 by Kulhanek (talk | contribs)
Jump to navigation Jump to search

Navigation: Documentation / Methods / Adaptive Biasing Force Method / ABF:Controls


The behavior of the ABF method is controlled by the setup provided in the [abf] and eventually [abf-walker] sections. Both sections belong to the {PMFLIB} group.

[abf]

Key Default value Type Description
fmode 0 integer The mode of the ABF method:
0 - the method is disabled
1 - the standard ABF implementation is used
2 - less accurate implemetation is used
If the method is enabled then at least one collective variable should be provided in the {ABF} group. The collective variable specification is described in ABF:Collective variables.
fmask off logical Disable/Enable ABF force weights (mask). The name of file with the ABF weights is provided in the [files] section. This option has only sense if more than one collective variable is requested and some region in such CV space should not be sampled.
feimode 1 integer The extrapolation/interpolation mode for ABF forces:
1 - simple linear ramp
2 - linear ramp with bottom limit
This option triggers further setup, which is optional and described in details below.
fsample 500 integer Every fsample MD steps, the actual information about collective variable values will be printed to the ABF output file. The name of the output file is provided in the [files] section.
frestart off logical Disable/Enable restarting the ABF simulation from the previous run. The name of the restart file is provided in the [files] section. If the restart is enabled but no restart file exists only warning is raised.
frstupdate 1000 integer Every frstupdate MD steps, the actual ABF force and other data will be printed to the ABF restart file. The name of the restart file is provided in the [files] section.
ftrjsample 0 integer Every ftrjsample MD steps, the actual ABF acumulator and other data will be printed to the ABF trajectory file. The name of the trajectory file is provided in the [files] section. Zero interval disables the ABF trajectory writing.

If the feimode option is equal to 1 then following option changes behaviour of the linear ramp.

Key Default value Type Description
fhramp 100 integer Top limit for number of samples in a bin. If the actual number of samples in a bin is higher than this number then estimated ABF force is aplied fully otherwise it is scaled down by the linear ramp.

The linear ramp has following form:

, where Nk is the number samples in bin k

If the feimode option is equal to 2 then following option changes behaviour of the linear ramp.

Key Default value Type Description
fhramp_min 200 integer Bottom limit for number of samples in a bin. If the actual number of samples in a bin is lower than this number no ABF force is aplied.
fhramp_max 500 integer Top limit for number of samples in a bin. If the actual number of samples in a bin is higher than this number then estimated ABF force is aplied fully otherwise it is scaled down by the linear ramp.

The linear ramp has following form:

, where Nk is the number samples in bin k


The optional section [abf-walker] provides information about access to the MWA server. The MWA extension is described in detail in ABF:Multiple walkers approach.

[abf-walker]

Key Default value Type Description
fserverkey string The name of a file with a server key. The server key contains information about the server name, the port number, and the server password. The file is generated by the mwa-server utility when the MWA server is started.
fserverupdate 20000 integer The number of MD steps between exchanges of data with the MWA server. Since data are exchanged in a connect/send/receive/disconnect mode, exchanges should not occur too often.
fabortonmwaerr 0 logical Should the walker (client) run abort when MWA server communication failure occurs?
fconrepeats 0 integer The number of consecutive failed exchanges with the server that will lead to premature client termination. The zero means that no failures are allowed and the client is terminated at the first failed exchange.