TFUNC
This section specifies the target temperature by using the time step S and the temperature of the last step in Kelvin T in a functional form, thus allowing for a simple region-wise annealing (heating/cooling) controls in the absence of a thermostat. Specifically, if the absolute difference between target and actual temperature is larger than the TEMP_TOL value on each step, the atomic velocities will be rescaled to match the target temperature. However, note that a small restrictive TEMP_TOL together with a rapidly varying target temperature function and a large timestep leaves little time for the system to adjust itself, possibly leading to unphysical relaxation behaviors and structural artifacts.
When DEFINE_REGION%TEMPERATURE is not set for this region explicitly, the function will be evaluated at S set in MD%STEP_START_VAL and T = 0.00 to obtain the initial temperature (assumed positive) for initialization of the atomic velocities in the region; if the result of function evaluation is not positive, the MD%TEMPERATURE will be used as a fallback.
The function is interpreted directly as in Kelvin, with no need to specify the UNITS keyword for the parameters. For instance, defining FUNCTION (ABS(S/N+M)-ABS(S/N-M))/2, PARAMETERS N M and VALUES 50/3 300.0, the target temperature will rise linearly and reach 300.0 K at step S = 5000.
The following 2 symbol(s) will be reserved as the variable(s) to be substituted for internal evaluation: S, T. They cannot be used as parameters.
[Edit on GitHub]
Keywords
Keyword descriptions
FUNCTION
Type: string
Value must be double-quoted if followed by inline comments.
Usage: FUNCTION A*X+B*(2/(1+EXP(-0.001*Y))-1)
Description: Specifies a functional form. The maximum length is 1024 characters. Mathematical Operators recognized are +, -, *, /, ^ or alternatively **, whereas symbols for brackets must be (). The function parser recognizes the Fortran 90 intrinsic functions abs, min, max, exp, log10, log, sqrt, sinh, cosh, tanh, sin, cos, tan, asin, acos, atan2, atan, erf, erfc. Parsing for intrinsic functions is not case sensitive.
[Edit on GitHub]
PARAMETERS
Type: string[ ]
Repeatable: yes
Usage: PARAMETERS A B
Description: Defines the symbols for the parameter(s) in the functional form, delimited by whitespaces. Symbols are case sensitive and each is at most 80 characters long. [Edit on GitHub]
UNITS
Type: string[ ]
Repeatable: yes
Usage: UNITS eV*angstrom^-1 angstrom
Description: Optionally, defines CP2K unit string for each of the given parameter value(s). A valid CP2K unit string is one of the strings that is listed under the References/Units section of the CP2K manual, or a combination of multiple of these strings with *, / and ^. It is assumed that the corresponding parameter value is specified in this unit which needs to be converted first to the internal unit during input parsing. Note that the meaningfulness of the unit is not checked. If omitted, all values will be treated as already in the internal unit and used literally.
[Edit on GitHub]
VALUES
Type: real[ ]
Default: [internal_cp2k]
Repeatable: yes
Usage: VALUES 50 1.0E+2
Description: Defines the value(s) of the parameter in the functional form. [Edit on GitHub]