ABF:Controls

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:

\bold F_{aplied} = \frac{N_k}{fhramp}\bold F_{estimated}

, where N_k 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:

\bold F_{aplied} = \frac{N_k - fhramp\_min}{fhramp\_max-fhramp\_min}\bold F_{estimated}

, where N_k 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	on	logical	Should the running of a walker (client) 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.