ensemble (overview)

This keyword selects the integration method for the next run.

Syntax

ensemble <method> <parameters>

Parameters

For conventional classical MD, the main choices are:

  • nve: dynamics without a thermostat or barostat.

  • nvt_*: temperature control at fixed cell.

  • npt_*: temperature and pressure control, allowing the cell to change.

  • nph_mttk: pressure control without a thermostat.

The available methods, including specialized integrators, are described on the following pages:

Units and suggested parameters

The units of temperature and pressure for this keyword are K and GPa, respectively. These are thermostat and barostat targets; they do not set the initial atomic velocities, which are determined by model.xyz or the velocity keyword. Use equal initial and final targets to keep the target constant during a run.

The coupling parameters below are used by the standard integrators and local heat baths where applicable. For methods with different parameter names or requirements, follow their individual pages.

The temperature coupling constant <T_coup> means \(\tau_T/\Delta t\), where \(\tau_T\) is the relaxation time of the thermostat and \(\Delta t\) is the time step for integration. We require \(\tau_T/\Delta t \geq 1\) and a good choice is \(\tau_T/\Delta t \approx 100\).

When \(\tau_T/\Delta t > 100000\), the Berendsen thermostat in npt_ber will be completely ignored, leaving only the Berendsen barostat. In this case, the NPT ensemble reduces to the NPH ensemble that can be useful for melting point calculations using the two-phase method. This thermostat-free mode is not available with stochastic cell rescaling.

The pressure coupling constant <p_coup> means \(\tau_p/\Delta t\), where \(\tau_p\) is the relaxation time of the barostat and \(\Delta t\) is the time step for integration. We require \(\tau_p/\Delta t \geq 1\) and a good choice is \(\tau_p/\Delta t \approx 1000\).

The elastic constants are in units of GPa.

Output

None.

Examples

ensemble nvt_bdp 300 300 100

Notes

Specify exactly one ensemble command before each run. The integrator is initialized for that run, and any temperature or pressure ramp is defined over that run.