Section ENFORCE_OCCUPATION

• Enforce and control a special (initial) orbital occupation. Note, this feature works only for the methods MULLIKEN and LOWDIN. It should only be used to prepare an initial configuration. An inadequate parameter choice can easily inhibit SCF convergence.

• Section path: CP2K_INPUT / FORCE_EVAL / SUBSYS / KIND / DFT_PLUS_U / ENFORCE_OCCUPATION

• This section cannot be repeated and can be optional.

• Subsections

  • none

• Keywords

  • SECTION_PARAMETERS
  • EPS_SCF
  • MAX_SCF
  • ORBITALS
  • SMEAR

• Keyword descriptions

  SECTION_PARAMETERS
  	&ENFORCE_OCCUPATION ON
  	Controls the activation of the ENFORCE_OCCUPATION section
  	This optional keyword cannot be repeated and it expects precisely one logical.
  	The lone keyword behaves as a switch to .TRUE.
  	Default value: .FALSE.

  EPS_SCF
  	EPS_SCF 0.001
  	The occupation constraint is enforced until this threshold value for the SCF convergence criterion is reached
  	This optional keyword cannot be repeated and it expects precisely one real.
  	Default value: 1.00000000E+30

  MAX_SCF
  	MAX_SCF 5
  	The occupation constraint is applied for this number of initial SCF iterations
  	This optional keyword cannot be repeated and it expects precisely one integer.
  	Default value: -1

  ORBITALS
  	ORBITALS 0 +1 -1
  	Select orbitals and occupation order. An input of 1 to 2*L+1 integer values in the range -L to L defining the M values of the spherical orbitals is expected.
  	This required keyword cannot be repeated and it expects a list of integers.
  	Default value: 0
  	Alias names for this keyword: M

  SMEAR
  	SMEAR ON
  	The occupation constraint is applied with smearing
  	This optional keyword cannot be repeated and it expects precisely one logical.
  	The lone keyword behaves as a switch to .TRUE.
  	Default value: .FALSE.