ABF:Controls: Difference between revisions

From PMFLib Wiki
Jump to navigation Jump to search
(Created page with "Navigation: Documentation / Methods / Adaptive Biasing Force Method / ABF:Controls ---- __NOEDITSECTION__ __NOTOC__ The behaviour of the ABF method is controll...")
 
No edit summary
Line 2: Line 2:
----
----
__NOEDITSECTION__ __NOTOC__
__NOEDITSECTION__ __NOTOC__
The behaviour 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.
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]==
==[abf]==
Line 83: Line 83:




The optional section [abf-walker] provides information about the access to the ABF multiple walkers server. This MWA extension of ABF is described in details in [[ABF:Multiple walkers approach]].
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]==
==[abf-walker]==
Line 95: Line 95:
|  
|  
| [[Control key types|string]]
| [[Control key types|string]]
| The name of 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 abf-server utility, when the MWA server is started. This option is mutually exclusive with the fserver and fpassword options.
| 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.   
|- style="vertical-align: top;"
| fserver
|
| [[Control key types|string]]
| The access to the MWA server in the format: abf://server_name[:port]. The server_name is the DNS name of the server and the port is the number of port on which the server is listenning. This option is mutually exclusive with the fserverkey key, which has precedence. It means that both fserver and fpassword options are not processed if the fserverkey is provided.   
|- style="vertical-align: top; background-color: #f6f6f6;"
| fpassword
|
| [[Control key types|string]]
| The password to access the MWA server. This option is mutually exclusive with the fserverkey key, which has precedence. It means that both fserver and fpassword options are not processed if the fserverkey is provided. 
|- style="vertical-align: top;"
|- style="vertical-align: top;"
| fserverupdate
| fserverupdate
| 500
| 20000
| [[Control key types|integer]]
| [[Control key types|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 in the real time.  
| 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 in the real time.  

Revision as of 14:55, 21 July 2021

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 in the real time.
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.