kstraj_control_energy

this control suggests a temporal step based on conservation of total energy over a step. if the fractional energy conservation violation is above the upper limit, the step is rejected and a smaller stepsize is suggested. if the fractional energy conservation violation is below the lower limit, the step is accepted and a larger stepsize is suggested.

XML element: <kstraj_control_energy>
C++ type: KSTrajControlEnergy
Also available as: control_energy
Attributes

Attribute

Type

Description

adjustment

double

adjustment_down

double

adjustment_up

double

initial_step

double

lower_limit

double

the energy conservation violation threshold below which larger temporal steps are suggested.

max_length

double

min_length

double

name

string

the name of this control.

step_rescale

double

upper_limit

double

the maximum tolerable energy conservation violation per step.

Example:

<kstraj_control_energy name="control_energy" upper_limit="1.e-8" lower_limit="1.e-12"/>

Used as: